最近更新了 Reveal 2, 发现以前 Reveal 1 的断点方式无法使用, 然后我就发现官网提供了三种使用方式, 但是因为是英文的, 所以我还是整理一下.
通过 CocoaPods 导入
很简单的方式, 只需要在你的 Podfile 文件添加 pod 'Reveal-SDK', :configurations => ['Debug'], 然后在终端执行 pod update 或 pod install.
运行 APP, 就可以在 Reveal 中查看你的 APP 界面布局了, 并且只有在 debug 模式下才能查看, 如果是 release 模式则不能.
通过这种方式集成的 Reveal, 可以查看模拟器和真机上 APP 界面布局.
使用断点的方式导入
-
安装 Reveal 的 Debugger Commands
安装前
安装前.png
安装后
安装后.png 创建Symbolic Breakpoin, 找到添加断点的地方, 如图
点击红框所示的 "+" 按钮, 选择Symbolic Breakpoin
- 编辑断点
断点创建以后, 我们右击编辑断点, 在 Symbol 处填写UIApplicationMain, 点击Add Action按钮添加一个 Action, 输入reveal load, 并且勾选Automatically continue after evaluating actions
- 完成后, 再次右击断点, 选择
Move Breakpoint To, 再选择User
在模拟器上运行 APP, 即可在 Reveal 中查看 APP 的界面布局
如果你想要在 Reveal 中查看运行在真机上的 APP 界面布局, 那么你需要添加一个运行脚本, 即
Run Script
先选中项目, 然后选中 Target, 再选中 BuildPhases, 创建一个新的Run Script, 如图
将这个新的Run Script重新命名为 Integration Reveal, 再将如下代码复制到下图中红框2的位置
REVEAL_APP_PATH=$(mdfind kMDItemCFBundleIdentifier="com.ittybittyapps.Reveal2" | head -n 1)
BUILD_SCRIPT_PATH="${REVEAL_APP_PATH}/Contents/SharedSupport/Scripts/reveal_server_build_phase.sh"
if [ "${REVEAL_APP_PATH}" -a -e "${BUILD_SCRIPT_PATH}" ]; then
"${BUILD_SCRIPT_PATH}"
else
echo "Reveal Server not loaded: Cannot find a compatible Reveal app."
fi
在真机上运行你的 APP, 就可以在 Reveal 中查看了.
注意1: 必须在 debug 模式
注意2: 必须是非越狱手机, 反正我的越狱机是无法弄, 一但用断点的方式使用 Reveal, APP 压根儿跑不起来, 非越狱手机实测没问题
手动导入
- 首先, 你需要将 Reveal 的 framework 导出
将这个 framework 复制一份出来, 然后将复制出来的导入到你的项目中.
注意, 此时千万不要把原文件直接拖入你的项目中, 防止出现手误把这个 framework 删除了或改变-
打开项目的
Build Settings, 找到Framework Search Paths, 在 Debug 里添加 framework 搜索路径
Paste_Image.png
注意: 搜索路径应该根据你自己的实际情况来填写. "$(PROJECT_DIR)"代表的是项目根目录.
还有就是, Release 那一行, 不要填写 RevealServer.framework 的搜索路径, 如果 Release 那一行被Xcode自动填写了, 那么删除它, 原因嘛, 是因为官方希望你在 Debug 的时候使用 Reveal, 当你 Release 时, 不要使用. -
还是在
Build Settings这里, 找到Other Linker Flags, 添加-ObjC -weak_framework RevealServer, 如果已经有-ObjC, 那就不用再写-ObjC了. 当然了, 依然只是在 Debug 那一行添加.
Paste_Image.png 继续在
Build Settings里找到Runpath Search Paths, 添加$(inherited) @executable_path/Frameworks.
PS: 这个地方是 Reveal 官方指引上写的, 但是吧, 我实际测试发现好像 Xcode 会自动填写, 所以这一步可以跳过
- 在
Build Phases中创建Run Script, 命名为Integration Reveal, 添加如下脚本代码
export REVEAL_SERVER_FILENAME="RevealServer.framework"
# Update this path to point to the location of RevealServer.framework in your project.
export REVEAL_SERVER_PATH="${SRCROOT}/${REVEAL_SERVER_FILENAME}"
# If configuration is not Debug, skip this script.
[ "${CONFIGURATION}" != "Debug" ] && exit 0
# If RevealServer.framework exists at the specified path, run code signing script.
if [ -d "${REVEAL_SERVER_PATH}" ]; then
"${REVEAL_SERVER_PATH}/Scripts/copy_and_codesign_revealserver.sh"
else
echo "Reveal Server not loaded: RevealServer.framework could not be found."
fi
注意: 脚本中 REVEAL_SERVER_PATH 这个路径, 应该根据你的 RevealServer.framework 实际的路径填写, 比如我的 RevealServer.framework 是放在了 720DEMO 这个文件夹下, 那么我就应该写成 REVEAL_SERVER_PATH="${SRCROOT}/720DEMO/${REVEAL_SERVER_FILENAME}", 这个路径一定要跟你的 RevealServer.framework 一致, 否则是无法使用 Reveal 的
- 运行 APP 就可以用 Reveal 查看界面布局了, 真机模拟器都行.
在APP Extensions 上使用 Reveal
使用步骤和上面三个差不多, 区别在于项目中 Target 的选择, 在选择 Target 的时候我们需要选中我们的 APP Extensions 对应的 Target 而不是主程序对应的 Target.
对于CocoaPods来说, 你需要这么写
target '你的 APP Extension 对应的 Target 名字' do
pod 'Reveal-SDK', :configurations => ['Debug']
end
后记
好了, 就这么多吧, 上面的方式我都实际测试过, 没有问题. 恩, 除了APP Extension.
关于越狱机无法用断点的方式在真机上使用 Reveal, 我咨询了官方的技术人员, 不过并没有解决, 应该是越狱行为对手机做了某些操作导致 Symbolic Breakpoin 无法通过, 所以没办法, 等官方解决吧.
我最后使用了CocoaPods的方式来使用 Reveal, 我只想说, 真是简单粗暴啊! 确实很方便. 还有, 我不推荐用手动的方式导入, 太麻烦了有没有! 我个人推荐用断点方式来使用 Reveal, 不怎么麻烦也不会对项目造成侵入.
最后的最后, 如果你们有任何的问题, 请去找官方, 因为找我也没用, 哈哈哈哈哈哈哈.
参考
[Reveal官方使用指导](file:///Applications/Reveal.app/Contents/SharedSupport/Documentation/Reveal%20Integration%20Guide.html)
