更新するサブモジュールを指定して、サブモジュールを更新する
デフォルトでは、すべての「サブモジュール」が更新対象になります。更新対象の「サブモジュール」を指定し、特定の「サブモジュール」のみ更新対象にできます。
更新対象の「サブモジュール」の指定は、「サブモジュール」の「ワーキングディレクトリー」のパスで指定します。
ワーキングディレクトリーの明示について
オプションの記述方法によっては、「ワーキングディレクトリー」の指定が、別のオプションの指定として解釈されることがあります。このような状況では、「ワーキングディレクトリー」の前に「 -- 」を記述します。
例えば、以下のような記述になります。
git submodule update --checkout -- mySubProject
複数のワーキングディレクトリーを指定できる
複数の「ワーキングディレクトリー」を指定できます。各「ワーキングディレクトリー」のパスは、スペースで区切ります。
例えば、以下のような記述になります。
git submodule update --checkout mySubProject mySubProject2
パスにスペースが含まれる場合
「ワーキングディレクトリー」のパスにスペースが含まれる場合は、パスを「'」で括ります。例えば、以下のような記述になります。
git submodule update --checkout 'my SubProject/my TestProject'
ワイルドカードによるワーキングディレクトリーの指定も可能
ワイルドカードを利用して、条件に合う「ワーキングディレクトリー」を指定することも可能です。利用できるワイルドカードは、「ワイルドカードを利用して、ステージングエリアにファイルを追加する(git add)」を参考にしてください。
コマンドの実行例
コマンドの実行例です。1.サブモジュールの状態
まず、「サブモジュール」の状態を見てみます。以下のように、「サブモジュール」が2つ配置されています。
2.コマンドの実行
ここでは例として、「mySubProject」サブモジュールのみをチェックアウトします。「端末」から、以下のコマンドを実行します。
コマンドの詳細は、「サブモジュールを更新するコマンドの説明」を参考にしてください。
ポイントは、赤字の箇所です。
git submodule update --force --checkout mySubProject