- 原文链接 : view-debugging-in-xcode-6
- 原文作者 : Scott Berrevoets
- 译文出自 : 开发技术前线 www.devtf.cn
- 译者 : Mr.Simple
- 校对者: 这里校对者的github用户名
- 状态 : 校对中
我们在开发app的时候经常会遇到一些在代码中难以发现的view中的bug或者自动布局约束。
这时候,掌握view调试的技巧就显得很重要—但是在Xcode6出现之前,调试view从未如此简单。
我们现在可以直接在Xcode中直观地看到view的整个层级,而不是在console中打印frames或者试图在脑海里凭空描绘布局。
本教程会带大家一览各种选择,并自行决定选择适合自己的。那么,大家准备好写一些代码了吗?告诉大家一个好消息,其实不必写代码。相反,我们只需要观看开源库中的view层级来更好地了解它是怎么写出来的—我们甚至可以连代码都不用看。
在Xcode中调试view从未如此简单
##入门指南
本教程将使用到的开源库是由Jesse Squires编写的JSQMessagesViewController。大家应该觉得这个库的UI看起来很熟悉吧,因为Jesse特意把它设计得像Messages应用。
首先我们要跳转到GitHub project page页面,下载源码并解压到相应路径中。
注:这个库使用CocoaPods来管理其对其他库的依赖性。如果大家不熟悉CocoaPods的工作原理,我建议大家在进行下一步之前先点击此处CocoaPods tutorial了解一下。
下一步,找到终端中刚才解压的项目路径然后运行pod install
来安装所需的依赖。然后打开JSQMessages.xcworkspace
并在iPhone 5s simulator
上运行这个app。(大家也可以使用其他的simulator,但是本教程是基于4英寸显示屏的尺寸,所以选择同样的尺寸比较容易推进。)
注:实时View调试仅在iOS 8上运行app是有效。本工具即使在Xcode 6环境下,在iOS 7上仍无法使用。
点击Push via storyboard
,然后我们就来到了与乔布斯和库克的短信对话线程。(哈哈,看到这里大家心里可能有点发毛,甚至怀疑自己是不是在做梦。额,这不是他俩本人好吗!)以下就是大家看到的view。
Steve Wozniak也来凑热闹啦!
返回Xcode后点击调试条上的Debug View Hierarchy
按钮。或者,直接转到Debug\View Debugging\Capture View Hierarchy
。
此时Xcode正在阻断app并将主动权交给调试程序,正如我们按了调试条上的暂停键把app给暂停了。
另外,Xcode使用画布代替了代码编辑器,并在画布上绘制app主窗口的完整view层级,包括用来表明每个view的边界的细线部分(我们称之为线框)。
我们知道,当我们向view层级中添加一个subview时,我们其实是在向现有的view堆栈上添加一个层次。因为大部分的view不会重叠,当我们运行app时所有的view看起来只是一个大层次的一部分而已。此刻我们看到的屏幕与此非常相似,只不过多了几条线而已。
那这几条线有什么用呢?此刻我们看到的是一个从上往下看的view堆栈视觉图,想象一下,如果我们能想象出各层次在堆栈中的位置的话会怎么样呢?点击并拖拽画布,我们就可以与View层级的3D视觉效果模型进行互动,而不再是平面的2D效果。
我们可以从侧面、顶部、底部、从各个角度甚至从后部观察整个层级。
注:大家的画布呈现的效果和本教程的效果可能会有些差异。为了确保进度统一,请大家按住
cmd+6
跳转到调试导航器。
在边框底部我们可以看到左侧有两个按钮。如图所示,同时取消选定两个按钮。如果未取消选定,画布可能就会隐藏了某些view。
##探索View层级
用透视法观察这个3D模型的最自然和最通用的方法是从左侧来看,如下图所示(稍后我会在本教程讲到原因)。
如果你想查看这个app是如何构建的,这个图把view的层级用透视的感觉展现了出来。。但是,堆栈的“底部”(左侧)似乎存在许多空白的view。这是为什么呢?
点击最左侧的view(也就是最后面那个)后,我们可以看到Xcode会将其显示高亮来标示我们选择的地方。我们还可以看到Jump Bar(就在画布的上方)把UIWindow显示为最后一项--最后一项会反映当前选择的view及其类的类型。
由于这款app只用了一个窗口,我们大可以假设Jump Bar开始处的UIWindow
就是app的主窗口,换句话说,是AppDelegate
的Window
属性。
好了,这样我们就知道如何找到window了,但是我们似乎并不需要查看它。下一个view又该怎么弄呢?在画布上点击窗口右侧的view(也就是顶部)并重新观察Jump Bar。UILayoutContainerView
对吧?这特么连一个公共类都算不上!
那一步之后,view层级是这样的:
-
UINavigationTransitionView
:是指导航控制器过渡的container view -
UIViewControllerWrapperView
:是指含有view controller的view
属性的wrapper view -
UIView
:是指一个view controller的一个最高层view(与view controller的view
属性相同) -
JSQMessagesCollectionView
:是指该项目用来显示所有短信息的collection view
##F聚焦 View的Interest
在调试这一独特的view层级时,前四个view(从窗口处开始)只是视觉噪声,没有实际意义;它们的存在可能会干扰大家去了解这个view层级中的其他信息。如果大家能够拨开迷雾,过滤掉这些视觉噪声,那才是极好的...
大家还可以:观察画布右下角的双向滑块。默认情况下两个滑块分别分布在最左和最右。
将左边的滑块稍微向右移动一点点,我们可以看到代表app窗口的线框从画布上消失了。再向右移动一点,我们可以发现,UINavigationTransitionView
也消失了。
把左边的滑块尽量拖拽至隐藏JSQMessagesCollectionView
的所有父视图,那么画布应该如下图所示:
我们看右边的导航条就没有那么分散,但它其实是被展示在了collection view的顶部,我们难以看到底部发生了什么变化。还好,我们可以把它隐藏起来。
由于我们现在关注的是包含了许多组成导航条的小视图的屏幕区域,所以在这里我把导航条放大,以便大家看清楚我到底怎么操作。
使用画布下方靠中间部分的三个缩放控制按钮:
大家可能已经猜到了,+按钮代表放大,—按钮代表缩小,=代表将画面重置到正常尺寸。放大以后我们可以更清楚地观看导航条。
注:如果大家用的是触摸屏,收放手势则代表画面的缩放。如果由于放大倍数太高导致画面不能全屏显示完整,我们可以上下左右移动触摸屏以查看未显示的部分。我们还可以使用鼠标滚轮来操作。
放大之后的toolbar很容易看到细节部分,但是view之间会有些重叠,所以要区分哪个view是哪个并不容易。
要解决这个问题,我们需要使用画布左下角的间距滑块。滑块越往右滑,Xcode中不同view之间的间距越大。
在这一特例中,我们需要将滑块尽量往右移动,避免view与toolbar重叠。要想达到理想的效果,我们可能会需要在画布上单击并拖曳鼠标慢慢实现。
现在我们就完美地操作了3D模型,从而轻而易举地将导航条隐藏起来。
将右边滑动条的右滑块慢慢往左拖曳,直到UINavigationBar
处。记住,我们可以使用Jump Bar来选择最上层从而判定每个view的类。我们会看到先消失的是导航条目,然后是包含它们的按钮,接下来是几个私有view,最后是导航条。
看,导航条不见了吧!
注:如果我们把画布翻转以下让顶层处在左边,然后再观察这个3Dview层级,滑动条的左滑块移动右边堆栈底部的view。同样地,右滑块会移动左边的view。
把滑动条从左移到右,从而使view由右向左消失(反之亦然)是反直观的,这也是为什么我们在观看顶层在右侧的模型时觉得这是最自然的角度。
很遗憾,隐藏导航条(root view为_UIBackdropView
)的同时,view会导致屏幕底部的toolbar的item内容消失。我们调节缩放尺寸或者将画布往下移看看是什么情况。
由于toolbar item是屏幕的一个重要部分,所以我想大家有必要看看,所以我只隐藏了到_UIBackdropView
(不含)的这一部分的view。操作完成后导航条堆栈应该是下图的样子。
##更多View选项
不相关的view被隐藏之后,我们得重新看一遍屏幕。我们可以把模型拖曳到原位,但是有时候确实很难百分百回到原位。别急,我们还留了一招。
看到缩放按钮左边的那四个按钮了吗?左起第三个是ResetViewing Area
按钮。它的作用是撤销屏幕旋转并显示view层级的正面构造,就像simulator或真机上的一样。
此时画布看起来应如下图所示:
大家可能注意到了,我们在调试器里看到的东西并不完全是app实际运行是我们所看到的。
首先,每个单独的view仍然有线框;通过这些线框我们看到透明的或者无内容的view,但是如果我们不看细节的话,它们会变得非常模糊。
我们可以通过View Mode button
(Reset Viewing Area
按钮右边那个)将其关闭。当我们点击view Mode按钮时,我们可以决定要不要显示view的线框和/或其内容。
一个只有线框的view在定位时非常有用,view的外形并不那么重要。而当我们想调试view的外观时,view的内容就非常有用了。
为了减少在这种情况下线框引起的杂乱(尤其是导航条和工具条附近),我们要把view Mode切换到Contents
来去除所有的线框,只留下app的核心部分。
下一步,当前的view缺少了几样东西。运行app时,我们可以看到文本泡泡上方显示发送者姓名的标签或短信的时间戳,以及最后一个文本泡泡显示的金门大桥图像。但调试器却没有显示这些标签和图像!
要想解决这个问题,首先请大家看到画布中间那行按钮的第一个按钮。它是一个显示或隐藏省略view的触发器。这些省略的view都已经将它们的clipsToBounds
属性设置成了YES。
这恰恰就是那些标签里面所含的内容,大概是因为姓名或日期太长,不能延伸到标签范围以外吧。图像也是同样的原理,使用圆角半径剪裁来达到圆角的效果。点击触发器我们就会看到Xcode中显示了view。
注:大家可能会看到新的可视条目的线框。如果真有的话,可以使用我们之前用过的View Mode按钮将线框先打开后关闭,问题应该就解决了。
这下大家看到了吧:我们在Xcode里复刻了一个近乎完美的view层级。
也不难吧?
##查看View
既然重要的部分都搞定了,那我们来看看这些不同的view的布局吧。
大家已经知道,collection view可以把所有view集合起来。但是大家想想,如果我们能把各个起作用的元素作一个概观,那岂不是更棒?我要告诉大家的是,我们当然可以实现!
按住cmd + 6
转到调试导航器。由于这是一个普通的调试会话,所以调试导航器会提供关于当前会话的上下文信息。对于view调试来说,这意味着Xcode会为所有的窗口提供一个包含所有视图的树形View。树形view展开之后如下图:
注:我们可以看到调试导航器的底部有一些控制树形view显示何种条目的选项。Apple的文件材料显示,左侧的按钮会把私有元素从view实现系统中过滤出来,不过这个按钮在Xcode 6.2环境下似乎不管用。
右侧按钮则把那些将属性设置为YES的view隐藏起来,搜索栏只显示符合搜索条件的view和constrait。
本教程将两个按钮都取消了选择且不使用搜索过滤。
从这里开始我们可以开始稍微往深一点探索了。将最后一个JSQMessagesCollectionViewCellOutgoing
展开,下面只有一个子视图: UIView
。
如果大家以前接触过collection view,大家就会知道这其实是讲得通的。因为任何一个UICollectionViewCell
都会有一个包含单元内容的contentView
属性。
点击(但不要展开)调试导航器的UIView
之后我们可以看到,此时Xcode已经在画布中将其显示高亮,这样大家可以很容易找到它在哪儿。
想要真正明白iOS怎样定位那个单元,我们需要按住cmd + option + 4
打开Size Inspector。顶部显示的是view的边界、定位以及锚定点。
但是,真正有意思的是该view中应用的Auto Layout约束列表。大家可以立刻知道单元内容的宽为312点,高为170点,并且位于其父视图的中心。内含的单元也是312*170,所以大家明白了吧,content view占了整个单元的空间。
下方是灰色的约束,表明这些约束决定了view及其子视图之间的关系。
要想了解某个特定约束的细节,首先我们要展开树形view中的那个view,然后是约束项。大家看到的是跟Size导航器中列出的相同的约束。
点击第一个约束(对我个人来说这是一个self.midX约束)并按住cmd + option + 3
切换到Object inspector。此时可以看到约束的item,multiplier,constant 和优先级。这非常像我们在在Interface Builder里面编辑一个约束时看到的summary。
除了尺寸大小和约束信息以外,我们还可以看到与object inspector中特定view显示有关的其他细节。返回至调试导航器,展开树形结构上的UIView
之后我们看到它包含了三个JSQMessageLabel
,两个UIView
。选择第一个JSQMessageLabel
(与时间戳一起的那个),然后打开Object inspector。
第一部分显示的是object的类名称和存储地址,第二部分显示的是从属于其外表的object的各公共属性的值。
这里我们可以看到标签的文本颜色为不含alpha的0.67灰,字体大小为12pt。
其他类中也包含了一些有用的信息,比如界面是如何可视化的。回到调试导航器,展开单元根UIView
下的第二个UIView,可以看到一个UIImageView
。
选择树形结构中的image view后查看Object inspector。
此时我们看到,view显示了用户的头像--在这种情况下,指的是作者的姓名首字母大写,JSQ。我们既可以查看正常图像,也可以查看带标记的图像以及颜色偏暗的图像,带标记高亮图像,这些图像可以反映用户何时点击单元。
单元根view下的另外两个JSQMessageLabel
目前没有文本,但是它们拟用于显示收件箱新消息的发送人姓名以及短信发送失败时提示错误信息。
以上就是在Xcode中调试view的步骤,够简单吧?想要继续运行app,我们只需要点击调试条上的Continue按钮,或者跳转到**Debug\Continue
**,就和我们在普通调试中的操作一样。
##实时修改
到目前为止,大家都了解了在Xcode中调试view的基本方法,那么现在我们就来练练手:我们在教程中探索过了collection view,现在通过调试器将其垂直滚动条指示器标红。
下面提出两点建议:
-
view调试和其他普通程序调试一样,我们可以在控制台使用expr或者其他命令,但是要记住,在恢复执行前这些改变不会显示出来。关于其他命令的更多信息,大家可以参考这个教程debugging apps in Xcode。
-
由于Objective-C的指针其实就是存储地址,所以我们发送一个object时实际上就是发送一个存储地址。这在调试器中是一样的道理,所以像这样的命令会打印出存储地址中的object的描述。
故障前先做几次尝试总是没错的,请看以下解决方法!
内部解决方法:解决方法 显示/隐藏
首先将view mode设置为“Contents”
在调试导航器中展开树形view中的collection view查看其子视图。
collection view里最后两个view就是的两个例子。它们分别是水平滚动条和垂直滚动条的指示器。点击第二个后我们可以看到垂直指示器在画布上被显示为高亮。
将Object inspector的image view存储地址复制下来。
此处滚动条指示器的存储地址是0x7fde6c484640
。给滚动条指示器上色所需要的步骤是发送一个setBackgroundColor
信息到该地址的object。以下是具体操作:
expr (void)[0x7fde6c484640 setBackgroundColor:[UIColor redColor]]
继续运行app,大家可以注意到当我们滚动collection view里的滚动条时,滚动条指示器变红。
恭喜大家掌握了在Xcode 6中调试view的基本知识!
##老式调试方法
实时view调试使得在Xcode 6中调试view变得更简单,但这并不意味着我们之前偏好的老式技巧一无是处。其实,iOS8为view调试技能包中引入了一个很受欢迎的附加物:_printHierarchy
。
注:大家已经掌握了在Xcode 6中调试view的基本知识,所以如果大家愿意,尽可以把这些可选部分省略掉。但是,大家如果对一些好用的老式技巧感兴趣的话,接着往下看!
###打印View Controller Hierarchy
_printHierarchy
是UIViewController
的一个私有方法,我们可以用它来打印控制台的**view controller
层级。建立之后运行,选择view controller
**然后点击调试条上的暂停按钮。
现在在控制台输入这些信息,然后按return。
po [[[[UIApplication sharedApplication] keyWindow] rootViewController] _printHierarchy]
我们得到的结果应该与以下结果类似:
| <TableViewController 0x7fdf53921f10>, state: disappeared, view: <UITableView 0x7fdf5283fc00> not in the window
| <DemoMessagesViewController 0x7fdf51d7d520>, state: appeared, view: <UIView 0x7fdf53c0b990>```
这表明,`UINavigationController`的第一个view controller是`TableViewController`--也就是我们选择如何push controller时的那个。第二个view controller是`DemoMessagesViewController`,也就是我们正在调试的view controller。
也许我举的这个特例并未让大家感到欣喜,但是如果大家的导航控制器中同时包含几个子视图控制器,并且modal view controller 中的popover包含一个tab bar controller(我其实也觉得我app里面的某些UI不是很好...),那么这对理解view controller层级的运作原理非常有帮助。
###打印View层级
如果大家的空间想象力不是很强并且倾向于直观地观看view层级的文本概述,大家可以使用`UIView`上传统的私有的`recursiveDescription` 。这里打印出的view层级与上述view controller层级非常相似。
打开**`Views\JSQMessagesCollectionViewCellOutgoing.m`**并在`awakeFromNib`中添加一个断点。
![pic-34](http://cdn5.raywenderlich.com/wp-content/uploads/2015/03/breakpoint.png)
建立并运行,然后选择**`Push via Storyboard`**。`JSQMessagesCollectionViewCellOutgoing`加载的同时调试器会分裂。然后输入以下内容至控制台:
```po [self.contentView recursiveDescription]```
这一步会打印出`JSQMessagesCollectionViewCellOutgoing`的`contentView`的层级,如下所示:
```<UIView: 0x7fde6c475de0; frame = (0 0; 312 170); gestureRecognizers = <NSArray: 0x7fde6c484fe0>; layer = <CALayer: 0x7fde6c474750>>
| <JSQMessagesLabel: 0x7fde6c475eb0; baseClass = UILabel; frame = (0 0; 312 20); text = 'Today 10:58 PM'; clipsToBounds = YES; opaque = NO; autoresize = RM+BM; userInteractionEnabled = NO; layer = <_UILabelLayer: 0x7fde6c476030>>
| <JSQMessagesLabel: 0x7fde6c476400; baseClass = UILabel; frame = (0 20; 312 0); clipsToBounds = YES; opaque = NO; autoresize = RM+BM; userInteractionEnabled = NO; layer = <_UILabelLayer: 0x7fde6c476580>>
| <UIView: 0x7fde6c476b50; frame = (70 20; 210 150); autoresize = RM+BM; layer = <CALayer: 0x7fde6c474dd0>>
| | <UIImageView: 0x7fde6c482880; frame = (0 0; 210 150); opaque = NO; userInteractionEnabled = NO; layer = <CALayer: 0x7fde6c476ae0>> - (null)
| <UIView: 0x7fde6c482da0; frame = (282 140; 30 30); autoresize = RM+BM; layer = <CALayer: 0x7fde6c482d00>>
| | <UIImageView: 0x7fde6c482e70; frame = (0 0; 30 30); opaque = NO; autoresize = RM+BM; userInteractionEnabled = NO; layer = <CALayer: 0x7fde6c482f70>> - (null)
| <JSQMessagesLabel: 0x7fde6c483390; baseClass = UILabel; frame = (0 170; 312 0); clipsToBounds = YES; opaque = NO; autoresize = RM+BM; userInteractionEnabled = NO; layer = <_UILabelLayer: 0x7fde6c483510>>```
这看起来非常基础,但是我们想要在 iOS 8之前的系统中调试view层级的话它还是非常有用的。
###使用debugQuickLookObject
最后,Xcode 5.1引入了一个叫做**`Debug Quick Look`**的特性。这个特性在我们调试中并且知晓了代码中特定点的object的外形时非常有用。
我们的自定义类可以执行`debugQuickLookObject`方法并且返回Xcode中可视觉上显示的一切信息。然后,当我们在进行调试并且需要查看object时,我们可以使用quick look,Xcode会将该object视觉再现。
比如,`NSURL`执行 `debugQuickLookObject`时会返回一个`UIWebView`,这个`UIWebView`中含有URL,所以我们可以看到URL背后所包含的内容。
更多关于使用Quick Look的调试信息,请参阅[文件材料](https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/CustomClassDisplay_in_QuickLook/Introduction/Introduction.html#//apple_ref/doc/uid/TP40014001-CH1-SW1)。
##未来趋势在何方?
以上就是实时View调试的全部内容。这个工具简单实用,并且能够节省我们手动筛选view层级并试图理解其绘制视图的原理和地址的时间。
如果大家想找一个比Xcode更先进更全面的工具,我建议大家看看Reveal。这是一个付费app,但是它的功能比Xcode的view调试更加强大。大家可以[点击此处](http://www.raywenderlich.com/99594/view-debugging-with-xcode-and-reveal-tech-talk-video)查看我们关于这方面的技术讲座。
希望大家喜欢本教程并且通过本教程的学习在调试UI时更得心应手。如果大家有任何建议或问题,欢迎在下方的论坛讨论区发言!