Capacitor + React製AndroidアプリをGoogle Playに申請するまでの全手順まとめ

はじめに

個人開発したAndroidアプリをGoogle Playに申請した際の手順をまとめます。Capacitorを使ったWebアプリのAndroid化からAABビルド・署名・申請まで一通り記録しました。

環境

• Windows 11
• Android Studio（JBR JDK使用）
• Capacitor 6
• React 19 + Vite

1. リリース用署名キーストアの作成

$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
& "$env:JAVA_HOME\bin\keytool" -genkeypair -v `
  -keystore wanko-release.jks `
  -alias wanko `
  -keyalg RSA -keysize 2048 `
  -validity 10000

生成した .jks ファイルは絶対にGitにコミットしないこと。紛失するとアプリの更新ができなくなるので外部にバックアップを取ること。

2. keystore.propertiesの作成（gitignore必須）

android/keystore.properties を作成し、.gitignore に追加します。

storeFile=wanko-release.jks
storePassword=YOUR_PASSWORD
keyAlias=wanko
keyPassword=YOUR_PASSWORD

3. build.gradleの設定

def keystorePropertiesFile = rootProject.file("keystore.properties")
def keystoreProperties = new Properties()
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
    signingConfigs {
        release {
            storeFile rootProject.file(keystoreProperties['storeFile'])
            storePassword keystoreProperties['storePassword']
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
        }
    }
}

rootProject.file() を使わないとandroid/ディレクトリ基準にならないので注意。

4. AABのビルド

$env:JAVA_HOME = "C:\Program Files\Android\Android Studio\jbr"
npm run build
npx cap sync android
cd android
.\gradlew bundleRelease

出力先：android/app/build/outputs/bundle/release/app-release.aab

5. Play Consoleへのアップロード手順

1. Play Console → クローズドテスト → 新しいリリースを作成
2. App BundleにAABをアップロード
3. リリース名・リリースノートを入力して保存
4. 「審査に送信」をクリック

注意点：新規アカウントはクローズドテスト必須

2023年11月以降に作成した個人デベロッパーアカウントは、本番公開前に12人以上・14日間のクローズドテストが必要です（2024年12月に20人から12人に緩和されました）。

テスターはGoogleグループで管理しているため、先にグループへ参加してからテスト参加URLを開いてもらう必要があります。

1. Googleグループに参加：https://groups.google.com/g/wanko-tester
2. テスト参加URLを開いて「テスターになる」
   • Androidスマホから：https://play.google.com/store/apps/details?id=jp.it_study.dog_pocket_notebook
   • PC・ブラウザから：https://play.google.com/apps/testing/jp.it_study.dog_pocket_notebook
3. アプリをインストールして14日間そのままにしておく

なお「Androidで参加」のリンクはオプトインがカウントされないケースが報告されているため、確実を期すなら「ウェブで参加」URLを推奨します。

現在テスターを募集しています。Androidをお持ちの方はぜひご協力ください！