Qt Quick のUltraliteアプリケーションターゲットを作成し、Qt Quick のUltraliteライブラリにリンクします。

概要

qul_add_target(<name>
               [STATIC_LIBRARY]
               [GENERATE_ENTRYPOINT]
               [QML_PROJECT <qmlproject_file>]
               [SELECTORS <selectors...>]
               [source1]
               [source2 ...])

説明

Qt Quick のUltraliteアプリケーションターゲットを作成し、Qt Quick のUltralite Coreライブラリに自動的にリンクします。指定されたオプションに応じて、実行ファイルまたは静的ライブラリが生成されます。

並列処理

CMake環境変数CMAKE_BUILD_PARALLEL_LEVEL を設定することで、エクスポート処理中にqmlprojectexporter が生成できる並列プロセスの最大数を指定できます。configureフェーズでこの変数が設定されていない場合、qmlprojectexporter は--parallelコマンドラインオプションのドキュメントに記載されているデフォルトの制限値を使用します。

オプション

オプションのSTATIC_LIBRARY フラグは、出力アーティファクトが静的ライブラリであることを指定します。

オプションのGENERATE_ENTRYPOINT フラグは、Project.mainFileで定義されたQmlファイルからアプリケーションのデフォルトのエントリポイントが生成されることを指定します。そのため、GENERATE_ENTRYPOINTを使用する場合、QmlProjectファイルにおいてProject.mainFileは必須のプロパティとなります。 エントリポイントは、アプリケーションが実行可能ファイルの場合は主に main.cpp を指し、ターゲットが上記のSTATIC_LIBRARY を使用して静的ライブラリとしてマークされている場合は qul_run.h を指します。 このフラグが指定されていない場合は、qul_add_target にソースとして、またはcmakeのadd_sources コマンドを使用して、プロジェクトにカスタムエントリポイントを追加する必要があります。カスタムエントリポイントの設定方法の詳細については、Qul::Application を参照してください。

qmlproject ファイルを使用してプロジェクトを設定する場合は、QML_PROJECT を指定する必要があります。この場合、qmlproject ファイルの指定が必須となります。

SELECTORS は、プロジェクトファイル構造内に存在するさまざまなバリアントからどのファイルを選択するかを設定できる、複数値の引数です。これはMCU.Config.fileSelectorの代替手段であり、SELECTORS で定義されたセレクタは、プロジェクトで使用されるすべての qmlproject ファイルに適用されます。

例

qul_add_target(example_app)

qul_add_target(example_app STATIC_LIBRARY)

qul_add_target(example_app
               source1.cpp
               source2.cpp)

qul_add_target(example_app
               STATIC_LIBRARY
               source1.cpp
               source2.cpp)

//Configure a Qul project using qmlproject files
qul_add_target(example_app
            QML_PROJECT
            example_app.qmlproject
)

// Configure which variant of the project to apply using selectors
qul_add_target(example_app
            QML_PROJECT
            example_app.qmlproject
            SELECTORS
                small_screen board_id ram_optimized
)

以来

このコマンドは、Qt Quick Ultralite 1.7で導入されました。