Google Playへの公開

Qt for Android は、Android アプリの開発、ビルド、パッケージ化に必要なすべての機能を提供します。このガイドでは、アプリの設定、ビルド、および Google Play Console への公開方法について説明します。

アプリの設定

CMake API を使用するか、マニフェストを直接編集して、Android アプリの設定を行います。Android アプリでは、AndroidManifest.xml および Gradle ビルドファイルにさまざまな設定が必要です。Qt 6 には、プロジェクトからこれらを管理するための便利な CMake API が用意されています。

必須のアプリプロパティを設定する

アプリのパッケージ名、バージョン、および Android SDK の要件を定義します。

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_PACKAGE_SOURCE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/android"
    QT_ANDROID_PACKAGE_NAME "io.qt.calqlatr"
    QT_ANDROID_APP_NAME "Calqlatr"
    QT_ANDROID_TARGET_SDK_VERSION 35
    QT_ANDROID_MIN_SDK_VERSION 28
    QT_ANDROID_VERSION_NAME "1.0"
    QT_ANDROID_VERSION_CODE 10
)

アプリアイコンの設定

アプリアイコンを設定し、正しいディレクトリにアイコンファイルを作成します：

set_target_properties(${appname} PROPERTIES
    QT_ANDROID_APP_ICON "@drawable/ic_launcher"
)

アイコンファイルは次の場所に配置してください：

<QT_ANDROID_PACKAGE_SOURCE_DIR>/res/drawable-<dpi>

アイコンファイルは、以下のツールを使用して作成できます:

• Qt Creator Android Icon Generator
• Android Studio：Image Asset Studio
• オンラインのAndroidアイコンジェネレーター

プラグインのパッケージを最適化する

含めるプラグインを指定することで、アプリのサイズを縮小できます。androiddeployqtツールは、実行時にアプリが必要としないプラグインを含めてしまう場合があります：

qt_import_plugins(${appname}
    INCLUDE_BY_TYPE imageformats Qt::QSvgPlugin Qt::QJpegPlugin
    EXCLUDE_BY_TYPE iconengines networkinformation tls platforminputcontexts qmltooling
)

関連ドキュメント

• Android向けQtのマニフェストファイル設定
• androiddeployqt ツール

アプリのビルド

リリース用のアプリをビルドし、Google Play Console への提出準備を行います。

リリースビルドの設定

Google Play ではリリースビルドが必須です。デバッグ情報は別ファイルとして含めることができ、クラッシュ報告の精度を高めるためにもそのようにすることを推奨します：

qt-cmake -DCMAKE_BUILD_TYPE=Release

マニフェストまたはGradle設定で、「debuggable」が「false 」に設定されていることを確認してください。

マルチABIサポートを有効にする

互換性を最大限に高めるため、複数のデバイスアーキテクチャ向けにアプリをビルドします：

qt-cmake -DQT_ANDROID_BUILD_ALL_ABIS:BOOL=ON ...

署名キーの作成

Google Play Console では、署名済みのアプリリリースが必須です。Google では、2 つのキーを使用した Google Play 管理型署名の利用を推奨しています:

• 署名キー：Google Play Consoleでアプリを作成する際にGoogleによって生成・管理されるもの
• アップロード用キー：アップロード用のアプリバンドルに署名するためにローカルで管理される

keytool -genkey -keyalg RSA -keystore upload-key.keystore \
    -alias play_apps \
    -storepass <password> -keypass <key-password> \
    -dname "CN=<n>, OU=<unit>, O=<organisation>, L=<city>, ST=<state>, C=<country>"

qt-cmake -DQT_ANDROID_SIGN_APK:BOOL=ON -DQT_ANDROID_SIGN_AAB:BOOL=ON ...

export QT_ANDROID_KEYSTORE_PATH=upload-key.keystore
export QT_ANDROID_KEYSTORE_ALIAS=play_apps
export QT_ANDROID_KEYSTORE_STORE_PASS=<password>
export QT_ANDROID_KEYSTORE_KEY_PASS=<key-password>

アプリバンドル（AAB）を生成する

Google Play Consoleでは、APKに代わって主にAndroid App Bundle（AAB）を受け付けるようになりました。AABパッケージを使用することで、Google Playは各デバイスに合わせてアプリの配信を最適化できます。

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

関連ドキュメント

• GoogleのPlayアプリ署名ガイド
• Android App Bundleに関するよくある質問

Google Play Console への公開

アプリをビルドして署名したら、配布のために Google Play コンソールに公開します。

アップロードの準備

アップロードの前に：

1. さまざまなデバイスやAndroidのバージョンでアプリを徹底的にテストしてください
2. プロモーション用素材（スクリーンショット、説明文、フィーチャーグラフィック）を準備してください
3. Google Playのコンテンツポリシーとガイドラインを確認してください

Google Play Consoleでアプリを作成してください

1. Google Play Consoleにログインしてください
2. 新しいアプリを作成するか、既存のアプリを選択してください
3. アプリの詳細情報とコンテンツレーティングに関する質問票に回答する
4. 価格設定と配信設定を行う

アカウントをお持ちでない場合は、Google のPlay コンソール設定ガイドを参照してアカウントを作成してください。

アプリバンドルをアップロードする

1. Release に移動 >Production
2. 新しいリリースを作成
3. 署名済みの AAB ファイルをアップロードします
4. リリースノートを追加
5. リリースを確認して展開する

リソース

• アプリの作成と設定
• Googleのアプリ公開ガイド
• Google Play Console ウェビナー

特別な考慮事項

レガシープロジェクト向けのシングルABIビルド

マルチABIビルドをサポートしていないQtバージョン（qmakeプロジェクトなど）の場合は、異なるバージョンコードを使用して各アーキテクチャごとに個別にビルドしてください：

ANDROID_VERSION_CODE = <unique_version>

<Platform><ABI><AppVersion> のようなバージョン付けスキームの使用を検討してください：

• プラットフォーム：Arm は 1、Intel は 2
• アーキテクチャ：32ビットは32、64ビットは64

例：arm64-v8a 向けのリリース 1.0 では、バージョンコード16410 を使用します。

詳細については、Googleのアプリバージョン管理に関するドキュメントを参照してください。