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 Console への公開

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

アップロードの準備

アップロードする前に

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

Google Play Console でアプリを作成する

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のアプリのバージョン管理に関するドキュメントを参照してください。