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 6.8.1 以降、Qt モジュールによって設定されたデフォルトのパーミッションを上書きすることができます。これは、Qtモジュールによって使用されるのと同じパーミッションを、追加または異なる属性で定義する必要がある場合に便利です。

これを実現するには、<!-- %%INSERT_PERMISSIONS --> プレースホルダとともに、Android マニフェスト ファイルでこれらのパーミッションを手動で定義します。手動で定義されたパーミッションは、Qt モジュールによって追加された同じパーミッションよりも優先されるため、重複を避けることができます。

スタイルの抽出

Qt では、Qt Widgets とQt Quick Controls がどのようにスタイリングされるべきかを決定するために、異なる方法を使用します：

• default または : または を使用する場合 1.full Qt Widgets Qt Quick Controls

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

• minimal:Qt 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を参照してください。