Skip to main content
このガイドでは、Unreal Engine プロジェクトを Perforce から Diversion に移行する方法について、機能比較と段階的な移行プロセスを含めて説明します。

移行を検討する理由

Diversion は Perforce と同じ中核的なバージョン管理機能を、いくつかの重要な改善とともに提供します:
  • インストールサイズが小さい(クライアント側、サーバーのセットアップは不要)
  • コミット 速度が大幅に高速
    (Diversion はバックグラウンドで継続的にアップロードします。コミットとは、履歴にスナップショットを保存する瞬間のことです)
  • 必須のワークフローに焦点を当てたシンプルな UI
  • アーティストや非技術系のチームメンバーにとって優れたユーザー体験

機能比較

ソフトロック vs. ハードロック

Diversion は、ファイルが編集中であることを自動的に示します(ソフトロック)— 明示的に編集権を取得する必要はありません。 ブロックされることはありません:プロンプトから編集を確認して先に進むことができます。 チームメイトのバージョンがコミットされていた場合、それを自分のブランチにマージできます(同じブランチで競合がなければ自動マージ)。 一部のチームではハードロックが必要な場合があります。排他的なファイルロックの構成の詳細は ハードロック をご覧ください。 なぜ重要か:
Perforce では、ファイルの編集権を明示的に取得する(チェックアウトする)必要があります。他の誰かがロックしていて解除できない場合(休暇、病気など)、デッドロック状態になります。
Diversion では、バックエンドが自動的かつ暗黙的にアクティブな編集を示し、作業をブロックしません。
実際どうなるか: 2 人が同じファイルを同時に編集でき、差分は事前に防がれるのではなく後から解消されます。このシナリオを段階的に追った説明 — 誰に何がいつ見えるのか、いつ競合が発生するのか、どのように解決するのか — は ソフトロック を参照してください。

移行オプション

Perforce のプロジェクトを Diversion に移行する方法は 2 つあります。どちらもダッシュボードから始めます (左上の Diversion ロゴをクリックします)。 オプション 1: P4 からのインポート – 完全な Perforce の履歴を引き継ぎます。ダッシュボードで Import from Perforce を選択します。表示されていない場合は、右上の New repository をクリックし、Import from P4 を選択します。その後、Perforce からのインポートの手順に従います。インポートの代行をご希望の場合は、そのページ下部の Request a managed import を選択してください。+S 保持ルールは Diversion の リビジョン制限 として引き継げます。 オプション 2: 新しいリポジトリを作成 – 履歴なしで一からスタートします。セットアップが早いため、すぐに作業を始められます。 このガイドでは、オプション 2 を使用します:
1

Perforce プロジェクトフォルダーからリポジトリを作成する

ダッシュボードで Create a repository を選択します。表示されていない場合は、右上の New repository をクリックし、Create New Repository を選択します。Create from Existing Folder を選択して Browse… をクリックし、Perforce で使用していたプロジェクトのルートフォルダーを選択します。Unreal プロジェクトの場合は、.uproject ファイルがあるフォルダーです。Create をクリックします。ダイアログ全体については プロジェクトで Diversion を使い始める を参照してください。Unreal、Godot、Unity を使用している場合、Diversion は .dvignore ファイルを自動的にセットアップし、エンジンによって一時的に生成または再構築されるフォルダーをスキップします。
2

チームを招待する

リポジトリの … メニューを開き、Collaborators を選択します。チームメイトのメールアドレスを入力し、アクセスレベルを選択して Send invite をクリックします。プロジェクトへのアクセスを管理する を参照してください。
3

最初のコミットを行う

リポジトリを開きます。コミットするファイルを選択し、コミットメッセージを入力して Commit をクリックします。変更をコミットする を参照してください。

既存の Perforce ワークスペースから始める

Perforce は、ファイルをチェックアウトするまで読み取り専用にしておきます。Perforce が管理していたフォルダーから Diversion ワークスペースを作成すると、それらのファイルは読み取り専用のまま残ります。Diversion はチームメイトの変更を読み取り専用のファイルに同期できず、Unreal Engine はそれらのファイルをチェックアウト済みとして扱います。このように同期がブロックされると、Diversion は次のように報告します:
これを解消するには、プロジェクト内のすべてのファイルとフォルダーの読み取り専用フラグを解除します:
エクスプローラーでプロジェクトフォルダーを右クリックし、Properties を選択します。Read-only のチェックを外して Apply をクリックし、Apply changes to this folder, subfolders and files を選択します。または、プロジェクトフォルダーで次を実行します:
フォルダーを Diversion に移行したら、そのフォルダーを Perforce で使用するのはやめてください。Perforce で同期するたびに、ファイルは再び読み取り専用になります。Perforce ワークスペースが引き続き必要な場合は、フォルダーのコピーから Diversion ワークスペースを作成してください。

コミット時間

Diversion では、ワークスペースは継続的にクラウドと同期されます。コミット とは、履歴にスナップショットを保存することを選ぶ瞬間のことです。ファイルはすでにアップロードされているため、大規模な Unreal Engine プロジェクトでもコミットは高速です。 最初のコミットが完了すると、プロジェクトはローカルマシンとクラウドの両方に存在し、共同作業の準備が整います。

Unreal Engine 連携

Unreal エディター内で Diversion を使用するには、Fab で Diversion プラグインをライブラリに追加し、Epic Games Launcher からエンジンにインストールして、リビジョン管理プロバイダーとして Diversion を選択します。各手順は Unreal Engine プラグイン で説明しています。

Unreal Engine での Perforce の操作

Perforce で使用していたリビジョン管理操作のほとんどは、エディター内の同じ場所にあります。Content Browser でアセットを右クリックし、Revision Control を開きます:

保留中の変更を確認してコミットする

エディター下部のステータスバーの右端にある Revision Control をクリックし、View Changes を選択します。View Changes ウィンドウには、Workspace Changes 変更リストの下にすべての変更済みアセットが一覧表示されます。アセットをダブルクリックすると、Content Browser 内でその場所が表示されます。 Workspace Changes 変更リストからは、説明の編集、検証、コミットができます。コミットするときは、Commit Message を入力して Commit をクリックします。説明を保存して後でコミットする場合は、代わりに Save をクリックします。 View Changes を開かずにコミットするには、ステータスバーの Revision Control をクリックし、Commit Changes を選択します。