使用Xcode插件，让iOS开发更加便捷

在iOS开发过程中，写注释是一项必不可少的工作。这不仅有助于自己对代码整理回顾，而且提高了代码的可读性，让代码维护变得容易。但是，写注释又是一项枯燥的工作。我们浪费了大量的时间在输入/*，*，*/这样的字符中。并且，这些字符输入非常麻烦。VVDocumenter-Xcode，把我们从枯燥的字符输入中解放出来。

什么是VVDocumenter-Xcode

VVDocumenter是一个能够帮助我们快速生成注释模板的插件。我们只要在需要注释的方法前输入///，注释就会自动生成，并提取出各个参数和返回值。我们只需要填写占位符的内容即可完成注释的编写。给出一张效果图，感受一下。

顺便说一下，VVDocumenter同样支持Swift。上周，中国第一届Swift大会成功举办。我相信，国内会掀起一场Swift学习的热潮。

安装和使用VVDocumenter-Xcode

最好的安装方法就是通过Alcatraz。从Github上下载Alcatraz的Repo，使用Xcode编译就完成了安装。之后，重启Xcode并按下⇧⌘9，打开Alcatraz，搜索VVDocumenter，点击左上角的INSTALL，就会自动安装了。

如果不想通过Alcatraz来安装，我们同样可以下载VVDocumenter的Repo，在Xcode中进行编译来安装。重启Xcode之后，就可以使用///来自动生成注释了。

如果你不喜欢使用///，可以在Xcode的Window菜单中，找到VVDocument，打开设置面板，修改Trigger Input项。在设置选项中，还可以修改tab的空格数以及生成的注释的样式。

Xcode的版本

从Xcode 5.0开始，苹果给所有的插件都增加了UUID验证，以保证Xcode在更新之后的稳定性。插件的plist文件中的DVTPlugInCompatibilityUUIDs值，包含了当前Xcode版本的UUID，否则插件不起作用。

从Xcode 6.3开始，如果我们使用插件，会被提示Load third party bundle。我们应该选择Load bundles，以保证插件可用。如果我们不小心选择了skip bundle，可以使用下面的命令行，重置这条提示。

defaults delete com.apple.dt.Xcode DVTPlugInManagerNonApplePlugIns-Xcode-{your_xcode_version}  

当Xcode更新后，所有插件都会无效。因为插件的plist中的DVTPlugInCompatibilityUUIDs值没有包含最新的版本Xcode的UUID。这时，我们应该试着删除插件目录（默认是~/Library/Application Support/Developer/Shared/Xcode/Plug-ins）下的VVDocument，然后从master分支clone、编译最新版本。也可以尝试使用Alcatraz重新安装。

更多的插件

在Xcode中使用插件会让我们的开发更加快捷。唐巧在《iOS开发进阶》一书中，为我们推荐了许多好用的插件。大家也可以在Alcatraz中去寻找适合自己的插件。

下面，附上《iOS开发进阶》一书中提到的常用插件。

1. KSImageNamed是一个能帮助你输入[UIImage imageNamed:]中的资源名的插件。当你输入[UIImage imageNamed:]时，会自动弹出上下文菜单，供你选择你需要输入的图片资源名字，另外在选择图片资源时，还可以在左侧预览该资源。

2. XVim是一个Xcode的vim插件，可以在Xcode的编辑窗口中开启vim模式。vim模式最大的好处是可以全键盘操作，可以方便地移动光标，以及复制、粘贴代码。XVim对于Xcode的分栏模式也有很好的支持，与vim自带的分栏模式一样，可以用快捷键Ctrl + W来切换当前编辑的分栏。

3. FuzzyAutocompletePlugin允许使用模糊的方式来进行代码自动补全。举个栗子，如果我们要重载ViewDidAppear:方法，那么我们必须依次键入view、did、appear才能得到相应的补全信息，使用FuzzyAutocompletePlugin之后，我们可以键入vda（view、did、appear三个单词的首字母），或任意符合viewDidAppear整个单词出现顺序的子串（例如vdapp，idear等），即可匹配到该方法。

4. XToDo是一个查找项目中所有的带有TODO、FIXME、???、!!!标记的注释。通常我们在项目开发中，由于种种原因，一些事情需要以后处理，这个时候为了防止遗忘，加上TODO或FIXME注释是非常有必要的，但是上线或者提交代码前要寻找这些未解决的事项却稍嫌麻烦。XToDo可以提供一个汇总的界面，集中显示所有的未完成的TODO和FIXME标记。

5. BBUDebuggerTuckAway是一个非常小的工具，可以在你编辑代码的时候自动隐藏底部的调试窗口。因为通常情况下，调试的时候是加断点或监控变量的变化，或者在Console窗口用po来输出一些调试信息。如果开始编辑代码了，说明调试已经结束了，这个时候隐藏调试窗口，可以给编辑界面更多空间，方便我们修改代码。

6. SCXcodeSwitchExpander能够帮助你迅速地在switch语句中填充枚举类型的每种可能的取值。例如，当你输入switch，然后键入NSTableViewAnimationOptions类时，该插件会将其可能的取值补全在每一个case之后。

7. deriveddata-exterminator是一个清楚Xcode缓存目录的插件。有些时候Xcode会出现各种奇怪的问题，最常见的是在某些复杂操作下（例如，在同一个项目中，来回切换到各种分支版本），会造成Xcode显示一些编译的错误或警告，但是最终又可以编译通过。新手遇到这种问题常常束手无策，而熟悉Xcode的人就知道，通常清除Xcode缓存就可以解决这类问题。该插件在Xcode菜单上增加了一个清除缓存的按钮，可以方便地一键清除缓存。

8. ClangFormat是一个自动调整代码风格的工具。Xcode本身的代码缩进自动调整功能比较弱，特别是对于JSON格式，常常产生非常丑陋的默认缩进效果。ClangFormat-Xcode可以更好地对代码进行重新排版，并且内置了各种排版风格，也支持自定义风格。

9. ColorSense是一个UIColor颜色输入辅助工具，可以帮助你在编写UIColor代码时，实时预览相应的颜色。

10. XcodeBoost包含多个辅助修改代码的小功能。比如：

• 可以方便地将.m文件中方法的定义暴露到对应的.h文件中。

• 可以在某一个源文件中直接输入正则表达式查找。

• 可以复制粘贴代码时不启用Xcode的自动缩进功能。Xcode的自动缩进经常出问题，造成已经调整好的代码缩进，在粘贴时被Xcode调整坏了。

参考文章：

• Github上VVDocumenter-Xcode

• 唐巧的《iOS开发进阶》