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 アイコン・ジェネレーター
• Android Studio：イメージアセットスタジオ
• オンライン Android アイコン・ジェネレーター

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

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

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

関連ドキュメント

• Qt for Android マニフェストファイルの設定
• 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アプリバンドル（AAB）を主に受け付けるようになりました。AAB パッケージにより、Google Play は各デバイス向けにアプリの配信を最適化できます。

cd build
cmake --build . --target aab

cmake --build . --target appname_make_aab

関連ドキュメント

• GoogleのPlayアプリ署名ガイド
• Android アプリバンドル FAQ

Google Play コンソールへの公開

アプリの作成と署名が完了したら、Google Play Console にアプリを公開して配布します。

アップロードの準備

アップロードする前に

1. 異なるデバイスとAndroidバージョンでアプリを徹底的にテストする
2. プロモーション資料（スクリーンショット、説明文、機能グラフィック）を準備する。
3. Google Playのコンテンツポリシーとガイドラインを確認する

Google Play コンソールでアプリを作成する

1. Google Play コンソールにログインする
2. 新しいアプリを作成するか、既存のアプリを選択します。
3. アプリの詳細とコンテンツ評価のアンケートに回答
4. 価格設定と配信設定を行う

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

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

1. Release > に移動します。Production
2. 新しいリリースを作成する
3. 署名済みのAABファイルをアップロードします。
4. リリースノートを追加します。
5. リリースのレビューとロールアウト

リソース

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

特別な考慮事項

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

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

ANDROID_VERSION_CODE = <unique_version>

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

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

例arm64-v8a用リリース1.0は、バージョンコード16410 。

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