UnityプロジェクトでPerforceを扱う方法

「Applibot Advent Calendar 2020」 8日目の記事になります。
前日は @fu11mated さんの
行動ログを吐き出すバッチを作ったら便利だった話 という記事でした!

はじめに

大規模なゲームの開発においては、膨大なリソースを管理する方法についても熟慮する必要があります。リソースをバージョン管理するためのシステムは複数ありますが、私の所属しているプロジェクトではPerforceを選択しています。Perforceの選定理由としてはこちらが参考になると思います。 今回は、このPerforceを用いたUnityでの開発方法について軽くお話しさせていただきたいと思います。Perforceに対する基本的な知識がある前提でお話ししますので、ご了承ください。

クリエイターの作業フローについて

下記はUnityを用いたプロジェクトにおける作業フローを簡単に図示した例になります。

ここでポイントとなるのが、この辺↓です。

この図の場合では、クリエイターはDCCツール（Mayaなど）で作ったアセットをUnityに取り込み、Unity上で諸々の設定をした後でPerforceにサブミットする必要があります。
この作業はUnityとP4V（Perforceを扱うためのGUIツール）で行うことができます。

ここで考えていただきたいのが、クリエイターは大量のアセットを裁くためにこの作業を繰り返し繰り返し行うということです。
つまり、UnityとP4Vをいったり来たりするのでは無駄な作業が大量に発生してしまいます。

そこで、Unityのみでアセットに対する作業からPerforceへのサブミットまで行うことができれば作業を効率化することができます。
しかしここで問題になるのが、Unityに標準搭載されているPerforceを扱うための機能（公式の呼び方ではないのですが仮にP4Unityと呼ぶことにします）にちょっとしたクセがあることです。

P4Unityのクセというのが、「Perforceでプロジェクト全体を管理することを前提としている」ことです。
つまり、ソースコードをGit管理している状況では使えないということです。

かと言って、ソースコードをPerforceで扱うのは得策とは言えません。
と言うよりコードレビューなどできないので実質不可能です。

なのでソースコードはGit管理しつつ、アセットのみPerforce管理にしたいと考えます。
Git管理されているUnityプロジェクトの中のフォルダの一つがPerforceで管理されているという状況が理想です。

それではその状況にするための方法を説明していきます。

UnityでPerforceを扱えるようにするための設定

Unityプロジェクトの中のフォルダの一つがPerforceで管理されている状況にするためにはまずストリームのリマップ設定をする必要があります。ストリームのリマップ設定はP4Vで行います。

1. P4Vで該当ディポのワークスペースを開きます。
2. View→StreamでStreamタブを開きます。
3. 該当ストリームを右クリック → Edit Stream *** を選択します。
4. Advanced → Remappedに ... Assets/[アセットを入れるフォルダの名前]/... を設定します。

これでリマップ設定ができました。

次にワークスペースのルートディレクトリをUnityプロジェクトのルートディレクトリに一致させます。（この作業はUnityでPerforceを扱いたい人それぞれが行う必要があります。）

1. P4Vで該当ディポのワークスペースを開きます。
2. View→WorkspaceでWorkspaceタブを開きます。
3. 該当ワークスペースを右クリック → Edit Workspace *** を選択します。
4. Workspace RootにUnityプロジェクトのルートディレクトリを設定します。

これでUnityプロジェクトの中のフォルダの一つがPerforceで管理されている状況になりました。

最後にUnityでPerforceの設定を行います。

1. Unityで該当プロジェクトを開きます。
2. Edit→Project SettingsでProject Settingsウインドウを開きます。
3. Project Settingsウインドウの左タブからVersion Controlを選択し、ModeでPerforceを選択します。
4. Perforceの設定を入力してRecconectを押します。
5. Connectedと表示されたら完了です。

これでUnity上でPerforceを扱うことができるようになります。

P4Unityの操作方法

ファイルの最新化を行いたい場合の操作は以下のようになります。

1. Projectタブの更新したいディレクトリまたはファイルを右クリック
2. Version Control→Get Latestを選択

このように、P4Unityを導入すると右クリックによって簡単に操作ができるようになります。

まとめ

UnityでPerforceを扱うための方法をご紹介しました。これを読んでいただければ、特に難しくないことがわかるかと思います。導入が難しくてUnityプロジェクトでのPerforceの導入を諦めてた方に、少しでもお役に立てれば幸いです。

おわりに

「Applibot Advent Calendar 2020」 8日目の記事でした！
明日は @kbt_ さんです！