iOS 第七课 代码注释 提高iOS开发效率 - 巧用注释

提高iOS开发效率 - 巧用注释

iOS实际开发中经常要在几个甚至十几个文件中切来切去，同一个文件中还有许多地方同时编辑，这样就引来一个问题，如何快速定位要编辑的代码位置，传统的做法就是切到一个文件用鼠标滚轮拼命的找之前编辑的代码位置，今天我给大家分享一些技巧。

1、#pragma mark

#pragma mark -
#pragma mark Table Delegate Methods

从技术上讲，以 #pragma 开头的代码是一条编译器指令，是一个特定于程序或编译器的指令。它们不一定适用于其它编译器或其它环境。如果编译器不能识别该指令，则会将其忽略。

作用： 

告诉Xcode编译器，要在编辑器窗格顶部的方法和函数弹出菜单中将代码分隔开，如下图所示：

2、使用特殊注释:

// TODO:
// FIXME:
// !!!:
// ???:

在XCode 3,我们可以用类似这样的注释来方便我们标记需要修改的部分。

在XCode 4,需要做如下设置，才可以在编译后的Warning里面看到我们标记的TODO, FixME等：

进入项目属性设置那个页面 
选择一个Target 
选择Build Phases标签 
点击右下角的Add Build Phase 
展看上面刚出现那一栏Run Script,输入以下内容

KEYWORDS="TODO:|FIXME:|\?\?\?:|\!\!\!:"
find "${SRCROOT}"  −name"∗.h"−or−name"∗.m"  -print0 | xargs -0 egrep --with-filename --line-number --only-matching "($KEYWORDS).*\$" | perl -p -e "s/($KEYWORDS)/ warning: \$1/"

当然你也可以自己定义一些特殊注释.

在XCode 4看到的效果，如下图所示：

 

找代码是不是方便多了,哈哈!

IOS开发之----XCode代码注释小插件使用

 

首先要下载这个服务 

http://ishare.iask.sina.com.cn/f/33943304.html

这是一个老外写的工作流，解压缩，然后双击，安装一下， 

选择xcode  -- services --services perference

安装完就会在右边的菜单中的文本部分中看到Document Code 这个菜单 

然后点击左边菜单中的"添加应用程序快捷键"(Applications Shortcuts) 

点击加号，为这个新服务增加一个快捷键 

现在你可以在Xcode中使用新的快捷键了 

先选中需要注释的方法名，然后使用快捷键，就会发现方法名上面有注释了 

经常在 Xcode IDE 里面的代码中看到以下代码指令:

#pragma mark -
#pragma mark Initialization

#pragma 是什么

从技术上讲，以 #pragma 开头的代码是一条编译器指令，是一个特定于程序或编译器的指令。它们不一定适用于其它编译器或其它环境。如果编译器不能识别该指令，则会将其忽略。

作用

它们告诉Xcode编译器，要在编辑器窗格顶部的方法和函数弹出菜单中将代码分隔开

 

一些类（尤其是一些控制器类）可能很长，方法和函数弹出菜单可以便于代码导航。此时加入#pragma 指令对代码进行逻辑组织很有效果。

注意

1. #pragma mark – 的“-”后面不能有空格。
2. 如果你的标志没有出现在弹出菜单中，比如没有分隔线出现，请在Xcode菜单 “Preferences..”中的 “Code Sense”选项取消选中”Sort list alphabetically”即可。