代码规范是每一个开发小组在实践中的一个痛点,如何让队伍中尽可能多的人遵循同一套代码风格,产出高质量的代码,同时能够尊重每位开发者的编程习惯,不增加冗余环节,是值得每个工程师思考的问题
在本文中,将利用Clang-format工具结合Xcode自带文件模版、Code Snippet探索iOS代码规范实践
Clang-format
ClangFormat describes a set of tools that are built on top of LibFormat. It can support your workflow in a variety of ways including a standalone tool and editor integrations.
Clang-format 是一个代码格式化工具,能够为C/C++/Java/JavaScript/JSON/Objective-C/Protobuf/C#提供格式化规则
安装clang-format
通过homebrew下载
1
brew install clang-format
查看是否安装成功
1
clang-format --version
添加clang-format服务
在 启动台 » 其他 » 自动操作 中选择 快速操作
脚本代码
1
2
export PATH=/usr/local/bin:$PATH
clang-format
保存服务并命名,例如保存为 Xcode-clang-format (很重要,后面还要用)
clang-format使用
在当前用户根目录~
放入 .clang-format
文件
1
touch ~/.clang-format
下载链接 .clang-format
具体参数意义详见 clang-format参数详解
添加clang-format快捷键
系统设置 » 键盘 » 快捷键 » APP快捷键 » Xcode.app 添加服务 Xcode-clang-format (之前保存的服务名)设置快捷键 Control + I
快去工程里试试吧
参考资料
Xcode File-template
Xcode的文件模板路径一般在下面这个目录
1
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates
所有的模板文件即存在File Template/iOS/Source中
复制 source 文件夹,重命名为 CustomTemplate ,即为自定义的文件模板分区
其中,又分为 Swift 和 OC 以及带XIB文件的文件夹,其中的 .h 和 .m 文件即为模板文件
以 OC 的 ViewController 为例
新建 CustomTemplate 下的 ViewController 文件
建立好的.m文件
通过模板,即可实现代码分区和一部分固定方法的重写实现
参考资料
Code Snippet
新建 Code Snippet
通知、Observer、懒加载、创建单例、贝塞尔曲线等格式化代码,均可通过上述方式存储起来
Comments powered by Disqus.