AndroidアプリをGoogle Playに公開するまでの完全手順（ハマりポイント付き）

個人開発で Android アプリを作って、  
**Play Console にアップ → 内部テスト → 本番公開**までやったので、その手順をまとめます。

👉 特に **versionCode まわりで詰まったので、そこは重点的に書きます。**
---

# 🎯 全体の流れ

1. build.gradle.kts を設定
2. AAB（App Bundle）を作成
3. Play Console にアプリ登録
4. 内部テストで動作確認
5. 本番公開

---

# ① build.gradle.kts の設定（最重要）

ここが一番大事です。

```kotlin
android {
    namespace = "com.kikoushi.schoolviewer"

    defaultConfig {
        applicationId = "com.kikoushi.schoolviewer"
        minSdk = 26
        targetSdk = 35

        versionCode = 1
        versionName = "1.0"
    }
}

---

❗ 最大のハマりポイント：versionCode

エラー例

バージョンコードはすでに使用されています

---

💡 原因

👉 Google Play の仕様

• versionCode は「一意」
• 同じ番号は二度使えない

---

✅ 解決方法

versionCode = 2
versionName = "1.0.1"

👉 毎回こうする

1 → 2 → 3 → 4 → …

---

🧠 ポイント

項目	意味
versionCode	内部番号（必ず増やす）
versionName	表示用（自由）

---

② AAB（App Bundle）を作成

コマンド

./gradlew clean :app:bundleRelease

---

出力先

app/build/outputs/bundle/release/app-release.aab

---

③ Play Console に登録

1. アプリ作成
2. パッケージ名入力
3. ストア情報入力

---

④ 内部テスト

手順

1. 「テストとリリース」→「内部テスト」
2. 「新しいリリースを作成」
3. AABアップロード
4. テスター追加
5. リンク取得

---

テスト方法

1. テスターリンクをスマホで開く
2. 「テスターになる」
3. インストール

---

❗ よくあるエラー

❌ App not available

👉 原因

• Googleアカウント違う
• テスター登録されてない

---

⑤ クラッシュした場合（重要）

adb logcat で確認

~/Library/Android/sdk/platform-tools/adb devices

~/Library/Android/sdk/platform-tools/adb -s <device> logcat

---

よくある原因

❌ ClassNotFoundException

Didn't find class com.kikoushi.schoolviewer.MainActivity

👉 原因

• package 名ズレ

---

修正

package com.kikoushi.schoolviewer

👉 全ファイル統一

---

⑥ 本番公開

注意

👉 日本語UIでは「本番」ではなく

製品版

---

手順

1. 「製品版」クリック
2. 新しいリリース作成
3. AABアップロード
4. 審査送信

---

⏱ 審査時間

状況	時間
通常	数時間〜1日
初回	少し長い

---

❗ 削除について

👉 versionは削除できない

---

正しい運用

v1 → v2 → v3 → v4

👉 上書きではなく積み上げ

---

💡 プライバシーポリシー

最低限でOK

個人情報は収集していません

👉 Notionなどで公開URL作る

---

🎉 まとめ

一番重要な3つ

• versionCode は毎回上げる
• package 名は統一する
• 内部テストで確認する

---

👍 感想

👉 正直、一番ハマったのは

• versionCode
• package 名

---

👉 ここを理解すれば
👉 Play Console はそこまで難しくない

---

🚀 おわりに

ここまで来れば👇

👉 誰でもアプリ公開できます