Xcode 修改新建文件中文件注释里的信息

By | 2016-10-25

最近用别人电脑写程序的时候发现用 Xcode 新建文件的文件注释中 Created by 是其他人的名字!!!!明显文件注释中的 Created by 默认取得当前电脑用户的用户名。

查阅了一下网上修改 Created by 的方法发现都不太合适,翻阅 Xcode Help 找到了想要的方法。

网络上常见的修改方法

常见的修改方法有大概这两种:

  1. 在 Xcode 安装包中修改官方模板文件
  2. 设置当前电脑用户的用户名

Xcode 官方提供的修改方法

在 Xcode Help 中看到了 Customize text macros 里面提到只需要在合适的地方添加一个 IDETemplateMacros.plist 文件就可以解决在不同的情况下使用不同的文件注释,优先级递减:

Project user data: <ProjectName>.xcodeproj/xcuserdata/[username].xcuserdatad/IDETemplateMacros.plist

仅仅对单个 Project 且单个用户有效。

Project shared data: <ProjectName>.xcodeproj/xcshareddata/IDETemplateMacros.plist

对单个 Project 的所有用户有效。

Workspace user data: <WorkspaceName>.xcworkspace/xcuserdata/[username].xcuserdatad/IDETemplateMacros.plist

对单个 Workspace 且单个用户有效。

Workspace shared data: <WorkspaceName>.xcworkspace/xcshareddata/IDETemplateMacros.plist

对单个 Workspace 的所有用户有效。

User Xcode data: ~/Library/Developer/Xcode/UserData/IDETemplateMacros.plist

对单个用户的所有新建文件有效。

常用的属性

Xcode 提供了多个可用于自定义的属性,下面列举几个常用的属性:

  1. FILEHEADER,替换新建文件的所有文件注释
  2. FULLUSERNAME,替换 Created by 作者
  3. NSHUMANREADABLECOPYRIGHTPLIST,版权申明

结语

相对于网络上普遍采用的方法,Xcode 提供的方法更加的灵活简单。
很多人喜欢给自己的电脑用户名起一个比较炫的名字,但是团队项目中很容易穿插各种奇奇怪怪的名字,乱而不规范。采用 Xcode 提供的方式去让项目变得更规范更整洁吧。

References:

Customize text macros