Xcode 3 ぐらいまでなら Xcode のカスタマイズの知識もあったのに、今ではその知識も通用しない。Xcode 6 の使い勝手を良くするために日夜努力をしています（Xcode 3 を久しぶりに起動したら日本語化されていてちょっと感動しました）。
追加するのは AppleScriptObjC のテンプレートですが、方法や考え方は他の言語のテンプレートを作るときでも同じです。プログラミング言語用と限定すると使い勝手が悪いですが、書式の決まったテキストファイルの生成などにも応用できます。
Swift でも Objective-C でも ReadMe でも BSD ライセンスでも請求書でもなんでもござれ。
では、本題。テンプレートの作り方自体は、Xcode 4 の頃から変わりはありません。
Xcode に最初から入っているテンプレートは Xcode 内にあります。
/Applications/Xcode.app/Contents/Developer/Library/Xcode/Templates/
一方、自分で追加するテンプレートは次の場所になります。
~/Library/Developer/Xcode/Templates/
テンプレートは 2 種類あります。プロジェクトテンプレートとファイルテンプレートです。取り上げるのはファイルテンプレートです。ファイルテンプレートは Templates に File Templates をいうフォルダを作り、そこにテンプレートを配置します。
~/Library/Developer/Xcode/Templates/File Templates/
さらに File Templates/ 以下にフォルダを作ると、Xcode の新規テンプレート作成ウィンドウでカテゴリとして表示されます。例えば、ASOC というフォルダを作ると Xcode でも ASOC というカテゴリが追加されます。
以上、テンプレートの保存場所と分類方法です。次にテンプレートの構成要素について。
Xcode のテンプレートは必要なファイルをまとめたバンドル形式になっています。最低でも必要なファイルは以下の通りです。
- ___FILEBASENAME___.applescript
- テンプレートの雛形。拡張子が applescript になっているけど、swift や m など、目的に応じたもので可
- TemplateIcon.png
- Xcode 上で表示されるテンプレートのアイコン（48 x 48）
- TemplateInfo.plist
これらのファイルを拡張子 xctemplate を持ったバンドル（実際はただのフォルダ）にまとめ、Templates/ に置くと Xcode でテンプレートとして認識されるようになります（テンプレートの雛形も plist ファイルも中身が空でもいい）。
ここまでで Templates/ は次のようになっています。
実際に Xcode で新規ファイルを作成すると、テンプレート選択画面に表示されます。テンプレートの構成要素は以上です。
最後に一番大事な TemplateInfo.plist について。このファイルに記述されている内容に従って Xcode はテンプレート選択画面にオプションを追加したり、テンプレートに記述されている変数を展開していきます。
テンプレートに記述されている変数というのは、アンダースコア 3 つで囲まれたアルファベット大文字の文字列のことです。主な変数は次の通り。
- ___FILENAME___
- ___FILEBASENAMEASIDENTIFIER___
- C 言語のスタイルに変換したファイル名（拡張子を含まない）
- ___PROJECTNAME___
- ___PROJECTNAMEASIDENTIFIER___
- ___USERNAME___
- ___FULLUSERNAME___
- ___ORGANIZATIONNAME___
- ___DATE___
- ___TIME___
- ___YEAR___
- ___COPYRIGHT___
- ___FILEEXTENSION___
では、実際にテンプレートファイルに上記の変数を追加してみましょう。___FILEBASENAME___.applescript というファイルをテキストエディタで作成し以下のように記述。
--
-- ___FILENAME___
-- ___PROJECTNAME___
--
-- Created by ___FULLUSERNAME___ on ___DATE___.
--___COPYRIGHT___
--
script ___FILEBASENAMEASIDENTIFIER___
property parent : class "NSObject"
end script
ここ、重要なのですが、このテンプレートファイルはテキストエディタで作成してください。決して Script Editor で作ってはいけません。Script Editor で作成し、保存するとファイルのエンコーディングが us-ascii になります。このエンコーディングだと Xcode で利用できなくなります。
テンプレートファイルは UTF-8、改行コード LF で保存してください。
次に TemplateInfo.plist を編集します。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>DefaultCompletionName</key>
<string>Empty AppleScript File</string>
<key>Description</key>
<string>An empty AppleScript File</string>
<key>Kind</key>
<string>Xcode.IDEKit.TextSubstitutionFileTemplateKind</string>
<key>MainTemplateFile</key>
<string>___FILEBASENAME___.applescript</string>
<key>Name</key>
<string>Empty AppleScript File</string>
<key>SortOrder</key>
<integer>1</integer>
<key>Summary</key>
<string>An empty AppleScript File</string>
<key>Platforms</key>
<array>
<string>com.apple.platform.macosx</string>
</array>
</dict>
</plist>
それぞれのキーは適切な値で設定され、意味は以下の通りです。
- DefaultCompletionName（文字列）
- Description（文字列）
- Kind（文字列）
- テンプレートの種類。現在、
Xcode.IDEKit.TextSubstitutionFileTemplateKind しかない
- MainTemplateFile（文字列）
- テンプレートとして利用されるファイル名（拡張子含む）
- Name（文字列）
- SortOrder（整数値）
- Summary（文字列）
- テンプレート選択画面に表示されるテンプレートの説明
- Platforms（配列）
- 利用される OS。
com.apple.platform.macosx なら、OS X。com.apple.platform.iphoneos なら iOS。指定がない場合はテンプレート選択画面の iOS、OS X の両方に表示される
これらを記述し、Xcode で新規ファイルを選択すると次のように表示されます。
テンプレートを選択し、進んでいくと保存できます。
以上でシンプルなテンプレートなら作れると思います。次に Xcode でオプションを入力するファイルテンプレートの作り方。
Xcode で Cocoa Class といったファイルテンプレートを選択すると、次のような画面が表示されます。
新規ファイルを作成するときのオプションですね。これらのオプションは TemplateInfo.plist に Options キーとして記述することで追加できます。
Options で利用される主なキーは次の通りです。
- Default（文字列）
- Description（文字列）
- Identifier（文字列）
- UI の識別子。この識別子を使ってテンプレート内の変数を展開する
- Name（文字列）
- Required（真偽値）
- Type（文字列）
- UI のタイプ。
static、text、combo、popup、class、buildSetting 等がある
- NotPersisted（真偽値）
- Values（配列）
- Type で
combo、popup、class を指定した時に表示される値
- RequiredOptions（配列）
これら以外にもキーはありますが、割愛。
例えば、Options の Type に text と記述しておくとテキスト入力欄が追加されます。TemplateInfo.plist に以下を追加します。
<key>Options</key>
<array>
<dict>
<key>Description</key>
<string>Description of input value</string>
<key>Default</key>
<string>MyClass</string>
<key>Identifier</key>
<string>productName</string>
<key>Name</key>
<string>Class:</string>
<key>NotPersisted</key>
<true/>
<key>Required</key>
<true/>
<key>Type</key>
<string>text</string>
</dict>
</array>
保存し、Xcode で新規ファイルを選択し、進んでいくと次のような画面が表示されます。
今までは最後のファイル保存でファイル名をつける必要がありましたが、今後はここで入力した値がファイル名として利用されるようになります。
もう少し複雑なオプションをつけてみます。現在は NSObject を継承した単純なスクリプトを作るだけですが、今度は NSView を継承したスクリプトも選べるようにします。この方法を理解するために Xcode で新規の Cocoa クラスを作ってみます。
Xcode で新規ファイルを選択し、Source の Cocoa Class を選び、次に進みます。これらのオプションにはそれぞれ Identifier が TemplateInfo.plist で設定されています。
Xcode はここで入力された値をつなぎ、その文字列をもとにテンプレートを選びます。この例なら NSViewControllerXIBSwift にある ___FILEBASENAME___.swift と ___FILEBASENAME___.xib が選ばれます。
オプションから利用されるテンプレートが入っているフォルダを探し、そのフォルダ内のテンプレートファイルを開く...このような感じですね。
では、実際にやってみましょう。
TemplateInfo.plist の Options を編集します。
<dict>
<key>Default</key>
<string>NSObject</string>
<key>Description</key>
<string>What class to subclass in the new file</string>
<key>Identifier</key>
<string>cocoaSubClass</string>
<key>Name</key>
<string>Subclass of:</string>
<key>Required</key>
<true/>
<key>Type</key>
<string>popup</string>
<key>Values</key>
<array>
<string>NSObject</string>
<string>NSView</string>
</array>
</dict>
これでポップアップメニューから NSObject か NSView を選択できるようになります。NSObject を選択すると NSObject というフォルダ内にある ___FILEBASENAME___.applescript を使ってファイルを作成します。
以上をまとめたものを GitHub で公開しています。
触れていない部分も多々あったりします。Options の Identifier を使ったテンプレートの変数展開とか Options の RequiredOptions キーのこととか...。
Options で Identifier に fileName などと設定します。テンプレートファイル内に ___VARIABLE_fileName___ と記述しておけば、入力された値に置き換えられます。
RequiredOptions キーは、あるオプションが選択されたら利用できるようになるオプションです。NSWindowController が選択されたら、XIB も同時に作るチェックボックスが利用可能になる...といった感じです。
これらのオプションを利用すれば、そこそこ凝ったテンプレートも作れるのではないでしょうか。駆け足でしたが、Xcode 6 でカスタムテンプレートを作る方法でした。
