Reveal集成指南

注意：最新版的集成指南总是随着Reveal应用一起发布的。详细内容请见Help/Integration Guide。

为了让Reveal能够在运行时，检视及调试您的iOS应用，首先您需将Reveal库文件连接入您的应用当中。而所需的Reveal库文件已经内置在Reveal的应用程序当中。

Reveal提供了以下三种方式来集成库文件与您的iOS应用：

将Reveal的静态库文件连接入应用，是最简单快捷地启用Reveal检视的方式。

动态加载允许iOS应用在运行时，可以按需地加载第三方库。采用这种方式，库文件无需连接入应用的可执行文件，而是被加入到了应用Bundle中去，从而在运行时能按需加载。这种方式使得开发者可以在个人应用中，完全自由地控制Reveal库的加载，以及其服务的启动与停止。

CocoaPods是一款针对iOS与OSX项目的依赖管理系统。它大大简化了以往Xcode工程里，对第三方库的依赖管理与配置工作。

无论您之前采用的是哪种方式来集成Reveal，从Reveal 1.0.x升级到1.5.x都将是一个简单的过程。

在过去已有的库文件依赖的基础上，Reveal 1.5.x 新增了对libz.dylib的连接依赖。

如果在之前的版本中，您已经将静态框架文件或动态库文件拷贝到工程中。那么在升级后，请确保拷贝最新版本的库文件，以替换之前旧版本的库文件。(库文件的位置请参照，Help → Show Reveal Library in Finder)

在Xcode的Project Navigator面板中，选中您的工程，对于每一个集成过Reveal的target，您都需要进行以下操作：

如果之前已经在Link Binary with Libraries中加入过Reveal所需的库文件，现在请将libz.dylib也加入列表（已经加过的，无需重复加入）。

如果您之前是通过build setting中的**Other Linker Flags**配置项(或OTHER_LDFLAGS)，来连接Reveal所需库文件，现在请在配置项的flag列表中加入-lz。

搞定 - 运行您的应用，连上Reveal 1.5！

先确认您的*Podfile*看起来大概像这样子:

pod 'Reveal-iOS-SDK', :configurations => ['Debug']

在工程目录下执行pod update命令。

搞定 - 运行应用，连上Reveal 1.5！

不要将连接了Reveal库文件的应用正式发布。 Reveal的检视机制，会将您应用的许多内部信息暴露出来，而这将很可能导致您的应用被Apple审查团队拒绝发布。Reveal的目的仅用于内部开发与应用调试。

当iOS宿主应用进入后台后，Reveal服务将会自动停止。当应用重新打开时，它又会自动启动。

Reveal支持基于iOS 6及更新版本而编译的应用。构建配置中的*iOS Deployment Target*也必须是'iOS 6.0'或更新版本。如果iOS版本太旧，您有可能会在构建应用过程中遇到连接错误。

Reveal使用Bonjour协议来连接运行时的iOS应用。如果您的iOS应用是运行在真实的设备之上，那么此设备也需要处在同一个网络之内，以便电脑上的Reveal应用能够与之连接。如果您在连接应用时仍遇到问题，请先检查防火墙和代理设置，以确保它们没有阻碍通讯。