HarmonyOS向けQtアプリケーションのビルドとデプロイ

このページでは、HarmonyOS 向けの Qt アプリケーションのビルドおよびパッケージ化の方法、およびデバイスやエミュレータ上での実行方法について説明します。

HAP へのパッケージ化

HarmonyOSアプリケーションは、HarmonyOS Ability Package（HAP）として提供されます。HarmonyOSをターゲットとしてqt_add_executable()を使用してQtアプリケーションの実行ファイルを作成すると、Qtは自動的に<target>_make_hap ビルドターゲットを生成します。このターゲットをビルドすることで、アプリケーション用のHAPが生成されます：

cmake --build . --target <target>_make_hap

デプロイの仕組み

<target>_make_hap ターゲットは、HarmonyOSのデプロイツールであるharmonydeployqtを実行します。 その動作は`androiddeployqt` と同様で、アプリケーションの共有ライブラリ、HarmonyOSプラットフォームプラグイン（libqohos.so ）、必要なQtモジュール、およびQt Quick アプリケーションの場合はQMLモジュールを収集し、それらをHarmonyOSアプリケーションテンプレートに配置します。その後、OpenHarmonyのビルドツール `hvigor ` を呼び出して、最終的なHAPを組み立てます。

HarmonyOSマニフェスト（app.json5 およびmodule.json5 ）に記述されるメタデータを設定し、権限を宣言するには、『Qt for HarmonyOS CMake API』に記載されているコマンドを使用します。

アプリケーションの実行

生成されたHAPを、接続されたHarmonyOSデバイスまたはエミュレータにインストールして実行します。デプロイおよびデバッグを行う最も便利な方法は、DevEco Studioで生成されたプロジェクトを開き、その実行およびデバッグツールを使用することです。