开源工具 XFAssistiveTouch

Github 地址：https://github.com/xiaofei86/XFAssistiveTouch
Weibo 地址：http://weibo.com/1750985774/DyST3Czzc

XFAssistiveTouch 是仿照 iOS 系统的辅助按钮 AssistiveTouch 制作的辅助按钮。你可以用在调试等场景中使用。

Getting Started

• 阅读本篇博客或 README 文档 了解 XFAssistiveTouch
• 下载 XFAssistiveTouch 运行 Examples 文件夹中的示例查看效果
• 参考 Installation 章节将 XFAssistiveTouch 集成在你的项目中
• 参考 Usage 章节或示例代码在你的项目中使用 XFAssistiveTouch

Communication

• 如果你需要使用上的帮助，请联系我 [email protected] 。
• 如果你有使用上通用的问题，请新建 Issue。
• 如果你发现 BUG，请新建 Issue。
• 如果你对 XFAssistiveTouch 有新的需求，请新建 Issue。
• 如果你想帮助改善 XFAssistiveTouch，请提交 Pull Request。

Installation

XFAssistiveTouch 支持两种方式来安装

使用 cocoapods 安装

pod 'XFAssistiveTouch', '~>0.0.1'

通过 clone/download 安装

1. 将 XFAssistiveTouch clone 或 download 到本地
2. 将 XFAssistiveTouch 文件夹中的所有文件复制到你的项目中

Usage

显示 XFAssistiveTouch

• 导入头文件

#import "XFAssistiveTouch.h"

• 初始化 XFAssistiveTouch

XFAssistiveTouch *assistiveTouch = [XFAssistiveTouch sharedInstance];
assistiveTouch.delegate = self;
[assistiveTouch showAssistiveTouch];

• 实现 XFXFAssistiveTouchDelegate 来初始化 XFXFAssistiveTouch 的首页

@protocol XFXFAssistiveTouchDelegate 

- (NSInteger)numberOfItemsInViewController:(XFATViewController *)viewController;
- (XFATItemView *)viewController:(XFATViewController *)viewController itemViewAtPosition:(XFATPosition *)position;
- (void)viewController:(XFATViewController *)viewController didSelectedAtPosition:(XFATPosition *)position;

@end

操作 XFXFAssistiveTouch

在实现 XFXFAssistiveTouchDelegate 时，你可以给首页的 XFATItemView 添加手势以便在点击的时候对 XFXFAssistiveTouch 或你项目的 UIViewController 进行交互。

XFXFAssistiveTouch 可进行的交互

• 展开 XFXFAssistiveTouch

- (void)spread;

• 收起 XFXFAssistiveTouch

- (void)shrink;

• 在 XFXFAssistiveTouch 展示下级 XFATViewController

- (void)pushViewController:(XFATViewController *)viewController atPisition:(XFATPosition *)position;

• 回到 XFXFAssistiveTouch 上级页面

- (void)popViewController;

XFXFAssistiveTouch 可与项目进行的交互

• 在 targetViewcontroller 中 push 或 present 提供的 viewController。

- (void)pushViewController:(UIViewController *)viewController atViewController:(UIViewController *)targetViewController;

• 自动找到项目中最上层的 ViewController push 或 present 提供的 viewController。

- (void)pushViewController:(UIViewController *)viewController;

Architecture

交互

文件

类	说明
XFATLayoutAttributes	提供方法返回某些固定的坐标和大小，用来适配 iPhone 和 iPad。
XFATPosition	对位置信息进行封装以隐藏计算细节，项目中传递位置信息的容器。
XFATItemView	项目中的基本视图，每个页面由最多 8 个组成。
XFATViewController	页面控制器，控制最多 8 个 XFATItemView
XFATNavigationController	控制多个 XFATViewController 的切换、返回、展开、收起、移动、隐藏等行为及动画。
XFATRootViewController	继承自 XFATViewController，XFAssistiveTouch 的首页。
XFAssistiveTouch	用顶层 UIWindow 展示 XFATNavigationController。用户只需直接与此类进行交互。