Diversion と Unity のベストプラクティス

​

はじめに

​

前提条件

• Diversion をインストールし、サインインしていること（クイックスタート を参照）
• Unity Hub と Unity Editor がインストールされていること
• Unity プロジェクトが作成済み、またはインポートできる状態であること

​

初期セットアップ

1

Unity のバージョン管理設定を構成する

Unity プロジェクトを開き、Edit > Project Settings に移動します:

• Version Control Mode を Visible Meta Files に設定
• Asset Serialization Mode を Force Text に設定

これらの設定により、Unity のメタファイルが Diversion から見えるようになり、アセットがテキスト形式で保存されて競合の解決が容易になります。

2

.dvignore の構成を確認する

注意

Diversion は Unity プロジェクトを初期化する際に、Unity 固有のパターンを含む .dvignore ファイルを自動的に作成します。通常は変更する必要はありません。

Unity プロジェクト用のデフォルトの .dvignore には、次のような一般的なパターンが含まれます:

# Unity generated folders
.utmp/
/[Ll]ibrary/
/[Tt]emp/
/[Oo]bj/
/[Bb]uild/
/[Bb]uilds/
/[Ll]ogs/
/[Uu]ser[Ss]ettings/
/[Mm]emoryCaptures/
/[Rr]ecordings/

# Autogenerated Jetbrains Rider plugin
/[Aa]ssets/Plugins/Editor/JetBrains*
*.DotSettings.user

# Visual Studio cache
.vs/

# Gradle cache directory
.gradle/

# Autogenerated VS/MD/Consulo solution and project files
ExportedObj/
.consulo/
*.csproj
*.unityproj
*.sln
*.suo
*.tmp
*.user
*.userprefs
*.pidb
*.booproj
*.svd
*.pdb
*.mdb
*.opendb
*.VC.db

# Unity3D generated meta files
*.pidb.meta
*.pdb.meta
*.mdb.meta

# Unity3D crash reports
sysinfo.txt
mono_crash.*

# Builds
*.apk
*.aab
*.unitypackage
*.unitypackage.meta
*.app

# Crashlytics generated
crashlytics-build.properties

# Addressables
/ServerData/
/[Aa]ssets/[Aa]ddressable[Aa]ssets[Dd]ata/*/*.bin*
/[Aa]ssets/AddressableAssetsData/link.xml*
/[Aa]ssets/Addressables_Temp*
/[Aa]ssets/[Ss]treamingAssets/aa.meta
/[Aa]ssets/[Ss]treamingAssets/aa/*

# Visual Scripting generated files
/[Aa]ssets/Unity.VisualScripting.Generated/

# Test scenes (Unity Test Framework)
/[Aa]ssets/[Ii]nit[Tt]est[Ss]cene*.unity*

必要に応じてプロジェクト固有のパターンを追加できますが、デフォルトでほとんどの Unity のユースケースをカバーしています。

3

Diversion リポジトリを初期化する

Diversion デスクトップアプリを開き、Unity プロジェクトフォルダーから新しいリポジトリを作成するか、CLI で初期化します:

cd /path/to/your/unity/project
dv init

Diversion は Unity プロジェクトの構造を自動的に認識し、適切な .dvignore パターンを含めて必要なファイルの追跡を開始します。

リポジトリ作成の詳細な手順については、クイックスタートガイド または Diversion を使い始める を参照してください。

4

最初のコミットを行う

初期化後、Unity プロジェクトをコミットします:

dv commit -m "Initial Unity project setup"

覚えておいてください: Diversion では、このコマンド 1 つですべてを処理します。add、commit、push を個別に実行する必要はありません！

コミットや Diversion の自動同期ワークフローについては、変更をどう扱うか で詳しく解説しています。

​

Unity と Diversion の必須ワークフロー

​

メタファイルの管理

• GUID（グローバルに一意な識別子）: アセット参照に使用
• インポート設定と構成
• プラットフォーム固有の設定

• 新しいアセットを追加する際は、アセットとその .meta ファイルの両方を一緒にコミットしてください
• スクリプト参照の欠落や壊れたプレハブが見られる場合は、メタファイルが正しく同期されているか確認してください
• Unity 以外でメタファイルを手動で編集・削除しないでください

​

ファイル操作

• すべての内部参照を自動的に更新
• メタファイル内の GUID 接続を維持
• プロジェクトの整合性を保つ

1. Unity Editor を開く
2. Project ウィンドウでアセットの名前変更・移動・削除を行う
3. プロジェクトを保存する（Ctrl+S または Cmd+S）
4. Diversion で変更をコミットする

​

シーン管理と競合防止

​

Diversion の競合防止機能を活用する

1

潜在的な競合を確認する

シーンを編集する前に、Diversion デスクトップアプリを開いて、ファイルツリーに 感嘆符アイコン（!）がないか確認してください。これは、他の誰かが同じファイルを現在編集中の場合に警告してくれます。

2

チームと連絡を取る

潜在的な競合の警告が表示された場合は、変更を加える前にチームメイトと調整してください。Diversion のリアルタイム通知により、互いの作業を妨げるのを避けやすくなります。

​

シーン整理のベストプラクティス

// Load scenes additively at runtime
SceneManager.LoadSceneAsync("Environment", LoadSceneMode.Additive);
SceneManager.LoadSceneAsync("Lighting", LoadSceneMode.Additive);
SceneManager.LoadSceneAsync("Gameplay", LoadSceneMode.Additive);

​

日々のワークフローのベストプラクティス

​

1. 一日を正しく始める

• 前回のセッションから未コミットの変更がないか確認する
• 編集予定のファイルに感嘆符（!）が付いていないか（潜在的な競合）を確認する
• コミット履歴でチームの最近のコミットを確認する

# または CLI でワークスペースの状態を確認する
dv status

​

2. 頻繁にコミットする

• 新しい機能を作成した後: 新しいスクリプト、プレハブ、マテリアル
• シーンの変更後: レベルデザインの更新やライティングの調整
• タスクを切り替える前: 作業を整理し、追跡可能に保つ
• 一日の終わり: 未コミットの変更を翌日に持ち越さない

​

3. 意味のあるコミットメッセージを書く

• “Add player jump mechanic with double-jump support”
• “Update level 3 lighting and post-processing”
• “Fix enemy AI pathfinding in narrow corridors”

• “Updated stuff”
• “Bug fix”
• “WIP”

​

4. 大きなアセットを扱う

• より高品質なアセットを使用: 圧縮版と一緒に非圧縮のソースファイルも保持
• 複数のテクスチャ解像度を保存: ファイルサイズを気にせず 4K/8K のテクスチャを維持
• 非圧縮の音声を含める: WAV/FLAC のマスターと、異なるプラットフォーム向けの圧縮フォーマットを両方保存
• 包括的なアトラスを作成: VCS の制約なしに、より大きく効率的なテクスチャアトラスを構築
• バイナリファイルを自由にバージョン管理: PSD、FBX などの大きなアセットもコードと同じくらい効率的に扱える

​

チームでのコラボレーション

​

ブランチ戦略

dv branch create feature/new-inventory-system

​

よくある問題と解決策

​

スクリプト参照の欠落

1. スクリプトの .meta ファイルがコミットされているか確認する
2. メタファイル内の GUID がプレハブの参照と一致するか確認する
3. 欠落している場合は、元の作成者にメタファイルをコミットしてもらう

​

プレハブの接続が壊れる

1. Unity 以外でプレハブファイルを変更しない
2. すべてのプレハブ編集はプレハブモードで行う
3. 壊れた場合はプレハブを元に戻し、Unity から変更を再適用する

​

シーンの競合

1. Diversion の潜在的競合警告を活用して事前に回避する
2. 発生した場合は連携して手動で変更をマージする
3. シーンをより小さなサブシーンに分割することを検討する

​

ベストプラクティスのまとめ

​

トラブルシューティング

1. Unity プロジェクトの設定（Visible Meta Files、Force Text シリアライズ）
2. .dvignore ファイルが正しく構成されているか
3. すべてのチームメンバーが同じ Unity バージョンを使っているか
4. メタファイルが追跡・コミットされているか