バージョン管理のインテグレーション

Unity has integrations with two version control systems: Perforce and Plastic SCM. To use the version control integrations in Unity, you need to have either a Perforce or Plastic SCM server set up for your Unity Project.

Unity のバージョン管理の設定

Unity プロジェクトを開き、Edit > Project Settings に移動し、Editor カテゴリを選択します。

Version Control には以下の設定があります。

バージョン管理 の設定を行い、ステータスエリアの横にある Connect ボタンを選択してバージョン管理システムに接続します。Unity がシステムに 接続 すると、ステータスエリアに Connected (接続中) と表示されます。

リビジョン管理ツールを調整するには、 Preferences を開き、 External Tools セクションを選択します。Revision Control Diff/Merge の新しいツールを選択できます。

Unity でバージョン管理を使用

エディターをバージョン管理システムと連動するように設定すると、バージョン管理クライアントではなく、エディターを使用してバージョン管理操作を実行できます。これを行うには、Project ウィンドウでアセットを右クリックします。

バージョン管理の操作は、使用するバージョン管理によって異なります。以下の表は、各バージョン管理で使用可能なアクションを示しています。

ファイルのチェックアウト

Perforce などの一部のバージョン管理システムでは、バージョン管理されたファイルはデフォルトで読み取り専用であり、編集する前にチェックアウトする必要があります (Work offline 設定を有効にしている場合を除く)。エディターからバージョン管理されたアセットを操作すると、ファイル編集を有効にする Check Out ボタンがインスペクターに表示されます。さらに、Project Settings (プロジェクト設定) ウィンドウには、特定のプロジェクト設定をチェックアウトするための Checkout (チェックアウト) ボタンがあります。

読み取り専用アセットに別のカスタム編集ツールの一部を無効にするカスタムエディタースクリプトコードがある場合、またはバージョン管理されたファイルに手動で書き込む場合は、AssetDatabase.IsOpenForEdit とAssetDatabase.MakeEditable API を使用して、ファイルの編集が可能なことを確認し、チェックアウト操作を行います。

バージョン管理のインテグレーションでは、カスタムバージョン管理操作検証ロジックの Provider.PreCheckoutCallback と Provider.PreSubmitCallback の C# コールバックにもアクセス可能です。

Unity は、Save Project 操作を実行するときに、エディターで変更した、または “変更済み” とマークされたアセットをディスクに書き込みます。アセットは必要に応じてバージョン管理でチェックアウトされます。これにより、ファイルに実際の変更が発生しなくても、アセットがチェックアウトされる場合があります。これは、アセットが変更されているかどうかを確認せずに、エディタースクリプトがアセットの EditorUtility.SetDirty を呼び出すときに最も頻繁に発生します。

ノート: Unity がバージョン管理クライアントに変更をコミットできない場合 (例えば、サーバーがダウンしている場合や、ライセンスの問題が発生した場合) は、変更を別の変更セットに保存します。

変更を .scene ファイルに保存すると、Unity はそれを自動的にチェックアウトします。Plastic SCM を使用する場合は、自動的に生成されたライトマップなどのアセットも自動的にチェックアウトされます。

バージョン管理ウィンドウ

バージョン管理ウィンドウを使用して、変更リストのファイルを表示できます。ウィンドウにアクセスするには、 Window > Asset Management > Version Control に移動します。

Outgoing タブには、バージョン管理へまだコミットをしていないすべてのローカルの変更が列挙されます。Incoming タブにはバージョン管理から取得する必要があるすべての変更が列挙されます。

このウィンドウ内でアセットや変更リストを右クリックすると、それらを操作できます。ある変更リストから別の変更リストへアセットを移動するには、アセットをドラッグして移動先の変更リストのヘッダーにドロップしてください。

Icon

エディターは、ファイルとアセットのバージョン管理のステータスを視覚化するために以下のアイコンを表示します。

Icon	説明
	ファイルがローカルで加えられ、バージョン管理への追加は保留中です。
	別のユーザーによってバージョン管理に加えられたファイル。バージョン管理への追加は保留中です。
	ファイルはローカルでチェックアウトされています。
	ファイルが別のユーザーによってリモートでチェックアウトされています。
	このファイルのマージに競合が発生しました。解決する必要があります。
	ファイルはローカルで削除され、バージョン管理での削除は保留中です。
	ファイルは別のユーザーによって削除され、 バージョン管理での削除は保留中です。
	ファイルはまだバージョン管理されていません。Mark Add 操作を使用して、ファイルを手動で加えられます。
	ファイルは自身によってロックされており、他のユーザーは変更できません。
	ファイルは別のユーザーによってロックされており、変更できません。
	別のユーザーがこのファイルの新しいバージョンをチェックインしました。最新バージョンを取得するには、Apply Incoming Changes 操作を使用してください。
	サーバーがこのファイルのバージョン管理ステータスを要求しているか、応答を待っています。これは、Perforce のような集中管理されたバージョン管理システムを使用している場合にのみ表示されます。