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

Unity には 2 つのバージョン管理システムが統合されています。Perforce と Plastic SCM です。Unity で バージョン管理のインテグレーションを使用するには、Unity プロジェクトに Perforce または Plastic SCM サーバーを設定する必要があります。

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

Example**Workspace**1

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

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

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

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

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

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

バージョン管理のインテグレーションでは、カスタムバージョン管理の操作検証ロジックとして、Provider.PreCheckoutCallback C# コールバックおよび Provider.PreSubmitCallback C# コールバックも公開されます。

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

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

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

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

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

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

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