Qt Androidマニフェストファイルの設定

Android Manifestは、Androidアプリに必要なXMLファイルです。パッケージ名、アプリ名、バージョンなど、アプリ自体の詳細だけでなく、アプリが使用するさまざまな設定や機能のアプリ構成が含まれています。パーミッションやハードウェア機能もマニフェストから設定できます。

Qt for Android では、Android 上で Qt アプリをビルドして実行するために必要な機能、パーミッション、およびビルドシステムで使用されるその他の設定を含む、デフォルト設定のAndroidManifest.xml のバージョンを維持しています。

Qt プロジェクトからマニフェストへの設定

Qt では、ビルド システムからandroiddeployqtに渡されるいくつかのメタデータを定義しており、マニフェスト ファイルで明示的に設定しなくても、正しい値をマニフェストに入力することができます。このようなメタデータには、例えば"-- %%INSERT_VALUE%% --" という形式の値が割り当てられます：

<manifest ...
    android:versionCode="-- %%INSERT_VERSION_CODE%% --"
    ...
</manifest>

これには、例えばCMake で設定されているバージョンコードが入力されます。

Qt デフォルトの構成

Qt はデフォルトで以下のマニフェスト構成を設定します：

<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>

Qt 固有のメタデータ

Qt が設定するデフォルトのマニフェスト構成に加えて、Qt は Qt アプリにのみ有効なメタデータを定義します。このようなメタデータは通常、フォームの<activity> セクションの下にあります：

<meta-data
    android:name="meta-data-name"
    android:value="meta-data-value" />

以下は Qt によって定義されたメタデータのリストです：

アプリケーション固有のメタデータ

いくつかのメタデータ属性はアプリケーション固有であり、<application> セクションの下に配置する必要があります：

サービス内のメタデータ

いくつかのメタデータ属性は、サービスでも使用できます。主なものは次のとおりです：

• android.app.lib_name
• android.app.background_running
• android.app.arguments

Qtのパーミッションと機能

例えば、QtMultimedia のCamera権限などです。androiddeployqtツールは、ビルド中にAndroidマニフェストにそのような要件を含めるようにします。Qtはマニフェストに以下の行を定義し、実際の値に置き換えます：

<manifest ...
    <!-- %%INSERT_PERMISSIONS -->
    <!-- %%INSERT_FEATURES -->
    ...
</manifest>

スタイルの抽出

Qt では、Qt ウィジェットや Qt クイックコントロールのスタイルを決定するために、さまざまな方法を使用します：

• default または : Qt ウィジェットや Qt クイックコントロールを使用する場合 1.full

  注意： この方法は、Android 9.0 (API 28)からGoogleによって制限され削除される、Androidの非SDKインターフェースを使用します。そのため、この方法は Android 9.0 以上では推奨されません。

• minimalQt Quick Controls 2 を使用し、Qt Widgets または Qt Quick Controls 1 を使用しない場合。デフォルトやフルオプションを使用するよりも高速です。
• noneスタイル抽出を行いません。

6.2 リリース以前の Qt マニフェスト

6.2 より前のバージョンの Qt では、Qt によって定義されたメタデータが追加されていました。これらの属性は依存関係を管理するために使用され、一部は廃止されたMinistro サービスで使用されていました。Qt 6.2 では、これらの属性は削除されています。以下はこれらの属性のリストです：

• android.app.qt_sources_resource_id
• android.app.repository
• android.app.bundled_libs_resource_id
• android.app.bundle_local_qt_libs
• android.app.use_local_qt_libs
• android.app.libs_prefix
• android.app.load_local_libs_resource_id
• android.app.load_local_jars
• android.app.static_init_classes
• android.app.qt_libs_resource_id
• android.app.ministro_not_found_msg
• android.app.ministro_needed_msg
• android.app.fatal_error_msg

Android Manifestの詳細については、Android App Manifestを参照してください。