前提条件
プラグインを使用する前に、以下を用意してください:- Unity 6（6000.0.0f1）以降
- Diversion デスクトップアプリ がインストールされ、実行中で、サインイン済み（クイックスタート）
- Unity プロジェクトが Diversion リポジトリとして初期化されていること（デスクトップアプリまたは CLI で）
インストール
オープンベータ
Unity プラグインは現在オープンベータ版です。
こちら から入手できます。これは初期リリースであり、皆さまのフィードバックはプラグイン改善の助けとなります。
正式リリースに向けて、このページは随時更新します。Discord サーバー に参加して、早期アクセスの取得、フィードバックの提供、コミュニティとの交流をお楽しみください。
1
プラグインをダウンロードする
Discord に記載されたリンクからプラグインパッケージをダウンロードします。
2
Package Manager を開く
Unity で
Window > Package Management > Package Manager に移動します。3
tarball からパッケージを追加する
左上の
+ ボタンをクリックし、Add package from tarball... を選択します。ダウンロードしたファイルの場所に移動して選択します。4
インストールを待つ
Unity がプラグインを自動的にインストールします。
設定
プラグインをインストールしたら、バージョン管理プロバイダーとして Diversion を使うように設定します。1
Version Control 設定を開く
Edit > Project Settings > Version Control に移動します。2
プロバイダーとして Diversion を選択する
Mode ドロップダウンから Diversion を選択します。3
接続を確認する
Version Control の下にある
Diversion セクションを展開して、Diversion 設定パネルを表示します。接続状態が表示されます:- Connected - 使用可能
- Agent Not Running - Diversion デスクトップアプリを起動してください
- Not a Workspace - デスクトップアプリまたは CLI でプロジェクトを Diversion リポジトリとして初期化してください
Diversion ウィンドウ
Window > Diversion からメインの Diversion ウィンドウにアクセスします。これはバージョン管理操作の中心となる場所です。
ヘッダーバー
ヘッダーには以下が表示されます:- Branch - アクティブなブランチ名
- Status - 同期状態（Synced、Syncing、または Paused）
- Refresh ボタン - 接続とファイルステータスを手動で更新
- Settings ボタン - Version Control 設定を開く
変更リスト
Changes セクションには、ワークスペース内の変更されたすべてのファイルが表示されます:- Select All トグル - すべてのファイルを素早く選択・解除
- File count - 変更されたファイルの総数
- View in Desktop - Diversion デスクトップを開いて詳細な差分を表示
- Reset All - 未コミットの変更をすべて破棄
コミットパネル
ウィンドウの下部:- Commit Message - 変更内容の説明を入力
- Reset Selected - 選択されたファイルのみ変更を破棄
- Commit - 選択されたファイルを入力したメッセージでコミット
ファイルステータスアイコン
Diversion ウィンドウと Project ウィンドウの両方で、ファイルにステータスアイコンが表示されます:- 緑の丸（+） - 追加されたファイル
- オレンジの丸 - 変更されたファイル
- 赤の丸（-） - 削除されたファイル
- 黄色の丸（!） - 他のユーザーの変更との潜在的な競合
競合防止
Diversion は、チームメイトが同じファイルを編集している場合に警告を出すことで、マージ競合の防止を支援します。ファイルを開く
他のチームメンバーが現在編集中のアセットをダブルクリックで開こうとすると、次の情報を含む警告ダイアログが表示されます:- 誰がそのファイルを編集しているか
- どのブランチで作業しているか
- 最後に変更したのはいつか
ファイルを保存する
潜在的な競合のあるファイルを保存する際は、次の 3 つのオプションを含むダイアログが表示されます:- Save Anyway - 競合に関係なくすべてのファイルを保存
- Cancel - どのファイルも保存しない
- Skip Conflicted - 競合のないファイルのみ保存
警告を無効にする
競合警告を表示したくない場合は、設定で無効にできます:Edit > Project Settings > Version Controlに移動するDiversionセクションを展開する- Show Conflict Warnings のチェックを外す
注意
警告を無効にしても、他のユーザーが編集中のファイルを識別できるよう、Project ウィンドウには黄色の競合アイコン（!）が引き続き表示されます。
自動リロードの動作
外部の変更（ブランチの切り替え、デスクトップアプリからのファイルリセット、チームメイトからの受信コミットなど）を検出すると、プラグインは自動的に Unity の Asset Database を更新し、開いているシーンを再読み込みします。 これにより、手動で操作しなくても、Unity Editor は最新のファイルと常に同期された状態に保たれます。注意
シーンに未保存の変更がある場合、Unity はリロード前に保存を促します。未保存の作業が失われることはありません。
Play モードの同期
プラグインは、Play モードに入るときに自動的に同期を一時停止し、終了時に再開します。これにより、テストセッション中にチームメイトからのファイル変更で作業が妨げられるのを防ぎます。 Play モードを終了すると同期は自動的に再開され、一時停止中に届いた変更が適用されます。設定
Edit > Project Settings > Version Control > Diversion からプラグインを設定できます。
クイックアクション
設定パネルには、よく使う操作のためのボタンもあります:- Open Diversion Window - メインのプラグインウィンドウを開く
- Open Diversion Desktop - Diversion デスクトップアプリを起動する
- Refresh Connection - エージェント接続を手動で更新する
- Documentation - このドキュメントを開く
トラブルシューティング
Agent Not Running
問題: プラグインが “Agent Not Running” ステータスを表示する。 解決策:- Diversion デスクトップアプリを起動する
- ログインしていることを確認する
- プラグイン設定の Refresh Connection をクリックする
Not a Workspace
問題: プラグインが “Not a Workspace” ステータスを表示する。 解決策:- Diversion デスクトップアプリを開く
- Unity プロジェクトフォルダーから新しいリポジトリを作成するか、既存のリポジトリをクローンする
- プラグインが自動的にワークスペースを検出する
変更リストにファイルが表示されない
問題: 変更されたファイルが Diversion ウィンドウに表示されない。 解決策:- ファイルが保存されていることを確認する（
Ctrl+S/Cmd+S） - Diversion ウィンドウの Refresh ボタンをクリックする
.dvignoreファイルによって除外されていないか確認する
外部の変更後にシーンがリロードされない
問題: チームメイトの変更が届いても Unity がシーンをリロードしない。 解決策:- 設定で Auto-Reload Scenes が有効になっているか確認する
- 未保存の変更がある場合、Unity は先に保存されるのを待ちます
- Refresh Connection を手動でクリックしてみる