Unreal Diff ツール

Unreal Engine での UE Diff ツールの使用に関する概要

複雑な大きいファイルの場合は、手動でバグをトラックして機能を分析することが難しいことがあります。通常、diff ファイルは原文に基づいたテキストベースのファイルです。しかし、アセットブループリント の場合、原文に基づく表現は構造的にはなりません。当社が UE Diff ツールを開発したのはこのためです。 UE Diff ツールでは Unreal Engine 内のアセットを比較します。次の処理をサポートしています。

  • アセットをソース コントロールからの以前のバージョンと比較する。

  • 2 つの異なるアセットを比較する。

Overview.png

アセットまたは 2 つの異なるアセットをディフ (diff) する際は 2 つのファイルが比較され、見つけやすいように、2 つのファイル間の違いがそれぞれ強調表示されます。

すべてのアセット タイプがサポートされているわけではなく、現時点では次のタイプがサポートされています。

  • ブループリント

  • ブループリントの近接タイプ

Diff ツールの概要

2 つのアセットをディフするには、コンテンツ ブラウザに移動して対象となる 2 つのアセットを選択し、それらを右クリックして [Diff Selected (選択項目をディフ)] を選択します。

DiffSelected.png

差分間を移動する

Diff ツールでは、次へ進む 矢印ボタンと 前に戻る 矢印ボタンを使って差分間を移動するか、ナビゲーション ツリー内のアイテムをクリックして特定の差分を表示できます。

ToggleDifferences.gif

ディフ グラフの基本ナビゲーション

[Lock/Unlock (ロック/ロック解除)] ボタンを使うことで、2 つのグラフ間でパニングとズームのロック状態を切り替えることができます。変更をすばやく見つけるには、マウスの中央ホイールを使ってズームアウトします。変更のないすべてのノードはグレー色で表示され、変更されたノードは、その変更のタイプを示すカラー コードで囲まれて表示されます。

LockUnlock.gif

カラー コード

グラフの変更は以下の色で色分けされます。

説明

赤色

左側のパネルにあるものが、右側のパネルにありません (削減)。

緑色

右側のパネルにあるものが、左側のパネルにありません (追加)。

シアン色

何らかの変更があります。

グレー色

左側のパネルにある何かが、右側のパネルにはありません (移動されたノードやコメントなど)。

Overview.png

UE レビュー ツール

UE レビュー ツール を使用すると、棚上げまたは送信したチェンジリストに含まれるすべてのアセットをリスト表示できます。また、このツールを使ってこれらのアセットのディフやレビューを行うことも可能です。現時点では、レビュー ツールは Perforce のみでサポートされています。

レビュー ツールは、エディタ画面の右下にある [Revision Control (リビジョン コントロール)] メニューから起動できます。これが表示されていない場合は、Perforce にログインしていることを確認してください。

UEReviewTool.gif

ローカル アセットの変更と現在のソース コントロール リビジョンをディフする

ソース コントロールのメリットの 1 つとして、ファイルの以前のバージョンをそれぞれ表示し、それらを比較 (ディフ) して、ファイルに加えられた変更を確認できる点があります。以下は、ローカル アセットの変更を現在のソース コントロール リビジョンとディフするための方法です。

方法 1

コンテンツ ブラウザでアセットを右クリックして、[Source Control (ソース コントロール)] > [Diff Against Depot (デポとの差分を検出)] に移動します。

DiffLocalOption1.gif

方法 2

[View Changelists (チェンジリストを変更)] ツールでアセットを右クリックして、[Diff Against Depot] を選択します。

DiffAgainstDepot.gif

方法 3 (ブループリントのみ)

ブループリント エディタから [Diff (ディフ)] > [Depot (デポ)] に移動します。

DiffDepot.gif

ローカル アセットの変更と特定のソース コントロール リビジョンをディフする

ローカル アセットを特定のソース コントロール リビジョンとディフするには、以下のいずれかの方法を実行します。

方法 1

コンテンツ ブラウザでアセットを右クリックして、[Source Control (ソース コントロール)] > [History (履歴)] に移動します。ディフに使用するリビジョンを右クリックして、[Diff Against Workspace File (ワークスペース ファイルとの差分を検出)] を選択します。

DiffAgainstWorkspaceFile.gif

方法 2

ブループリント エディタの [Diff (ディフ)] をクリックして、ディフに使用するリビジョンを選択します。

BlueprintEditorDiff.gif

アセットの古いリビジョンとその以前のバージョンをディフする

方法 1

コンテンツ ブラウザ でアセットを右クリックします。[Source Control (ソース コントロール)] > [History (履歴)] に移動してディフ対象のリビジョンを右クリックし、[Diff Against Previous Revision (以前のリビジョンとの差分を検出)] を選択します。

DiffAgainstPreviousRevision.gif

方法 2

UE レビュー ツールでディフ対象の CL を入力して、そのアセットの隣にある ディフ ボタン をクリックします。

SpecificOption2.gif

棚上げした CL とその以前のバージョンをディフする

UE レビュー ツールでディフ対象のチェンジリスト (CL) を入力して、アセットの隣にある ディフ ボタン をクリックします。

DiffShelved.gif

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル