git のサブモジュールを使う

アプリ制作の過程で得た知見を、再利用可能なモジュールとは言わないまでもせめて小さなサンプル形式でいいから GitHub に残していこうと思いました。

そこで、複数のプロジェクトをアップロードするにあたり気になるのは各プロジェクトに入っている cocos2d ディレクトリの重複。

ここの重複を、git のサブモジュールを使って共通の別リポジトリとして括り出すことで無駄を省くことができます。

サブモジュール用リポジトリの作成

まず、サブモジュールとなるリポジトリを作成していきます。

GitHub でリポジトリを作成します。

サブモジュールにする cocos2d ディレクトリを得るため、まずは新規のプロジェクトを作成します。

cocos new -l cpp [プロジェクト名]

cd [プロジェクトディレクトリ内の cocos2d ディレクトリ]

git init
git add .
git commit -m [コミットメッセージ]

git remote add origin git [リポジトリのURL]
git push -u origin master

これでサブモジュールのリポジトリは設定完了です。

新規プロジェクトを作成し、 git リポジトリにするまでは同じです。

まず元々入っている cocos2d ディレクトリを削除します。

cd [プロジェクトのディレクトリ]
rm -rf ./cocos2d

git submodule add [サブモジュールのリポジトリURL] cocos2d

これで cocos2d がサブモジュールのリポジトリから clone されます。

git clone [プロジェクトのリポジトリURL]

clone してくると、サブモジュールはディレクトリのみで中身が空になっていますので初期化と更新を行います。

git submodule update -i

submodule の master 以外のブランチやタグを使う場合は、サブモジュールのディレクトリで git 操作(checkout等) を行い、外に出て(元の利用側プロジェクトで) git add すると、変更が記録されます。

cocos2d-x の新しいバージョンがリリースされたら、新規プロジェクトを作成して中のcocos2dをサブモジュールディレクトリに上書きすれば利用側のプロジェクトでもサクっとバージョンアップ対応できます（cocos2d ディレクトリ以外も変更がある可能性があるのでそこは注意してください）。