ysnows / codesnippets

CodeSnippets

qmui-ios-codesnippets

qmui-ios-codesnippets 是一个 QMUI 团队日常工作中整理出来的用于 Xcode 的 iOS 通用代码片段集，其中也包含若干专用于 QMUI for iOS 框架的代码片段。

整理这个代码片段集的初衷有以下几点：

1. 我们发现由于 Xcode 本身的功能不足，导致我们经常在重写一些系统父类方法时容易忘了调用 super，从而出现一些很难排查的诡异bug。
2. Xcode 虽然有模糊匹配的代码提醒，但代码提醒只能帮你写方法名，而code snippets 还可以帮你填充一些默认的方法实现，或者直接移动光标到方法体内，省去几次光标操作。
3. 一些常用的写法本身语法可能比较复杂，难以记忆，例如实现一个类的单例、使用 swizzle 来重写系统控件的方法、block 在不同地方的语法不同等。
4. 一些代码本身看似简单，但由于特别常用，所以使用 code snippets 可以大大节省时间。

使用方式

Xcode 的 Code Snippets 文件存放于 ~/Library/Developer/Xcode/UserData/CodeSnippets  目录，只要直接把 *.codesnippets 文件放到这个目录下（若没有则自己创建），重启 Xcode 即可生效。

为了方便更新，建议直接将 qmui-ios-codesnippets clone 到这个目录内。其中以 QM_ 前缀开头的文件是通用的 Code Snippets，以 QMUI_ 前缀开头的文件是专用于 QMUI for iOS 框架的代码片段。在下方的快捷键汇总里，QMUI 的代码片段将会以QMUI的形式标记出来。

注意，Xcode 对每一段 Code Snippet 都有规定适用的语言（Objective-C、Objective-C++、Swift、...）和作用域（如 Class 的 Interface 定义内、Class 的 Implementation 内、方法体内、...），所以测试某段 Code Snippet 不生效时请注意你当前是否处于不匹配的位置。

快捷键汇总

NSObject

• pa - 定义一个 assign 的 property
• pc - 定义一个 copy 的 property
• ps - 定义一个 strong 的property
• psr - 定义一个 strong, readonly 的property
• pw - 定义一个 weak 的property
• propertySwizzleAssign - 用 swizzle 的方式定义一个 assign 的property
• propertySwizzleCopy - 用 swizzle 的方式定义一个 copy 的property
• propertySwizzleStrong - 用 swizzle 的方式定义一个 strong 的property
• propertySwizzleWeak - 用 swizzle 的方式定义一个 weak 的property
• sharedInstance - 为当前类创建一个实现单例功能的 sharedInstance 方法
• replaceMethod - 重写当前类的 load 方法并在其中用 swizzle 替换方法实现
• replaceMethod_QMUI - QMUI 重写当前类的 load 方法并用 ReplaceMethod() 函数替换方法的实现

Block

• blockArguments - 声明一个用于方法参数的 block
• blockproperty - 声明一个用于 property 的 block
• blocktypedef - 用 typedef 定义一个 block
• blockvar - 定义一个作为局部变量的 block

Method & Function

• fnv - 定义一个返回值为 void 的方法
• fnv: - 定义一个返回值为 void 且带参数的方法
• fnblock - 定义一个返回值类型为 block 的方法
• fnv_handleEvent - 定义一个用于 UIControl 事件回调的方法
• fnv_longPress - 定义一个用于 UILongPressGestureRecognizer 的回调方法（你就不用每次都去拼写那个很长的手势名字了）
• fnv_pan - 定义一个用于 UIPanGestureRecognizer 的回调方法
• fnv_tap - 定义一个用于 UITapGestureRecognizer 的回调方法

UIView

• setFrame - 为 UIView 设置 frame
• setFrame_QMUI - QMUI 使用像素对齐的 CGRectFlatMake() 为 UIView 设置 frame
• setFrameX - QMUI 使用 CGRectSetX() 修改 UIView 的 frame.origin.x
• setFrameY - QMUI 使用 CGRectSetY() 修改 UIView 的 frame.origin.y
• setFrameXY - QMUI 使用 CGRectSetXY() 修改 UIView 的 frame.origin
• sizeThatFits - 为当前 view 创建 sizeThatFits: 方法
• layoutSubviews - 展开 layoutSubviews 方法
• getWidth - 展开 CGRectGetWidth()
• getHeight - 展开 CGRectGetHeight()
• getMinX - 展开 CGRectGetMinX()
• getMinY - 展开 CGRectGetMinY()
• getHor - QMUI 展开 UIEdgeInsetsGetHorizontalValue()
• getVer - QMUI 展开 UIEdgeInsetsGetVerticalValue()
• addtarget - 调用 UIControl addTarget:action:forEvents: 方法
• setImageForButton - 为 UIButton 设置图片
• setTitleColorForButton - 为 UIButton 设置文字颜色
• setTitleForButton - 为 UIButton 设置文字

UITableView

• initWithStyle - 展开 initWithStyle: 方法
• initWithStyleForCell - 展开 UITableViewCell initWithStyle:reuseIdentifier: 方法
• tableViewDelegate - 展开常用的几个 UITableViewDelegate 方法
• numberOfSectionsInTableView - 展开 numberOfSectionsInTableView:方法
• numberOfRowsInSection - 展开 tableView:numberOfRowsInSection: 方法
• cellForRowAtIndexPath - 展开 tableView:cellForRowAtIndexPath: 方法
• heightForRowAtIndexPath - 展开 tableView:heightForRowAtIndexPath: 方法
• didSelectRowAtIndexPath - 展开 tableView:didSelectRowAtIndexPath: 方法

UICollectionView

• collectionViewDelegate - 展开常用的几个UICollectionViewDelegate 方法
• numberOfSectionsInCollectionView - 展开 numberOfSectionsInCollectionView:
• numberOfItemsInSection - 展开 collectionView:numberOfItemsInSection:
• cellForItemAtIndexPath - 展开 collectionView:cellForItemAtIndexPath:
• sizeForItemAtIndexPath - 展开 collectionView:layout:sizeForItemAtIndexPath: 方法
• didSelectItemAtIndexPath - 展开 collectionView:didSelectItemAtIndexPath: 方法
• didDeselectItemAtIndexPath - 展开 collectionView:didDeselectItemAtIndexPath: 方法

UIViewController

• loadView - 展开 loadView 方法
• viewDidLoad - 展开 viewDidLoad 方法
• viewWillAppear - 展开 viewWillAppear: 方法
• viewDidAppear - 展开 viewDidAppear: 方法
• viewWillDisappear - 展开 viewWillDisappear: 方法
• viewDidDisappear - 展开 viewDidDisappear: 方法
• viewDidLayoutSubviews - 展开 viewDidLayoutSubviews: 方法
• initSubviews - QMUI 展开 initSubviews 方法
• setNavigationItems - QMUI 重写 QMUICommonViewController 里的 setNavigationItemsIsInEditMode:animated: 方法
• setToolbarItems - QMUI 重写 QMUICommonViewController 里的 setToolbarItemsIsInEditMode:animated: 方法
• leftBarButtonItemImage - QMUI 用 QMUINavigationButton 的方法创建一个用于 navigationItem.leftBarButtonItem 的 UIBarButtonItem
• rightBarButtonItemImage - QMUI 用 QMUINavigationButton 的方法创建一个用于 navigationItem.rightBarButtonItem 的 UIBarButtonItem

Other

• pragma - 展开一个用于 Xcode 导航的 #pragma mark - 宏
• externRefInH - 在 *.h 文件里声明一个 extern const 的指针
• externRefInM - 在 *.m 文件里为一个 extern const 的指针赋值
• externValueInH - 在 *.h 文件里声明一个 extern const 的值变量
• externValueInM - 在 *.m 文件里为一个 extern const 的变量赋值
• static reference - 定义一个 static 的指针
• static - 定义一个 static 的值变量
• __weakSelf - 定义一个 weak 的 self 指针
• __strongSelf - 将 weakSelf 指针改为 strong 的 self 指针
• logCallStackSymbols - 用 NSLog 打出当前的方法调用栈信息
• timeConsuming - 展开一段用 CACurrentMediaTime() 来计算方法耗时的代码