Reveal集成指南
为了让Reveal能够在运行时,检视及调试您的iOS应用,首先您需将Reveal库文件连接入您的应用当中。而所需的Reveal库文件已经内置在Reveal的应用程序当中。
Reveal提供了以下三种方式来集成库文件与您的iOS应用:
静态连接
将Reveal的静态库文件连接入应用,是最简单快捷地启用Reveal检视的方式。
→ 使用静态连接的方式集成Reveal。
动态加载
动态加载允许iOS应用在运行时,可以按需地加载第三方库。采用这种方式,库文件无需连接入应用的可执行文件,而是被加入到了应用Bundle中去,从而在运行时能按需加载。这种方式使得开发者可以在个人应用中,完全自由地控制Reveal库的加载,以及其服务的启动与停止。
→ 使用动态加载的方式集成Reveal。
CocoaPods
CocoaPods 是一款针对iOS与OSX项目的依赖管理系统。它大大简化了以往Xcode工程里,对第三方库的依赖管理与配置工作。
→ 使用CocoaPods来集成Reveal。
从Reveal 1.0升级
无论您之前采用的是哪种方式来集成Reveal,从Reveal 1.0.x升级到1.6.x都将是一个简单的过程。
在过去已有的库文件依赖的基础上,Reveal 1.6.x 新增了对 libz
的连接依赖。
- 如果在之前的版本中,您已经将静态框架文件或动态库文件拷贝到工程中。那么在升级后,请确保拷贝最新版本的库文件,以替换之前旧版本的库文件。(库文件的位置请参照, Help → Show Reveal Library in Finder)
- 在Xcode的Project Navigator面板中,选中您的工程,对于每一个集成过Reveal的target,您都需要进行以下操作:
- 如果之前已经在 Link Binary with Libraries 中加入过Reveal所需的库文件,现在请将
libz.tbd
也加入列表(已经加过的,无需重复加入)。
- 如果您之前是通过build setting中的Other Linker Flags配置项(或
OTHER_LDFLAGS
),来连接Reveal所需库文件,现在请在配置项的flag列表中加入-lz
。
- 搞定 - 运行您的应用,连上Reveal!
CocoaPods集成方式的升级办法
先确认您的Podfile看起来大概像这样子:
pod 'Reveal-iOS-SDK', :configurations => ['Debug']
在工程目录下执行pod update
命令。
- 搞定 - 运行应用,连上Reveal!
从您的Xcode项目中移除Reveal
→ 根据说明将Reveal从您的Xcode项目中移除。
重要提示
- 不要将连接了Reveal库文件的应用正式发布。 Reveal的检视机制,会将您应用的许多内部信息暴露出来,而这将很可能导致您的应用被Apple审查团队拒绝发布。Reveal的目的仅用于内部开发与应用调试。
- 当iOS宿主应用进入后台后,Reveal服务将会自动停止。 当应用重新打开时,它又会自动启动。
- Reveal支持基于iOS 7及更新版本而编译的应用。 构建配置中的iOS Deployment Target也必须是'iOS 7.0'或更新版本。 如果iOS版本太旧,您有可能会在构建应用过程中遇到连接错误。
- Reveal使用Bonjour协议来连接运行时的iOS应用。 如果您的iOS应用是运行在真实的设备之上,那么此设备也需要处在同一个网络之内,以便电脑上的Reveal应用能够与之连接。如果您在连接应用时仍遇到问题,请先检查防火墙和代理设置,以确保它们没有阻碍通讯。
获取帮助
如果您遇到任何Reveal集成的相关问题,请移步至我们的支持站点來寻求帮助。