Xcode フレームデバッガーツール を使うと、アプリケーションのフレームをキャプチャして、そのフレームで GPU が実行したコマンドを確認したり、GPU メモリ内のデータを調べたり、シェーダーのボトルネックを特定したりできます。 これにより、GPU パフォーマンスを詳細に分析できます。
Unity は、Xcode のフレームデバッガーと以下のように統合されています。
重要:
Xcode のフレームデバッガーを使ってフレームをキャプチャするには、以下のいずれかを行います。
このセクションでは、Xcode UI または FrameCapture API を使用してアプリケーションを起動し、フレームキャプチャを実行する方法について説明します。このワークフローは、Metal を使用するすべてのプラットフォームに適用できます。
1. Xcode のプロジェクトを作成します。
Unity エディターから Xcode プロジェクトを作成するか、他の Xcode プロジェクトを使用して macOS アプリケーションを起動することができます。
Unity エディターから Xcode プロジェクトをビルドする場合、以下を行います。
別の Xcode プロジェクトを使用して macOS アプリケーションを起動するには、以下を行います。
2. Xcode プロジェクトのスキームを編集して、フレームキャプチャを実行できるようにします。
Xcode GUI を使用します。これを行うには、Xcode ドキュメントの Enabling Frame Capture ガイド に従い、プロジェクトスキームの GPU Frame Capture 設定を Metal に設定します。
3. Xcode からプロジェクトを起動し、フレームキャプチャを実行します。
また、FrameCapture API を使用して、スクリプトからフレームキャプチャを実行することができます。Xcode でのフレームキャプチャデータの分析については、Xcode フレームデバッガーのドキュメント を参照してください。
このセクションでは、コマンドラインからアプリケーションを起動し、FrameCapture API を使用してフレームキャプチャを実行し、その結果をディスクに保存する方法を説明します。 重要: このワークフローは、iOS ではサポートされていません。iOS 上でフレームキャプチャを実行するには、常に Xcode からアプリケーションを起動する必要があります。
-enable-metal-capture
を設定します。Xcode は、コードが要求するとフレームキャプチャを実行し、その結果をディスクに保存します。Xcode でこのデータを分析する方法については、Apple の Xcode フレームデバッガーに関するドキュメント を参照してください。
macOS では、Xcode のフレームデバッガーを使って、Unity エディターからフレームを解析することができます。Xcodeを使用してUnity エディターを起動した場合、Unity エディターの UI からフレームキャプチャを要求することができます。
以下の手順に従って、Xcode から Unity エディターを起動し、Unity エディター UI、Xcode UI、または FrameCapture API を使用してフレームキャプチャを実行します。フレームキャプチャをすぐに分析したり、結果をディスクに保存することができます。このワークフローは macOS でサポートされます。
前提条件 Unity エディターを開いている場合は閉じてください。
-projectPath
を使用して Unity プロジェクトへのパスを引数として渡します。これは、Xcode がエディターを起動するときに Unity Hub が開くのを防ぎ、代わりにプロジェクトでエディターを直接デバッグします。
FrameCapture
API を使用します。詳細については、FrameCapture API ドキュメントを参照してください。 Xcode でのフレームキャプチャデータの分析については、Apple の Xcode フレームデバッガーに関するドキュメント を参照してください。このワークフローは、コマンドラインから Unity エディター を起動し、FrameCapture API を使用してフレームキャプチャを実行し、フレームキャプチャをディスクに保存する方法について説明します。このワークフローは、macOS でサポートされています。
-enable-metal-capture
を設定します。Xcode は、コードが要求するとフレームキャプチャを実行し、その結果をディスクに保存します。Xcode でこのデータを解析する方法については、Xcode fフレームデバッガーに関するドキュメント を参照してください。