プロファイルQMLコード
Qt Creator に統合されているQML Profiler を使用すると、Qt Quick アプリケーションの典型的なパフォーマンス問題(動作が遅い、ユーザーインターフェイスが反応しない、もたつくなど)の原因を見つけることができます。Qt Extension for VS Code でプロファイリングデータを開き、フレームグラフとして見ることができます。
プロファイリングデータの収集Qt Creator
Qt Creator を使ってアプリケーションをプロファイリングし、.qzt または.qdt フォーマットの QML トレースファイルをプロジェクトディレクトリに保存します。
詳しくは、Qt Creator:Profile QML applications を参照してください。
プロファイリングデータの表示
VS Code でプロファイリングデータを表示するには、.qzt または.qdt ファイルをExplorer で開きます。
フレームグラフは、QMLとJavaScriptの実行の統計的な概要と、様々なQMLとJavaScriptのイベントの総影響を簡潔に表示します。ただし、QMLやJavaScriptがまったく実行されていない時間スパンは表示されないので、フレームごとの実行時間の解析には使えません。
一般的に、フレームグラフ内のイベントは、QMLやJavaScriptの実行にかかった時間を示しています。マウスカーソルを合わせると詳細が表示されます。ほとんどのイベントには、ソースコード内の位置、実行時間、ソースコード自体の関連部分が含まれます。
イベントを選択すると、コードエディターのカーソルがそのイベントに関連するコード部分に移動します。
合計時間の表示
Total time の横棒は、JavaScript と QML の全イベントの合計実行時間に対する、特定の関数の全呼び出しにかかった時間を示しています。入れ子は、どの関数が他の関数から呼び出されたかを示しています。

総メモリ割り当て量の表示
関数によって割り当てられたメモリの総量を表示するには、Memory を選択します。
関数ごとのメモリ割り当ての表示
関数によって実行されたメモリ割り当ての数を表示するには、Allocations を選択します。
データのズーム
データを拡大するには、
(Zoom to fit) を選択するか、イベントをダブルクリックします。
親イベントまでズームアウトするには、
(Zoom out to parent) を選択します。
全体表示にズームアウトするには、
(Zoom out to full view) を選択します。
イベントのフィルタ
イベントをフィルタするには
(Show/hide filter dialog) を選択します。- リストのイベント・カテゴリーを選択して、イベントの表示と非表示を切り替えます。
すべてのイベントを表示するにはSelect all 、すべてのイベントを非表示にするにはClear を選択します。
イベント
以下の表はイベントについて説明したものです。
| イベント | 説明 |
|---|---|
| JavaScript | バインディングやシグナルハンドラの背後にある実際のJavaScriptの実行に費やされた時間を表示します。バインディングの評価やシグナルの処理に使用しているJavaScript関数を一覧表示します。 |
| Compiling | QMLファイルのコンパイルに費やされた時間を表示します。 |
| Creating | シーン内のエレメントの作成に費やされた時間を表示します。エレメントの作成は2段階で行われます。第1段階は、子要素を含むデータ構造の作成です。第2段階は、完了コールバックを表します。しかし、すべての要素が完了コールバックをトリガーするわけではありません。ステージは、タイムラインでは別々のイベントとして表示されます。 |
| Binding | バインディングが評価される時間と、評価にかかる時間の長さを表示します。 |
| Signal handling | シグナルが処理される時間と、処理にかかる時間が表示されます。 |
JSONCとして開く
{} (Open flame graph as a JSONC document) を選択すると、プロファイリングデータがJSONC形式で開きます。
テキストエディタで開く
(Open in text editor) を選択して、.qtd ファイルを XML 形式で開きます。
プロジェクトのソースフォルダーとビルドフォルダーを設定する
イベント選択時に QML ソースファイルを開くには、次のようにします:
(Open configuration settings) を選択してConfiguration ビューを開きます。
(Browse for a directory) を選択し、ソースフォルダとビルドフォルダを選択します。
(Add workspace folders) を選択して、現在開いているワークスペース フォルダを追加します。- Save を選択します。
Configuration からフォルダを削除するには、
(Clear all entries) を選択します。
Qt Creatorも参照してください :QML アプリケーションのプロファイリング」も参照してください。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.