Unreal Editor 内のソース コントロール

UE4 内からソフトウェアとインターフェースする方法は、どのソース コントロール ソフトウェアでも同じです。以下では、UE4 内でのソース コントロールの使用について知っておくべき ことを詳しく説明します。

Unreal Editor 内でのコラボレーション ワークフロー

Unreal Engine 4 では、プロジェクトで複数ユーザーが非常に簡単にコラボレーションできます。以下のセクションでは、Unreal Editor 内で様々なコラボレーション ツールがどのように機能するかについて説明します。

Unreal Editor でファイルをチェックアウトする

共同作業者とコンテンツを共有する主な方法は、 コンテンツ ブラウザ を使用するやり方です。すべてのソース コントロール操作はファイルやフォルダのコンテキスト メニューから利用できます。 例えば、ファイルを チェックアウト (すなわち編集のためにロック) するには、コンテンツ ブラウザ でアセット上で 右クリック し、チェックアウト オプションを選択します。

保存時にファイルを自動的にチェックアウトするようにエディタを設定できます。これは、[Prompt for Checkout on Asset Modification (アセット変更時にチェックアウトするかを確認する)] を有効にして行います。 以下の順序、Editor Preferences -> Loading & Saving -> Source Control に従いこうしたオプションを利用できます。

エディタ内で初めてファイルを保存したときにそれを自動的にソース コントロールに追加するように Unreal Editor を設定することもできます。以下の順序、 [Editor Preferences] -> [Loading & Saving] -> [Source Control] に従いこうしたオプションを利用できます。これを行うには、デフォルトでオンになっている [Add New Files when Modified (変更時に新しいファイルを追加)] オプションを有効にするだけです。 アセットの編集を開始するとファイルのチェックアウトを求める通知が画面の右下隅に提示されます

これで編集前にアセットをチェックアウトできるようになります。[Check Out (チェックアウト)] をクリックすると、次のダイアログが表示されます。

コンテンツブラウザ でオブジェクトを 右クリック し、ソース コントロール オプションに進むと現在のアセットの状態を示す様々な記号が表示されているのがわかります。

ソース コントロールにサブミットする

ソース コントロールに何もサブミットしないと作業内容、成果物が他のユーザーから見えないため、 UE4 内のソース コントロールへのサブミットはソース コントロール プロセスの重要な部分です。多くの変更を伴う作業をする場合、または加えた変更を詳しくは追跡しない場合、以下のワークフローが便利です。 エディタの [ファイル] メニューから [Submit to Source Control (ソース コントロールにサブミット)] オプションを選択します。

これで、アセットに加えられたサブミット可能な変更があるかについてプロジェクトとエンジンがスキャンされ、続いて Submit Files ダイアログが表示されます。

変更内容を入力し、OK をクリックします。次にソース コントロールにファイルをコミット/サブミットします。

ファイルを同期する

他の人が加えた変更を取得したい場合、コンテンツ ブラウザ 内のファイルまたはフォルダを 右クリック して [Sync] オプションを選択します。 または、Perforce (P4V) などの外部プログラムを使用して Sync することもできます。しかし、これを行う場合はエディタをシャットダウンすることをお勧めします。開いていると編集できないようにファイルをロックする場合があるからです。

ファイルが Out of Sync (同期していない) (すなわち、ローカルにあるものよりも新しいバージョンがソース コントロール サーバーにある) の場合、 アイコンが コンテンツ ブラウザ のアセットによって表示されます。

ファイルを追加する

チェックアウトのワークフローと同様に、[preferences] にある [Add New Files When Modified (変更があったら新規ファイルを追加)] オプションを使用して新規ファイルをソース コントロールに自動的に追加することができます。

追加されたファイルは 記号が付けられて コンテンツ ブラウザ に表示されます。また、ファイルがチェックアウトされるのと同様にチェックインされます。

ファイルを削除する

既にソース コントロールにあるアセットを削除するのは手間がかかります。通常、他のアセットから参照されているからです。 コンテンツ ブラウザ でファイルを選択し、[Delete (削除)] (または 右クリック メニューから選択したら)、[Delete Assets] ダイアログが表示されます。

削除の処理方法を選択したら、ファイルは リダイレクタ という非表示の アセット で置き換えられます。アセット削除時に作成される リダイレクタ をクリーンアップしたい場合は、 コンテンツブラウザ にある フォルダ 上で右クリックし、[Fix Up Redirectors in Folders] を選択します。これでプロジェクト内の参照が修正され、 リダイレクタを永久に削除し、ソース コントロールで削除のためにファイルをマーク付けします。現在、こうした削除をコミットするには、P4V または TortoiseSVN などの外部ツールを使用する必要があります。

レベルのファイル

レベルは他のアセットのように コンテンツ ブラウザ を介してソース コントロールで管理することができます。しかし、レベルは レベル ブラウザ のメニューを介して作業することもできます。 これには、ソース コントロール のサブメニューにあるソース コントロールのオプションも含まれます。

Config (.ini) ファイル

エディタとプロジェクトの多くのコンフィギュレーション オプションはコンフィギュレーションファイル、短縮すると config ファイルに格納されています。こうしたファイルの一部はソース コントロール下で維持する必要があります (ソース コントロールに Config/ ディレクトリを追加する場合は上記を参照)。 エディタにある設定には、チームのメンバーが様々な設定を共有できるように、これらをチェックイン、チェックアウトする方法があります。例えば、[Edit] -> [Project Settings] では、以下のインジケータがあります。

ファイルをチェックアウトすると、こうした設定を編集できます。残念ながら現時点ではこうしたファイルをエディタからソース コントロールに戻してチェックインする方法はありません。 そのため、 P4V や TortoiseSVN などの外部ツールを使用して Unreal Editor セッション外にこうしたファイルをチェックインする必要があります。