Xcode 代码块工具简介

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，用来 注册相关的键
  • Objective-C 的 Core Data 访问，属性存取，属性验证样板。
  • Objective-C 的枚举 NSIndexSet 惯用语
  • Objective-C 的 init，initWithCoder: 和 initWithFrame: 实现方法
  • Objective-C @try/@catch/@finally和@autorelease blocks
  • GCD dispatch_once和dispatch_after惯用语
  • C++ 相关
  • Swift 相关
  • 几个特殊方法
    • test method
    • debugDescription
    • description

      Tips:

      • Enumerated Type Declaration (NS_ENUM) 的缩写是 NSENUM
      • Enumerated Type Declaration (NS_OPTIONS) 的缩写是 NS_OPTION
      • ~/Library/Developer/Xcode/UserData/CodeSnippets/目录存放了所有 Xcode 代码段的文件表示

自定义代码块

  • 拖拽代码块至 {} 面板即可， 可以参考下图
  • 用户将自定义的代码块添加到库里面后，可以双击列表中的块去编辑。
  • 每个块都有以下内容：
    • Title 标题 - 代码块的名字（出现在代码补全和代码块库列表中）
    • Summary 简介 - 简单描述下它是干嘛的（只出现在代码块库列表中）
    • Platform 平台 - 限制可访问该代码块的平台。macOS，iOS，tvOS, watchOS 或者（“全部”）
    • 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 最高层
    • 占位符
      • 在 Xcode 中，占位符使用<#和#>来分隔，中间是占位文本。

Reference