---

name: google-play-publish description: Google Play Console でAndroidアプリを公開するワークフロー。Flutter/Androidアプリのリリースビルド作成、署名キー管理、ストア掲載情報の準備、審査提出までをカバー。「Androidアプリ公開」「Google Play にアップロード」「ストアリスト作成」「リリースビルド」などの作業に使う。

Google Play Publish

FlutterまたはネイティブAndroidアプリをGoogle Playに公開するためのワークフロー。

前提条件

• Google Play Developer アカウント（$25の登録料）
• 公開するアプリのソースコード
• Flutter SDK または Android Studio

ワークフロー概要

1. 事前準備
   ├── アプリID（applicationId）の確定
   ├── バージョン番号の設定
   └── アイコン・スクリーンショットの準備

2. 署名キーの作成・設定
   ├── keystore ファイル生成
   ├── key.properties 作成
   └── build.gradle 署名設定

3. リリースビルド
   └── App Bundle (.aab) 生成

4. Google Play Console 設定
   ├── アプリ作成
   ├── ストアリスト情報入力
   ├── コンテンツレーティング
   ├── ターゲットユーザー設定
   └── プライバシーポリシー

5. リリース提出
   ├── 内部テスト or クローズドテスト
   └── 製品版リリース

1. 事前準備

Application ID の確認・設定

android/app/build.gradle.kts (または build.gradle):

defaultConfig {
    applicationId = "com.yourcompany.yourapp"  // 世界で一意
    ...
}

命名規則:

• リバースドメイン形式: com.company.appname
• 小文字・数字・ドット・アンダースコアのみ
• 一度公開すると変更不可

バージョン設定

pubspec.yaml (Flutter):

version: 1.0.0+1  # versionName+versionCode

• versionName: ユーザーに表示（1.0.0）
• versionCode: 内部管理用、アップデートごとに増加

アセット準備チェックリスト

• アプリアイコン（512x512 PNG、透過なし）
• フィーチャーグラフィック（1024x500 PNG/JPG）
• スクリーンショット（最低2枚、推奨4-8枚）
  • スマホ: 16:9 または 9:16
  • タブレット: 16:9（7インチ/10インチ用、任意）
• 短い説明文（80文字以内）
• 詳細な説明文（4000文字以内）

2. 署名キーの作成・設定

重要: keystoreファイルとパスワードは絶対にGitにコミットしない。紛失するとアプリのアップデートが永久に不可能になる。

• Keystore 生成スクリプト → scripts/generate-keystore.sh
• key.properties と build.gradle.kts の署名設定 → references/config-signing.md
• 難読化解除ファイル（mapping.txt）の管理 → references/config-signing.md

3. リリースビルド

ビルドスクリプト → scripts/build-release.sh

• App Bundle（推奨）: scripts/build-release.sh
• APK（代替）: scripts/build-release.sh --apk
• 出力: build/app/outputs/bundle/release/app-release.aab

4. Google Play Console 設定

詳細手順 → references/console-setup.md

主な設定項目:

1. アプリの作成（名前、言語、無料/有料）
2. ストアリスト（説明文、アイコン、スクリーンショット）
3. コンテンツレーティング（IAQRアンケート回答）
4. ターゲットユーザー（年齢層選択）
5. プライバシーポリシー（外部URL必須）

5. リリース提出

詳細手順 → references/release-process.md

⚠️ 個人アカウントの本番公開要件（2023年11月以降作成）

2023年11月13日以降に作成された個人アカウントは、本番公開前に以下が必須:

1. クローズドテストを実施（12人 × 14日間）
2. 本番アクセス申請
3. 審査通過

内部テストだけでは本番公開できない。詳細は references/release-process.md を参照。

⚠️ よくある落とし穴

• keystore の紛失・Git コミット: keystore ファイルとパスワードを Git にコミットすると漏洩リスク。紛失するとアプリのアップデートが永久に不可能になる。安全な場所にバックアップし、.gitignore に必ず追加
• 個人アカウントの本番公開要件を知らない: 2023年11月以降作成の個人アカウントは、クローズドテスト（12人×14日間）+ 本番アクセス申請が必須。内部テストだけでは本番公開できない
• 署名エラー (validateSigningRelease): key.properties のパス・パスワードが間違っている。絶対パスの記述ミスが多い
• 審査リジェクト: よくある理由はプライバシーポリシーURLが無効、スクリーンショットがガイドライン違反、コンテンツレーティングが実際と不一致、権限の説明不足
• applicationId の変更不可: 一度公開すると applicationId は変更できない。最初に慎重に決めること
• mapping.txt の不一致: リリースビルドごとに mapping.txt は異なる。リリースする aab と対応する mapping.txt をセットで管理しないとクラッシュログが読めなくなる

References

• references/config-signing.md - 署名設定（key.properties, build.gradle.kts, mapping.txt）
• references/console-setup.md - Google Play Console 設定詳細
• references/release-process.md - テストトラックとリリース提出プロセス
• references/privacy-policy-template.md - プライバシーポリシーテンプレート
• scripts/generate-keystore.sh - Keystore 生成スクリプト
• scripts/build-release.sh - リリースビルドスクリプト

---

このスキルは実際の公開作業を通じて継続的に更新される