UVCS integration
MergeSight を Unity Version Control と連携する
MergeSight は Unity Version Control の changeset と merge conflict に Unity 固有の文脈を追加します。生の YAML 行ではなく、GameObject、component、hierarchy、reference、prefab override を確認してから結果を書き込みます。
MergeSight が対応する UVCS workflow
通常のレビューでは、具体的な UVCS changeset または現在の workspace を読み込み、選択した revision 間を比較します。Conflict review では、同じ競合から取得した Base、Ours、Theirs の3つの完全な入力が必要です。UVCS は引き続き履歴と workspace の source of truth であり、MergeSight は意味ベースの確認と安全な書き込みを担当します。
- Changeset review: 2つの revision の差を Unity object として読む。
- Workspace review: check-in や merge 前にローカル変更を確認する。
- Conflict resolution: Base/Ours/Theirs を分類し、preview と validation を実行する。
Unity changeset を意味ベースで比較する
Text diff は YAML のどの行が変わったかを示しますが、その変更が GameObject の移動、component の削除、reference の差し替え、prefab override の更新なのかは説明しません。MergeSight は変更を Unity の構造に対応付け、GUID と fileID も reference context として表示します。
比較には具体的な changeset ID を使ってください。レビューを再現でき、チームと CI が同じ revision を検証できます。
直接読み込みと external merge wrapper
UVCS client が Base、Ours、Theirs の完全なファイルを提供できる場合は、3つを MergeSight で直接開けます。External merge command を要求する構成では、wrapper が一時ファイルと結果パスを MergeSight に渡します。
この2つは代替経路であり、二段階の merge ではありません。異なる workspace 状態から手作業で入力を集めず、同じ conflict 由来の3ファイルを使うことが重要です。
5ステップで設定する
- Unity で Force Text serialization と Visible Meta Files を有効にする。
- UVCS CLI をインストールし、
cm statusで workspace を確認する。 - Unity の Tools > MergeSight > VCS Integration Setup を開く。
- Unity Version Control を検出し、review と merge workflow を設定する。
- テスト用 changeset と意図的な scene conflict で revision、preview、validation を確認する。
要件と安全上の境界
| 対象 | 要件 | 動作 |
|---|---|---|
| Asset | Text serialized の .unity、.prefab、.asset、.mat | Unity-aware review |
| UVCS | 有効な workspace と利用可能な cm CLI | changeset と revision を UVCS から取得 |
| Merge | 完全な Base/Ours/Theirs | 曖昧または不足した入力を推測しない |
| Apply | blocking decision が解決済み | 書き込み前後に preview、backup、validation |
MergeSight は UVCS や Smart Locks を置き換えません。Lock を越えて並行変更が発生し、実際に内容を統合する必要がある場面を補完します。
よくある質問
MergeSight は Unity Version Control を直接サポートしますか？
はい。Unity Version Control / Plastic SCM workspace を検出し、changeset review と完全な Base/Ours/Theirs を使う 3-way workflow を利用できます。ローカルに UVCS CLI が必要です。
MergeSight は UVCS merge client を置き換えますか？
いいえ。UVCS は workspace、branch、changeset、lock を管理し続けます。MergeSight は conflict review に Unity-aware context、preview、validation を追加します。
2つの UVCS changeset で Unity scene を比較できますか？
はい。具体的な changeset ID を選ぶと、GameObject、component、hierarchy、property、reference の変更として再現可能に比較できます。
Smart Locks と一緒に使えますか？
はい。Smart Locks は選択した asset の並行編集を防ぎ、MergeSight は lock の対象外や例外で発生した変更の review と conflict resolution を支援します。
Conflict はすべて自動解決されますか？
いいえ。Engine が安全と判定した decision だけを自動適用できます。曖昧な mapping や危険な構造変更は明示的な確認が終わるまで書き込みを止めます。
まとめ
UVCS が source of truth
MergeSight は既存の changeset、branch、lock workflow に Unity-aware review を追加します。
具体的な revision を使う
Changeset ID を固定すると、チームと CI が同じ比較を再現できます。
書き込み前に確認する
Base/Ours/Theirs、preview、backup、validation で静かな asset 破損を防ぎます。