harmonydeployqt ツール

HarmonyOS向けのQtアプリケーションのパッケージ化には多くの手順が必要となるため、Qtにはその作業を自動で行うツールが付属しています。CMakeの<target>_make_hap ターゲットをビルドすると、harmonydeployqt が自動的に実行されるため、通常は手動で呼び出す必要はありません。パッケージ化およびデプロイの全体的なプロセスについては、「HarmonyOS向けQtアプリケーションのビルドとデプロイ」で説明されています。

仕組み

androiddeployqtと同様に、harmonydeployqt はアプリケーションの実行に必要なすべての要素を収集し、デプロイ可能なパッケージを作成します：

• アプリケーションの共有ライブラリ、HarmonyOSプラットフォームプラグイン（libqohos.so ）、必要なQtモジュールおよびプラグイン、さらにQt Quick アプリケーションの場合はQMLモジュールを収集します。
• これらを、Qt for HarmonyOS CMake APIを通じて宣言されたメタデータや権限とともに、HarmonyOSアプリケーションテンプレートに配置します。
• さらに、OpenHarmonyhvigor ビルドツールを呼び出し、最終的な HarmonyOS Ability Package (HAP) を構築します。

このプロセスを制御する設定は、CMake ビルドによって自動的に生成される JSON 設定ファイルを通じてツールに渡されます。

コマンドライン引数

必須の引数は--input のみです。以下のリストは、harmonydeployqt に--help を渡すことでも利用可能です。

HAPへの署名

HAPをデバイスにインストールするには、事前に署名を行う必要があります。署名用データは、コマンドライン引数または対応する環境変数のいずれかを通じて指定できます。両方が指定された場合、その個々のフィールドについてはコマンドライン引数が優先されます。

パスワードは、プレーンテキストではなく、hvigor-encrypted 形式のBLOBでなければなりません。署名は「すべてか、まったくか」の原則に従います。つまり、署名用の入力が1つでも設定されている場合、必要な6つの値（証明書、プロファイル、キーストア、キーエイリアス、キーパスワード、およびキーストアパスワード）がすべて存在しなければなりません。そうでない場合、HAPは署名されません。

アプリケーションの実行

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

HarmonyOS 向け Qt アプリケーションのパッケージ化およびデプロイに関する詳細については、「HarmonyOS 向け Qt アプリケーションのビルドとデプロイ」を参照してください。