QMLアプリケーションのデバッグ

QMLでアプリケーションを開発する際、直面する可能性のある問題をデバッグする 方法はたくさんあります。以下のセクションでは、利用可能なデバッグツールとその使い方について説明します。

コンソールAPI

function f(a, b) {
  console.log("a is ", a, "b is ", b);
}

function f() {
  var x = 12
  console.assert(x == 12, "This will pass");
  console.assert(x > 12, "This will fail");
}

function f() {
    console.time("wholeFunction");
    console.time("firstPart");
    // first part
    console.timeEnd("firstPart");
    // second part
    console.timeEnd("wholeFunction");
}

function f() {
  console.count("f called");
}

function f() {
    console.profile();
    //Call some function that needs to be profiled.
    //Ensure that a client is attached before ending
    //the profiling session.
    console.profileEnd();
}

また、これらのconsole 関数の最初の引数としてlogging category を渡すこともできます。詳細はLoggingCategory を参照してください。

モジュールのインポートのデバッグ

QMLのインポート読み込み機構からのデバッグ出力を有効にするには、QML_IMPORT_TRACE 環境変数を設定してください。

例えば、次のような単純なQMLファイルの場合です：

import QtQuick

Rectangle { width: 100; height: 100 }

QML Runtime ツールやQML C++アプリケーションを実行する前にQML_IMPORT_TRACE=1 を設定すると、次のような出力が表示されます：

QQmlImportDatabase::addImportPath "/qt-sdk/imports"
QQmlImportDatabase::addImportPath "/qt-sdk/bin/QMLViewer.app/Contents/MacOS"
QQmlImportDatabase::addToImport 0x106237370 "." -1.-1 File as ""
QQmlImportDatabase::addToImport 0x106237370 "Qt" 4.7 Library as ""
QQmlImportDatabase::resolveType "Rectangle" = "QDeclarativeRectangle"

QMLデバッグ基盤

この Qt Qmlモジュールは、TCPポートやローカルソケットを介してアプリケーションのデバッグ、検査、プロファイリングを行うためのサービスを提供します。

インフラストラクチャの有効化

アプリケーションをコンパイルする際に、デバッグインフラを明示的に有効にする必要があります。qmake を使用する場合、CONFIG+=qml_debug 設定パラメータをプロジェクト.pro ファイルに追加することができます。

他のビルド・システムを使う場合は、QT_QML_DEBUG 定義をコンパイラに渡します：

アプリケーションの起動

デバッグを有効にするには（最初から、または後でデバッガーをアタッチするには）、以下の引数でアプリケーションを起動します：

-qmljsdebugger=port:<port_from>[,port_to][,host:<ip address>][,block][,file:<local socket>][,services:<comma-separated list of services to enable>]

ここで

• 必須のport_from は、デバッグ・ポートまたはport_to が指定されている場合のポート範囲の開始ポートを指定します。
• オプションのip address は、アプリケーションを実行するホストの IP アドレスを指定します。
• オプションのblock は、デバッグ・クライアントがサーバーに接続するまで、アプリケーションの実行を防ぎます。
• オプションのfile はローカルソケットを指定します。
• オプションのservices は、有効にするサービスを指定します。デフォルトは、検出されたすべて のサービスです。v4 debug サービスは JIT を無効にすることに注意してください。

アプリケーションが正常に起動すると、以下のメッセージが表示されます：

QML Debugger: Waiting for connection on port <port_number>

または

QML Debugger: Connecting to socket at <file>

アプリケーションへの接続

アプリケーションの実行中、IDE やバイナリプロトコルを実装したツールは、開いているポートに接続することができます。

Qt では、プロファイリングデータをファイルに取り込むためのqmlprofiler コマンドラインツールを提供しています。このツールを実行するには、次のコマンドを入力します：

qmlprofiler -p <port> -attach <ip address>

によるデバッグQt Creator

Qt Creator を使ったデバッグでは、デバッグインフラストラクチャを使用して、デスクトップ上やリモートデバイス上のQMLアプリケーションのデバッグ、検査、プロファイリングを行います。Qt Creator では、JavaScriptのデバッグ、オブジェクトツリーの検査、QMLエンジンのアクティビティのプロファイリングのための統合されたクライアントを提供しています。詳しくは、Qt Creator:DebuggingQt Quick Projectsをご覧ください。