xcode5 自定义模板

经过一番周折，终于在xcode5上实现了一个简单的自定义模板，在项目中集成NSLogger库（增强NSLog的功能，https://github.com/fpillet/NSLogger）——新建项目中自动加入LoggerClient.h，LoggerClient.m ，LoggerCommon.h以及一些Frameworks。

如果从零开始定义一个模板，未免太过复杂，最简单的方法就是把系统模板复制过来修改^_^。

系统模板路径：

可以看到，两个路径下的模板都分为File Templates和Project Templates两种。顾名思义，文件模板用于创建文件，项目模板用于创建项目，这里需要的是Project Templates。这里在Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates/Project Templates/下找到Single View Application.xctemplate模板，复制到自定义模板路径下。

自定义模板的存放位置：

如果之前安装过cocos2d，那么在上面路径下就可以看到cocos2d的库文件。借鉴cocos2d和PhoneGap的做法，把Single View Application.xctemplate放在路径3下：

然后需要两步：

--把Single View Application.xctemplate文件夹名称改为xxx.xctemplate，后缀名必须为xctemplate，这里以Test Template.xctemplate为例。

--打开Test Template.xctemplate中的TemplateInfo.plist文件，将键Identifier的值改为com.apple.dt.unit.testTemplateApplication，这个值是模板的唯一标识。

保存更改后，在new project的templates dialog中就可以看到刚刚定义的模板了：

此时Test Template模板与系统的Single View Application模板是一样，要想进行自定义，我们先来分析下Test Template.xctemplate的组成。

--TemplateInfo.plist（必要）：所有的模板属性设置都在这里。

--TemplateIcon.tiff（可选）：定义显示在new project的dialog中的模板图标。

-- Main_iPhone.storyboard、Main_iPad.storyboard：要添加在项目中的文件。

所以这里我们把NSLogger的库文件放到Test Template.xctemplate下：

此时新建Test Template项目，肯定是不会自动添加上NSLogger文件的，看来还需要在TemplateInfo.plist中设置一番。

打开TemplateInfo.plist，先来分析一下各个键值的意义：

Ancestors：要继承的模板。也就是模板的“父类”，从父类那里继承一些模板的基础属性，可以有多个父类。

Concrete：设置为YES的模板才可以显示在new project的dialog中，此时这个模板不能被其他模板继承。

Definitions：将Nodes中定义的文件添加到项目中（还有其他功能，这里暂且不表）。

Description：就是Description。

Identifier：刚才已经接触过，模板的唯一标示符，若模板B要继承模板A，就在模板B的Ancestors中写上模板A的Identifier。

Kind：项目模板为Xcode.Xcode3.ProjectTemplateUnitKind，文件模板为Xcode.IDEKit.TextSubstitutionFileTemplateKind。

Nodes：定义要添加到项目中的文件（还有其他功能，这里暂且不表）。

Options：定义在new project中选择模板后点击next后的dialog中的内容，如Product Name、Organization Name、Company Identifier、Bundle Identifier等。

SortOrder：该模板显示在new project的dialog中的位置索引。

更详细的解释会在后面给出链接。

回头看下我们的需求：在新建项目中自动加入LoggerClient.h，LoggerClient.m ，LoggerCommon.h以及一些Frameworks。那么首先编辑的键值就是Nodes、Definitions。

Nodes编辑如下：

Definitions编辑如下：

需要注意的是这里LoggerClient.h，LoggerClient.m ，LoggerCommon.h三个文件都是放在NSLogger文件夹下的。

保存plist修改，此时新建Test Template项目，可以看到已经自动添加上了NSLogger类了。

还有一步工作，需要在项目中添加上NSLogger库要求的Frameworks。很简单，在plist中加入一个key ——Targets。

保存plist后，新建Test Template项目，完工。附上TemplateInfo.plist以供参考。

最后附上参考资料：http://www.learn-cocos2d.com/store/xcode4-template-documentation/里面详细的介绍文件模板和项目模板（Xcode4的方法适用与xcode5），以及TemplateInfo.plist中各个键值的意义。感谢这篇文章的作者。