经过一番周折,终于在xcode5上实现了一个简单的自定义模板,在项目中集成NSLogger库(增强NSLog的功能,https://github.com/fpillet/NSLogger)——新建项目中自动加入LoggerClient.h,LoggerClient.m ,LoggerCommon.h以及一些Frameworks。
如果从零开始定义一个模板,未免太过复杂,最简单的方法就是把系统模板复制过来修改^_^。
系统模板路径:
//路径1 Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates //路径2 Xcode.app/Contents/Developer/Library/Xcode/Templates
可以看到,两个路径下的模板都分为File Templates和Project Templates两种。顾名思义,文件模板用于创建文件,项目模板用于创建项目,这里需要的是Project Templates。这里在Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates/Project Templates/下找到Single View Application.xctemplate模板,复制到自定义模板路径下。
自定义模板的存放位置:
~/Library/Developer/Xcode/Templates
如果之前安装过cocos2d,那么在上面路径下就可以看到cocos2d的库文件。借鉴cocos2d和PhoneGap的做法,把Single View Application.xctemplate放在路径3下:
//路径3 ~/Library/Developer/Xcode/Templates/Project Templates/Application
然后需要两步:
--把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中各个键值的意义。感谢这篇文章的作者。