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_IMPORT_TRACE 環境変数を設定することで、QML のインポート読み込み機構からのデバッグ出力を有効にすることができます。

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

import QtQuick

Rectangle { width: 100; height: 100 }

QML ランタイムツールや 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 を使用する場合は、プロジェクトの.pro ファイルに設定パラメータを追加します：

• Qt Quick 1：CONFIG+=declarative_debug
• Qt Quick 2：CONFIG+=qml_debug

If you use another build system, you can pass the following defines to the compiler:

• Qt Quick 1：QT_DECLARATIVE_DEBUG
• Qt Quick 1: Qt Quick 2：QT_QML_DEBUG

QML debugging is enabled. Only use this in a safe environment.

アプリケーションの起動

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

-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 によるデバッグ Qt Creator はデバッグインフラストラクチャを使用して、デスクトップおよびリモートデバイス上の Qt Quick アプリケーションをデバッグ、検査、プロファイル化します。Qt Creator は、JavaScript のデバッグ、オブジェクトツリーの検査、QML エンジンのアクティビティのプロファイリングのための統合されたクライアントを提供します。詳細はQt Creator を参照してください：Qt Quick Projects のデバッグ」を参照してください。