HarmonyOS向けQtのCMake API
注: HarmonyOS CMake APIは 現在テクノロジープレビュー段階にあり、今後のリリースで変更される可能性があります。
このページでは、QtアプリケーションをHarmonyOS Ability Package(HAP)にパッケージ化する方法を設定するためのCMakeコマンド、ターゲットプロパティ、および変数について説明します。
HarmonyOS をターゲットとしてqt_add_executable()を使用して Qt 実行ファイルを作成すると、Qt は HAP を生成する `<target>_make_hap ` ビルドターゲットを自動的に生成します。以下のコマンド、プロパティ、および変数は、その HAP の内容と、HarmonyOS マニフェストファイルに書き込まれるメタデータを制御します。
HarmonyOSアプリケーションバンドルは、2種類のマニフェストによって記述されます。1つはバンドル全体に適用されるメタデータを保持するアプリケーションレベルのapp.json5 、もう1つは、そのバンドル内の単一のHAPモジュールを記述するモジュールレベルのmodule.json5 です。 以下のターゲットプロパティはこの区分を反映しています。QT_HARMONYOS_APP_* プロパティは、ベンダー、バージョン、ラベル、アイコンなどのアプリケーションレベルのメタデータを設定し、QT_HARMONYOS_MODULE _ DESCRIPT IONやQT_HARMONYOS_ABILITY_ORIENTATIONなどのプロパティは、モジュールレベルのメタデータを設定します。 完全なリストについては、以下の「ターゲットプロパティ」セクションを参照してください。
コマンド
- qt_add_harmonyos_permission()は、アプリケーションに HarmonyOS 権限を追加します。
ターゲットプロパティ
以下のターゲットプロパティは、HAP のビルド方法に影響を与えます。
HarmonyOS アビリティの画面向きポリシー。 | |
HarmonyOSアプリケーションのバンドル名。 | |
HarmonyOS アプリケーションのアイコン。 | |
HarmonyOS アプリケーションのラベル。 | |
HarmonyOSアプリケーションの名前。 | |
HarmonyOSアプリケーションのベンダー。 | |
HarmonyOS アプリケーションのバージョンコード。 | |
HarmonyOS アプリケーションのバージョン名。 | |
HarmonyOS アプリケーションの互換性のある SDK バージョン。 | |
HarmonyOS アプリケーションのコンパイル用 SDK バージョン。 | |
HarmonyOS ターゲットにデプロイするための追加ライブラリ。 | |
HarmonyOS ターゲットとともにデプロイする追加の Qt プラグイン。 | |
HarmonyOS モジュールの説明。 | |
HarmonyOS モジュールがサポートするデバイスタイプ。 | |
カスタム HarmonyOS パッケージテンプレートへのパス。 | |
HarmonyOS アプリケーションのターゲットアーキテクチャ。 | |
HarmonyOSアプリケーションのターゲットSDKバージョン。 |
変数
以下の変数は、HAPのビルド方法に影響を与えます:
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.