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

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

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

• Qt Quick 1:QT_DECLARATIVE_DEBUG
• 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 でのデバッグでは、デバッグインフラストラクチャを使用して、 アプリケーションのデバッグ、検査、プロファイリングを行います。 では、JavaScript のデバッグ、オブジェクトツリーの検査、QML エンジンのアクティビティのプロファイリングのための統合クライアントが提供されています。詳しくは、Qt Quick Qt Creator Qt Creator:Debugging ProjectsをQt Quick ご覧ください。