説明

qmlprojectexporterを使用すると、QML ソース、画像アセット、およびフォントをコンパイル可能な C++ コードにエクスポートできます。このツールは、エクスポートオプションと共にアセットを列挙した `.qmlproject ` ファイルを解析し、それらを変換します。 さらに、qmlprojectexporterは、インポートおよびエクスポートされたファイルのプレーンテキストリストもエクスポートするため、CMakeなどのサードパーティ製ビルドシステムで自動的に利用しやすくなっています。

CMakeプロジェクトにおけるqmlprojectexporter の使用方法

CMakeビルドシステムでのqmlprojectexporter の使用方法は簡単です。カスタムCMakeマクロ「qul_add_target」が、適切なパラメータを指定してqmlprojectexporter を呼び出す処理をすでに担当しています。これを使用するには、次のように「QML_PROJECT」引数を定義し、その後にqmlprojectファイルを指定する必要があります。

qul_add_target(my_project QML_PROJECT my_project.qmlproject)

qmlprojectexporter を使用する場合、qmlprojectexporter の呼び出しには同じロジックが含まれているため、以下の CMake マクロは不要です:

• qul_target_qml_sources
• qul_target_generate_interfaces
• qul_target_embed_translations
• qul_add_qml_module

また、CMake から以下のターゲットプロパティを設定する必要もありません

• QUL_FONT_FILES

なお、CMake で Qul アプリケーションを動作させるには、次のように qmlproject ターゲットを追加した後、app_target_setup_osおよびapp_target_default_entrypointマクロを呼び出す必要があります。

app_target_setup_os(myproject)
// With a \c Main.qml (specified only as Main) being the entrypoint
app_target_default_entrypoint(swipe_game_qmlproject Main)

スタンドアロンでの使用qmlprojectexporter

CMake 以外のビルドシステムを使用する場合でも、qmlprojectexporter を直接使用することは可能です。これによりアセットファイルが生成され、お好みのビルドシステムで使用することができます。

qmlprojectexporter --outdir output_directory myproject.qmlproject

サードパーティ製IDE向けのプロジェクト生成

GHS Multi IDE を使用したワークフローやその他のビルドシステムとのQt for MCUs プロジェクトの統合を簡素化するため、qmlprojectexporter は、生成された UI ソースと、対象プラットフォーム向けにエクスポートされたプラットフォームソースを含むプロジェクトファイルをエクスポートできます。

この機能を有効にするには、--project-type、--platform、および--toolchainコマンドライン引数を使用して、プロジェクトタイプとターゲットプラットフォームを指定します。

この機能の詳細については、「 Qt for MCUs プロジェクトとプラットフォームソースのエクスポート」を参照してください。

以来

この実行ファイルは、QmlProject API 1.3で導入されました。