码迷,mamicode.com
首页 > 移动开发 > 详细

iOS插件详解之----CLangFormat(代码格式化管理插件)(2016.1.12王彬)

时间:2016-01-12 21:11:13      阅读:407      评论:0      收藏:0      [点我收藏+]

标签:

iOS插件详解之----CLangFormat(代码格式化管理)(2016.1.12王彬)

 

虽然在项目创建和团队组建的初期,我们就把公共约定以及一些规范定下来了,并且由于我们的代码是通过Git来做版本控制的,web上直接就支持Markdown格式的readme文件,可以随时看到最新的版本,但是这种规范只能依靠个人的意识,或者通过代码Review来解决,而且做代码Review的时候,你也不好意思总是写上一堆诸如“这里要加个空格”、“那里要加上换行”的评论吧?如果不管,久而久之,会因为每个人的习惯不同,代码呈现出多种风格,看起来也不像一个成熟团队做出来的产品。

为了弥补Xcode代码格式化的短板,我们选择了引入一个第三方的插件:CLangFormat

 

具体流程:

1. 安装CLangFormat

安装方法一:直接在Package Manager里搜索并安装,如果不想安装Package Manager的话,就直接把上面那个GitHub中的代码Clone下来,在Xcode中编译、运行,然后重启Xcode即可。

技术分享

安装方案二:

GitHub地址:https://github.com/travisjeffery/ClangFormat-Xcode

 下载插件->打开ClangFormat.xcodeproj文件,com+B运行,重启xcode,完事.

 

2.  配置CLangFormat(如果不需要自定义,可以跳过本步骤)

虽然CLangFormat本身就内置了一些标准化的代码格式化方案,但是同样可以自定义,我们就采用了自定义的方法。

具体的,在工程目录或者workspace目录下创建一个".clang-format"文件,添加类似于以下内容的参数:

  1. # 基础样式  
  2. BasedOnStyle: LLVM  
  3.   
  4. # 缩进宽度  
  5. IndentWidth: 4  
  6.   
  7. # 圆括号的换行方式  
  8. BreakBeforeBraces: Attach  
  9.   
  10. # 支持一行的if  
  11. AllowShortIfStatementsOnASingleLine: true  
  12.   
  13. # switch的case缩进  
  14. IndentCaseLabels: true  
  15.   
  16. # 针对OC的block的缩进宽度  
  17. ObjCBlockIndentWidth: 4  
  18.   
  19. # 针对OC,属性名后加空格  
  20. ObjCSpaceAfterProperty: true  
  21.   
  22. # 每行字符的长度  
  23. ColumnLimit: 0  
  24.   
  25. # 注释对齐  
  26. AlignTrailingComments: true  
  27.   
  28. # 括号后加空格  
  29. SpaceAfterCStyleCast: true  

然后在Xcode的“Edit”->“CLang Format”中选中“File”,并让倒数第二行显示“Disable Format On Save”。

技术分享

后面这个看实际情况,需不需要在文件随时保存的时候格式化,如果喜欢用快捷键的话,在“系统偏好设置”里能对所有的Menu选项设置快捷键,设置一个“Format File in Focus”的快捷键也很好用。

 

附上CLangFormat的所有可用参数文档:http://clang.llvm.org/docs/ClangFormatStyleOptions.html

附上我目前所使用的格式:

  1. # 基础样式  
  2. BasedOnStyle: LLVM  
  3.   
  4. # 缩进宽度  
  5. IndentWidth: 4  
  6.   
  7. # 圆括号的换行方式  
  8. BreakBeforeBraces: Attach  
  9.   
  10. # 支持一行的if  
  11. AllowShortIfStatementsOnASingleLine: true  
  12.   
  13. # switch的case缩进  
  14. IndentCaseLabels: true  
  15.   
  16. # 针对OC的block的缩进宽度  
  17. ObjCBlockIndentWidth: 4  
  18.   
  19. # 针对OC,属性名后加空格  
  20. ObjCSpaceAfterProperty: true  
  21.   
  22. # 每行字符的长度  
  23. ColumnLimit: 0  
  24.   
  25. # 注释对齐  
  26. AlignTrailingComments: true  
  27.   
  28. # 括号后加空格  
  29. SpaceAfterCStyleCast: true  
  30.   
  31. # 不在小括号里加空格  
  32. SpacesInParentheses: false  
  33.   
  34. # 不在中括号里加空格  
  35. SpacesInSquareBrackets: false  

 

三,安装过程中出现的问题:

从Xcode 5开始,苹果要求加入UUID证书从而保证插件的稳定性。
因此Xcode版本更新之后需要在ClangFormat.xcodeproj的Info.plist文件中添加Xcode的UUID。
 
步骤如下:
 
方式一、查看Xcode的UUID
终端执行 defaults read /Applications/Xcode.app/Contents/Info DVTPlugInCompatibilityUUID
技术分享
拷贝选中的字符串。
在/Applications目录中找到Xcode.app,右键”显示包内容”,进入Contents文件夹,双击Info.plist打开,找到DVTPlugInCompatibilityUUID,拷贝后面的字符串。
 
方式二、添加Xcode的UUID到ClangFormat.xcodeproj的Info.plist文件
1、打开xcode插件所在的目录:~/Library/Application Support/Developer/Shared/Xcode/Plug-ins;
2、选择已经安装的插件例如ClangFormat,右键”显示包内容”;
3、找到info.plist 文件,找到DVTPlugInCompatibilityUUIDs的项目,添加一个Item,Value的值为之前Xcode的UUID,保存。

插件安装经验总结:

在每次xcode升级后他的DVTPlugInCompatibilityUUIDs的内容都会更新,

但是插件的并不更新,所以要把下载好的插件配置一下再运行,这样就会一次成功了.

四,配合Xcode自带的格式化操作,就很不错了

选中内容组合操作:

第一步:ClangFormat(control+U)

第二步:XcodeFormat(control+I)

 

选中文件组合操作:

第一步:ClangFormat(control+shift+U)

第二步:XcodeFormat(control+A,control+I)

 

修改ClangFormat.xcodeproj工程里的TRVSClangFormat.m文件的内容,实现快捷键功能(control+U和control+shift+U):

技术分享
 1 - (void)addActioningMenuItemsToFormatMenu {
 2   NSMenuItem *formatActiveFileItem = [[NSMenuItem alloc]
 3       initWithTitle:NSLocalizedString(@"Format File in Focus", nil)
 4              action:@selector(formatActiveFile)
 5       keyEquivalent:@""];
 6   [formatActiveFileItem setTarget:self.formatter];
 7   [self.formatMenu addItem:formatActiveFileItem];
 8   NSMenuItem *formatSelectedCharacters = [[NSMenuItem alloc]
 9       initWithTitle:NSLocalizedString(@"Format Selected Text", nil)
10              action:@selector(formatSelectedCharacters)
11       keyEquivalent:@"u"]; //modified by Kenmu
12   [formatSelectedCharacters setKeyEquivalentModifierMask:NSControlKeyMask]; //created by Kenmu, in order to use shortcut key to access it.
13   [formatSelectedCharacters setTarget:self.formatter];
14   [self.formatMenu addItem:formatSelectedCharacters];
15   NSMenuItem *formatSelectedFilesItem = [[NSMenuItem alloc]
16       initWithTitle:NSLocalizedString(@"Format Selected Files", nil)
17              action:@selector(formatSelectedFiles)
18       keyEquivalent:@"u"]; //modified by Kenmu
19   [formatSelectedFilesItem setKeyEquivalentModifierMask:NSControlKeyMask | NSShiftKeyMask]; //created by, in order to use shortcut key to access it. Kenmu
20   [formatSelectedFilesItem setTarget:self.formatter];
21   [self.formatMenu addItem:formatSelectedFilesItem];
22 }
技术分享

 

跟VVDocumenter规范注释生成器的安装方式一样:

下载开源工程在Xcode重新编译运行会自动安装此插件,重启Xcode就可以使用了

 

PS:可以使用系统偏好设置中设置键盘里针对某应用程序的快捷键,如下操作:

技术分享

 

插件设置:

技术分享

 

使用方式:

技术分享

 

 

技术分享

 

iOS插件详解之----CLangFormat(代码格式化管理插件)(2016.1.12王彬)

标签:

原文地址:http://www.cnblogs.com/wangbinios/p/5125522.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!