このページでは

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などのプロパティは、モジュールレベルのメタデータを設定します。 完全なリストについては、以下の「ターゲットプロパティ」セクションを参照してください。

コマンド

ターゲットプロパティ

以下のターゲットプロパティは、HAP のビルド方法に影響を与えます。

QT_HARMONYOS_ABILITY_ORIENTATION

HarmonyOS アビリティの画面向きポリシー。

QT_HARMONYOS_APP_BUNDLE_NAME

HarmonyOSアプリケーションのバンドル名。

QT_HARMONYOS_APP_ICON

HarmonyOS アプリケーションのアイコン。

QT_HARMONYOS_APP_LABEL

HarmonyOS アプリケーションのラベル。

QT_HARMONYOS_APP_NAME

HarmonyOSアプリケーションの名前。

QT_HARMONYOS_APP_VENDOR

HarmonyOSアプリケーションのベンダー。

QT_HARMONYOS_APP_VERSION_CODE

HarmonyOS アプリケーションのバージョンコード。

QT_HARMONYOS_APP_VERSION_NAME

HarmonyOS アプリケーションのバージョン名。

QT_HARMONYOS_COMPATIBLE_SDK_VERSION

HarmonyOS アプリケーションの互換性のある SDK バージョン。

QT_HARMONYOS_COMPILE_SDK_VERSION

HarmonyOS アプリケーションのコンパイル用 SDK バージョン。

QT_HARMONYOS_EXTRA_LIBS

HarmonyOS ターゲットにデプロイするための追加ライブラリ。

QT_HARMONYOS_EXTRA_PLUGINS

HarmonyOS ターゲットとともにデプロイする追加の Qt プラグイン。

QT_HARMONYOS_MODULE_DESCRIPTION

HarmonyOS モジュールの説明。

QT_HARMONYOS_MODULE_DEVICE_TYPES

HarmonyOS モジュールがサポートするデバイスタイプ。

QT_HARMONYOS_PACKAGE_SOURCE_DIR

カスタム HarmonyOS パッケージテンプレートへのパス。

QT_HARMONYOS_TARGET_ARCHS

HarmonyOS アプリケーションのターゲットアーキテクチャ。

QT_HARMONYOS_TARGET_SDK_VERSION

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.