サブモジュール名を指定して、サブモジュールを追加する
サブモジュール名を指定して、「サブモジュール」を追加します。デフォルトでは、リポジトリーのURIを元に自動的にサブモジュール名が決定されます。
ユーザーがサブモジュール名を指定するとこも可能です。
サブモジュール名
サブモジュール名は、「サブモジュール」を識別する名称です。サブモジュール名はフォルダー名にも使用されるため、フォルダーで使用できない文字をサブモジュール名に使用することはできません。
コマンドの実行例
コマンドの実行例です。1.コマンドの実行
コマンドのオプションは、以下のオプションを指定します。| オプション |
|---|
| --name |
「端末」から、以下のコマンドを実行します。
コマンドの詳細は、「サブモジュールを追加するコマンドの説明」を参考にしてください。
ポイントは、赤字の箇所です。
git submodule add --name otherSubModule git://192.168.56.1/mySubProject
2.コマンドの実行結果
以下のように「サブモジュール」が追加され、「サブモジュール」のクローン及びチェックアウトが実行されます。
3.サブモジュールの状態
「スーパープロジェクト」から「サブモジュール」の状態を確認すると、以下のようになります。
「サブモジュール」の「HEAD」が指す「コミットオブジェクト」と、現在のブランチが表示されます。
4.ワーキングディレクトリーの状態
「スーパープロジェクト」の「ワーキングディレクトリー」の状態を見てみます。
サブモジュールの「ワーキングディレクトリー」である「mySubProject」フォルダーと「.gitmodules」ファイルが「ステージングエリア」に追加されています。
5.スーパープロジェクトのワーキングディレクトリーの確認
「スーパープロジェクト」の「ワーキングディレクトリー」を見てみます。以下のように、「mySubProject」フォルダーと「.gitmodules」ファイルが追加されています。
6.gitmodulesファイル
「スーパープロジェクト」の「ワーキングディレクトリー」内にある「.gitmodules」ファイルの中身を見てみると、「submodule」セクションにオプションで指定したモジュール名が反映されています。
7.サブモジュールのワーキングディレクトリーの確認
「サブモジュール」の「ワーキングディレクトリー」を見てみます。以下のように、「サブモジュール」からチェックアウトされたプロジェクトのファイル群と、「.git」ファイルが配置されています。
8.gitファイル
「.git」ファイルの中身を見てみると、以下のように「サブモジュール」の「Gitディレクトリー」の配置場所が記述されています。
オプションで指定したモジュール名が、フォルダー名に反映されています。
9.サブモジュールのGitディレクトリー
「サブモジュール」の「Gitディレクトリー」は、「8.」で指定されたパスに存在します。
