外部マージツール

• Unity のシーンとプレハブは、UnityYAMLMerge (Unity Smart Merge) で
• JSON、YAML、ソースコードは、mergiraf のような構文を理解するツールで
• 手動でマージしたい任意のファイルは、KDiff3 や Meld のようなビジュアルツールで

クイックスタート

仕組み

1. マージ、更新、またはリバートを開始します。
2. Diversion はまずサーバー上でマージできるものをマージします。テキストファイルの異なる部分を両側が変更した場合、Diversion が自動的にマージするため、ツールは実行されません。
3. 残った競合ごとに、Diversion はファイルパスにパターンがマッチする最初のツールを見つけます。ファイルの各バージョンを一時ファイルにダウンロードし、ツールを実行します。デスクトップアプリでは、Resolve with <tool> をクリックしたときに実行されます。CLI では、すべての競合に対して実行されます。
4. すべての競合が解決されたら、マージを完了します。デスクトップアプリでは、Complete merge をクリックします。CLI はマージを自動的に完了します。
5. 一部の競合が解決されなかった場合、マージは開いたままになります。残りは Diversion アプリで解決します。ツールが解決した競合は、解決済みのまま保持されます。

マージツールをセットアップする

dv merge-tool add --name <name> --pattern '<regex>' --cmd '<command>'

dv merge-tool

デスクトップアプリでツールをセットアップする

• コマンドは外側の引用符なしで入力します。CLI で引用符が必要なのはシェルのためだけです。例 のコマンドを使うには、--cmd の値を外側の引用符なしでコピーします。Windows の例では、各 \" も " に変更してください。
• ツールを削除するには、その削除ボタンをクリックします。保存するまでは、元に戻すボタンをクリックしてツールを残せます。
• 行にエラーがある間 (たとえば $RESULT のないコマンド)、Save changes は無効のままです。
• 編集中に誰かが dv merge-tool でツールを変更すると、保存は失敗します。Cancel をクリックしてから、変更をやり直してください。

コマンドプレースホルダー

• --cmd には $RESULT を含める必要があります。
• コマンドはシェルを介さず直接実行されます。パイプ (|)、リダイレクト (>)、環境変数は機能しません。必要な場合は、手順をスクリプトにまとめ、そのスクリプトをコマンドに設定してください。
• スペースを含むプログラムパスは二重引用符で囲んでください。
• Mac と Linux では、--cmd の値全体を単一引用符で囲んでください。そうしないと、Diversion に届く前にシェルが $ANCESTOR などのプレースホルダーを置き換えてしまいます。

ファイルパターン

終了コードとビジュアルツール

• ツールが $RESULT に書き込み、ファイルに競合マーカー (<<<<<<<) がなければ、競合は解決済みです。
• そうでない場合、Diversion は Was the merge successful? [y/n] と確認します。
• CI ジョブなど、確認するターミナルがない場合、競合は未解決のままになります。

例

Unity Smart Merge (UnityYAMLMerge)

dv merge-tool add --name unity-yaml \
  --pattern '\.(unity|prefab|asset|mat|anim|controller)$' \
  --cmd '"/Applications/Unity/Hub/Editor/6000.0.23f1/Unity.app/Contents/Tools/UnityYAMLMerge" merge -p $ANCESTOR $INCOMING $CURRENT $RESULT'

dv merge-tool add --name unity-yaml --pattern "\.(unity|prefab|asset|mat|anim|controller)$" --cmd "\"C:\Program Files\Unity\Hub\Editor\6000.0.23f1\Editor\Data\Tools\UnityYAMLMerge.exe\" merge -p $ANCESTOR $INCOMING $CURRENT $RESULT"

mergiraf (JSON、YAML、コード)

dv merge-tool add --name mergiraf \
  --pattern '\.(json|ya?ml|toml)$' \
  --cmd 'mergiraf merge $ANCESTOR $CURRENT $INCOMING -o $RESULT'

KDiff3

dv merge-tool add --name kdiff3 \
  --pattern '\.(ini|cfg)$' \
  --cmd 'kdiff3 $ANCESTOR $CURRENT $INCOMING -o $RESULT --auto'

Meld

dv merge-tool add --name meld \
  --pattern '\.txt$' \
  --cmd 'meld $CURRENT $ANCESTOR $INCOMING -o $RESULT' \
  --no-trust-exit-code

マージツールで競合を解決する

CLI から

dv merge feature/new-level --conflict_resolution merge-tool
dv update --conflict_resolution merge-tool
dv revert <commit_id> --conflict_resolution merge-tool

merge encountered conflicts, resolving with external merge tools
Resolved 1 conflict(s) with external tools:
  - Assets/Prefabs/Player.prefab (unity-yaml)
Skipped 1 conflict(s), left for manual resolution:
  - Assets/Textures/Hero.psd: no merge tool is configured for this file
Not all conflicts were resolved. Please resolve the rest manually:
https://app.diversion.dev/repo/<repo_id>/merges/<merge_id>

Diversion デスクトップアプリから

• 一度に実行できるツールは 1 つだけです。あるファイルでツールが開いている間、他のファイルのボタンは無効になります。
• Complete merge は、ツールが終了するまで待機します。
• マージ画面でファイルをすでに変更している場合、ツールの結果で置き換える前に Diversion が確認します。続行するには Replace with <tool> をクリックします。
• 終了コードを信頼しないツール (--no-trust-exit-code、または Diversion checks the result) で、マージが成功したかどうかを Diversion が判断できない場合、アプリは Did the merge work? と確認します。結果を保存するには Yes, it merged をクリックします。競合を未解決のままにするには、No をクリックするかダイアログを閉じます。10 分以内に回答しない場合、回答は No になります。
• ツールが競合を未解決のまま残した場合や失敗した場合、ヘッダーに理由とボタンが再び表示されます。ツールを再実行するか、マージ画面でファイルを解決してください。
• ツールの結果を取り消すには、ファイルヘッダーの Revert to conflict をクリックします。ツールを実行するボタンが再び表示されます。
• マージ画面は、開いたときにツールを読み込みます。マージ画面を開いている間にツールを追加した場合は、そのツールを使うためにマージを開き直してください。

マージツールを管理する

dv merge-tool            # ツールをマッチング順に一覧表示
dv merge-tool add ...    # ツールを追加、または同名のツールを更新
dv merge-tool -d <name>  # ツールを削除

トラブルシューティング

関連

• dv merge-tool — マージツールを管理する CLI リファレンス
• 競合 — 競合の種類と解決方法
• ブランチとマージ
• Unity ベストプラクティス