使用 Xcode 代码块
打开编辑器右侧的工具面板,就能看到所有可用的代码块。在工具面板的下方,有 4 个水平分布的小图标。
点击 { }
图标可以查看代码块仓库。
有两种方法将一个代码块插入你的代码:
你可以从代码块仓库拖到你的编辑器里面:
。。。亦或那些有快捷输入码的代码块,你可以这样:
为了让你能够对代码块的用途有个较直观的印象,下面是 Xcode 内置代码块的概览:
- C
enum
,struct
union
,和 blocks 的typedef
声明 - C 控制流语句像
if
,if
...else
,和switch
- C 循环,像
for
,while
,和do
...while
- C 内联 block 变量声明
- Objective-C
@interface
声明(包括类扩展和分类),@implementation
,@protocol
- Objective-C KVO 样板,包括相对模糊的
keyPathsForValuesAffecting<Key>
,用来 注册相关的键 - Objective-C Core Data 访问,属性存取,属性验证样板。
- Objective-C 枚举
NSIndexSet
惯用语 - Objective-C
init
,initWithCoder:
和initWithFrame:
实现方法 - Objective-C
@try
/@catch
/@finally
和@autorelease
blocks - GCD
dispatch_once
和dispatch_after
惯用语
创建 Xcode 代码块
当然,代码块功能之所以强大,是因为你可以创建自定义的代码块。
创建代码块的过程不是非常直观很难用文字去描述。它使用了 OS X 系统中一个比较隐晦的功能,让用户拖拽选中文本生成“剪切文本”。看下实际操作就很好理解:
用户将自定义的代码块添加到库里面后,可以双击列表中的块去编辑。
每个块都有以下内容:
- Title 标题 - 块的名字(出现在代码补全和代码块库列表中)
- Summary 简介 - 简单描述下它是干嘛的(只出现在代码块库列表中)
- Platform 平台 - 限制可访问该代码块的平台。OS X,iOS,或者(“全部”)
- Language 语言 - 限制可访问该代码块的语言。常见的有 C,Objective-C,C++,或 Objective-C++
- Completion Shortcut 输入码 - 快捷输入码。常用块的输入码应该非常简练。Xcode 不会警告冲突 / 重复的输入码,所以一定要确保新添加的不要和已有的冲突。
- Completion Scopes 有效范围 - 限制可访问该代码块的范围。
if
/else
语句的自动补全应该只在方法或者函数的实现中有效。下面这些选项可以任意组合:- All 全部
- Class Implementation 类实现
- Class Interface Methods 类接口方法
- Class Interface Variables 类接口变量
- Code Expression 代码表达式
- Function or Method 函数或方法
- Preprocessor Directive 预处理指令
- String or Comment 字符串或注释
- Top Level 最高层
~/Library/Developer/Xcode/UserData/CodeSnippets/
目录存放了所有 Xcode 代码段的文件表示
占位符
在你使用其他代码块时你可能已经注意到了这些占位符:
在 Xcode 中,占位符使用 <#
和 #>
来分隔,中间是占位文本。赶紧打开 Xcode 试试吧,看看井号中间的文本是怎样魔法般的转换到你眼前的。
赶紧使用占位符给你的代码块添加一点动态效果吧!
第三方 Xcode 代码块
你可以在 这个 GitHub 项目 找到一些好用的代码块(欢迎提交 PR!)。就算这里没你想要的,它至少提供了一些例子来展示代码块能够做些什么。