ブループリントのデバッグ

グラフおよび変数値を調べるためにブレークポイントを使って実行を一時停止します。

Choose your operating system:

Windows

macOS

Linux

デバッグ制御

Blueprint Debugger (ブループリントデバッガ) は、PIE および SIE セッション中のゲームの実行を制御します。ゲームが実行されるとツールバーで制御ができるようになります。デバッグされているブループリントのタイプとデバッグセッションの現在の状態に応じて、異なるデバッグ制御が表示されます。関係する場合、例えば ブレークポイント がヒットした場合のみ有効になる制御もあります。

ブループリントエディタ の Window (ウィンドウ) モード内から開くことができる [Debug (デバッグ)] タブと ブループリントデバッガ でも、 SIE (Simulate in Editor) または PIE (Play in Editor) モードがアクティブの時にはコンテキスト依存のデバッグボタンが表示されます。

ブレークポイント

ブレークポイント は、ブループリントのグラフノードに配置できるマーカーです。 PIE または SIE モード中、ブレークポイントを持つノードが実行される直前にゲームが一時停止され、ブループリントエディタのグラフビューにあるそのノードに移動します。これにより、変数の値を観察し、ブループリント内の実行の流れを調べたりステップスルーしたりすることができます。特定のブループリントのすべてのブレークポイントは [デバッグ] タブに表示され、選択するとブループリントのグラフに表示できます。ノードにブレークポイントを配置するには、ノードを右クリックしてコンテキストメニューから [Add Breakpoint (ブレークポイントを追加)] を選択します。そうすると、赤色の八角形がノードの左上の角に表示されます。ブレークポイントは、ノードを右クリック、または [デバッグ] タブでブレークポイントのエントリを右クリックして [Remove Breakpoint (ブレークポイントを取り除く)] を選択すれば取り除くことができます。

このブレークポイントは、「Print」ノードが実行される直前にゲームを中断します。

完全に削除せずに一時的にブレークポイントを無効にするには、ブループリントのノード自体、または [デバッグ] タブのブレークポイントのエントリを右クリックして、コンテキストメニューから [Disable Breakpoint (ブレークポイントを無効にする)] を選択します。無効にされたブレークポイントは、赤い八角形の線で表示されます。無効なブレークポイントは実行されませんが、簡単に再有効化できます。この方法は、ブレークポイントの削除と再作成を繰り返すよりも便利で、人的ミスも起こりにくくなります。

このブレークポイントは無効になっており、現在は何も動作していませんが、必要に応じて簡単に再有効化できます。

無効化されたブレークポイントを有効化するには、ノードを右クリックして [Enable Breakpoint (ブレークポイントを有効にする)] を選ぶか、 [デバッグ] タブのブレークポイントの隣のアイコンをクリックしてください。 [デバッグ] タブでブレークポイントを 右クリック して [ブレークポイントを有効にする] を選択しても有効にできます。デバッグセッション中を含め、いつでもブレークポイントの作成、無効化、有効化、破棄が可能です。ブレークポイントはプロジェクトの「.ini」ファイルに保存されるので、それらはエディタのセッションの間も持続します。

ブレークポイントが無効な場所に配置されていると、黄色になり「！」が表示されることがあります。ブループリントをコンパイルすると問題が解決する場合があります。それで解決しない場合は、ブレークポイントアイコンの上にマウスカーソルを置くと、警告内容が表示されます。

このブレークポイントは無効であり、動作しません。場合によっては、ブループリントを再コンパイルするとこの問題を解決できます。

ブレークポイントで実行を一時停止すると、エディタがノードをハイライトし、そのノードにフォーカスを当てます。そして、そのノード上に大きな赤い矢印を配置します。

このブレークポイントに到達したところで、実行を一時停止しています。

デバッグタブとブループリントデバッガ

[デバッグ] タブはデザイナーが重要とみなした情報を、ブレークポイントとウォッチ値、および実行されたブループリントに属するすべてのノードのスタックのトレース (追跡) という形で表示します。このパネルには、ブレークポイント使用時のゲームの実行をコントロールするための制御が表示されます。

ウォッチウィンドウ

ブループリントウォッチウィンドウ を使用すると、複数のブループリントにまたがっても見たい変数やノードにアクセスできるので、デバッグ作業をスピードアップできます。エディタで開いた、現在のコールスタックの一部であるすべてのブループリントからのデータは単一のリストに統合され、ブループリントの実行が一時停止されるたびに現在のデータが表示されます。このリストを使用すると、変数や関数の出力を調べたり、ブループリント間の簡単な切り替えが可能です。配列、セット、マップ、その他のデータ構造を拡張することができ、それらに含まれているデータのドリルダウン検索を素早く簡単に行うことができます。また、「Node Name (ノード名)」列のエントリをクリックしてブループリント中の名前のあるノードに移動するか、「Object Name (オブジェクト名)」列のエントリを選択してその特定のオブジェクトインスタンスを選択することもできます。

コールスタック

デバッグセッション中に使用可能な コールスタック は、ほとんどの C++ 開発環境にあるようなコールスタックと概念が似ています。コールスタックは、現在スタックの最上部で実行されているブループリント関数を使用して、ブループリントとネイティブ (C++) コード間の実行の流れを表示します。

ブループリントマクロはコールスタックに表示されません。代わりに、ブループリントマクロはそれを呼び出したブループリント関数の一部として表示されます。

上記のブループリント関数は、階乗計算を再帰的に実行します。関数の最後にブレークポイントが設定されています。

ブレークポイントに達すると、コールスタックは現在動作中の関数を一覧表示します。先頭にある現在の関数から始めて呼び出し元の関数に向かって下に進みます。つまり、各行のエントリには、そのすぐ下の行に指定されている関数によって呼び出された関数の名前が含まれています。再帰的 (自己呼び出し) 関数の場合、同じ関数名が連続して複数回現れることがあります。