---

name: android-release description: Flutter AndroidアプリをGoogle Playに公開するためのワークフロー。Internal testing（内部テスト）からProduction公開までをサポート。トリガー：「Android公開」「Google Play公開」「AABビルド」「署名設定」「Play Console」「Internal testing」「リリース準備」

Android Release Skill

Flutter製AndroidアプリをGoogle Playに公開するための手順ガイド。

ワークフロー概要

Phase 1: 事前準備
    ↓
Phase 2: 署名設定
    ↓
Phase 3: AABビルド
    ↓
Phase 4: Play Console設定
    ↓
Phase 5: Internal Testing
    ↓
Phase 6: Production公開

Phase 1: 事前準備（コード修正）

1-1. applicationId確定

flutter_app/android/app/build.gradle.kts:

defaultConfig {
    applicationId = "com.yourapp.name"  // 公開後変更不可
}

1-2. AndroidManifest.xml修正

flutter_app/android/app/src/main/AndroidManifest.xml:

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.INTERNET"/>
    <application android:label="アプリ名" ...>

1-3. MainActivity.kt移動

パッケージ名に合わせてディレクトリ構造を変更:

flutter_app/android/app/src/main/kotlin/com/yourapp/name/MainActivity.kt

1-4. プライバシーポリシー作成

public/privacy.htmlを作成。Data Safety申告と整合させる。

Phase 2: 署名設定

Upload Key作成、key.properties作成、build.gradle.kts署名設定の詳細は references/config-signing.md を参照。

手順概要:

1. Upload Key（JKS）を作成
2. key.properties にパスワード・エイリアスを記載
3. build.gradle.kts に署名設定を追加

Phase 3: AABビルド

3-1. ビルド実行

cd flutter_app
flutter clean && flutter pub get
flutter build appbundle --release

出力: build/app/outputs/bundle/release/app-release.aab

3-2. 署名確認

署名確認コマンドは references/config-signing.md を参照。

Phase 4: Play Console設定

4-1. アカウント作成

1. https://play.google.com/console
2. 登録料: 25 USD（一度きり）

4-2. アプリ作成

• アプリ名、言語（日本語）、タイプ（アプリ）、無料/有料

4-3. ストア掲載情報

詳細は references/store-listing.md 参照。

4-4. Data Safety申告

詳細は references/data-safety.md 参照。

Phase 5: Internal Testing

1. Play Console > テスト > 内部テスト > 新しいリリース作成
2. AABアップロード
3. テスターのGmailアドレス追加
4. 招待リンク共有
5. インストール・動作確認

Phase 6: Production公開

1. コンテンツレーティング質問票回答
2. 製品版リリース作成
3. 審査提出（1-7日）
4. 公開

チェックリスト

必須（Internal testing）

• applicationId確定・変更
• AndroidManifest.xml（INTERNET権限、アプリ名）
• Upload Key作成
• key.properties作成
• 本番署名AABビルド
• プライバシーポリシー公開
• アプリアイコン（512x512 PNG）
• スクリーンショット（2枚以上）
• Data Safety申告

推奨（Production）

• フィーチャーグラフィック（1024x500 PNG）
• コンテンツレーティング回答

⚠️ よくある落とし穴

• キーストア紛失によるアプリ更新不可: upload-keystore.jksを紛失するとアプリの更新ができなくなる。パスワードは1Password等で安全に管理し、Play App Signingを有効にしておけばUpload Key紛失時にGoogleがリカバリー可能
• key.propertiesやjksファイルのcommit: 機密情報を含むため.gitignoreに必ず含める。公開リポジトリにpushすると秘密鍵が流出する
• applicationIdの変更: Google Play公開後はapplicationIdを変更できない。com.yourapp.nameは公開前に慎重に確定させること
• MainActivityのパッケージ構造不一致: applicationIdに合わせたディレクトリ構造にMainActivity.ktを配置しないとビルドが通らない。android/app/src/main/kotlin/com/yourapp/name/MainActivity.ktのパス一致を確認する
• flutter cleanなしでのリリースビルド: キャッシュが残っていると署名設定の変更が反映されないことがある。リリースビルド前はflutter clean && flutter pub getを実行してからビルドする