※2026年11月13日に、Flutter・Android・Google Playの公式ドキュメントで確かめた内容です(Flutterの公式ドキュメントは、この時点でFlutter 3.50を前提に書かれています)。コマンドの動き方やファイルの中身は、Flutterのバージョンや環境によって異なります。
「Google Playに出したいけど、flutter build appbundle を打つ前に何をすればいいのかわからない」
「keystore、key.properties、signingConfigs……出てくる言葉が多すぎる」
Androidのアプリを初めてリリースするとき、ここで手が止まる方は多いんじゃないでしょうか。
先に答えを書くと、FlutterでAndroidのリリースビルド(AAB)を作る手順は、次の4つです。
- keystore(アップロード鍵)を作る
android/key.propertiesに、keystoreの場所とパスワードを書くandroid/app/build.gradle.ktsに、署名の設定を書くflutter build appbundleを打つ
出来上がったAABは、build/app/outputs/bundle/release/app-release.aab に置かれます。これをGoogle Play Consoleにアップロードします。
1〜3は、アプリごとに最初の1回だけの作業です。2回目からは、バージョンの番号を上げて4を打つだけになります。
もくじ
1. なぜ、署名の設定が要るのか
Flutterで作ったばかりのプロジェクトは、flutter build appbundle を打てば、いちおうAABが出来上がります。ところが、ひな形の設定のままだと、そのAABはデバッグ用の鍵で署名されています。
android/app/build.gradle.kts の buildTypes の中を見ると、次のような行があります。
buildTypes {
release {
// TODO: Add your own signing config for the release build.
// Signing with the debug keys for now,
// so `flutter run --release` works.
signingConfig = signingConfigs.getByName("debug")
}
}コメントにあるとおり、「今はデバッグの鍵で署名しておく」という仮の設定なんです。
「えっ、リリース版なのに、まだデバッグの鍵で署名されてたん!?」
と言いたくなりますが、Androidの公式ドキュメントでは、デバッグ用の証明書はビルドツールが作る、もともと安全でないものなので、Google Playを含むほとんどのストアは、デバッグ用の証明書で署名したアプリを受け付けない、とされています。
だから、自分の鍵(アップロード鍵)を作って、リリースビルドをその鍵で署名するように設定し直す必要があるんです。
鍵は2種類ある
Google Playでは、鍵が2つ出てきます。
| 鍵 | 持っている人 | 使い道 |
|---|---|---|
| アップロード鍵 | 自分 | Play Consoleにアップロードする前に、AABに署名する |
| アプリ署名鍵 | Google Play | ユーザーの端末に届けるAPKに署名する |
この記事で作るのは、アップロード鍵のほうです。アプリ署名鍵は、Google Playの「Play アプリ署名」の仕組みで、Google Playが持って管理します。Androidの公式ドキュメントでは、2021年8月以降に作られたアプリは、Google Playで配るためにPlay アプリ署名の設定が要る、とされています。同じく2021年8月から、新しいアプリはAAB(Android App Bundle)で出すことになっています。
参考:Build and release an Android app(Flutter docs、2026年11月13日確認)/Sign your app・About Android App Bundles(いずれもAndroid Developers、2026年11月13日確認)/Play アプリ署名を使用する(Play Console ヘルプ、2026年11月13日確認)
2. 手順1:keystore(アップロード鍵)を作る
keystoreは、鍵をしまっておくファイルです。Flutterの公式ドキュメントでは、Javaに付いてくる keytool というコマンドで作る方法が紹介されています。
Mac・Linuxの場合
keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA \
-storetype JKS -keysize 2048 -validity 10000 -alias uploadWindows(PowerShell)の場合
keytool -genkey -v -keystore $env:USERPROFILE\upload-keystore.jks `
-storetype JKS -keyalg RSA -keysize 2048 -validity 10000 `
-alias upload打つと、keystoreのパスワードと、名前などの証明書の情報を聞かれます。Androidの公式ドキュメントでは、証明書の情報はアプリの画面には出ない、とされています。鍵のパスワードも聞かれたら、keystoreのパスワードと同じにしておくのが無難です(Android Studioで鍵を作る手順でも、同じにするよう書かれています)。
このコマンドで、ホームフォルダに upload-keystore.jks というファイルができます。置き場所を変えたいときは、-keystore の後ろを書き換えます。
コマンドの中身は、次のような意味です。
-alias upload:鍵の名前。あとで key.properties に書きます-validity 10000:鍵の有効期間(日数)。10000日なので、およそ27年です-storetype JKS:keystoreの形式。Flutterの公式ドキュメントでは、Java 9以降では既定の形式がPKCS12なので、JKSにするにはこの指定が要る、とされています
有効期間については、Androidの公式ドキュメントで25年以上が勧められていて、Google Playに出すアプリは、署名の鍵の有効期間が2033年10月22日より後まで続いている必要がある、とされています。公式の例の10000日なら、この条件を満たします。
「keytool が見つからない」と言われたら
keytool は、Android Studioと一緒に入るJavaに付いています。パスが通っていないと「command not found」になります。
Flutterの公式ドキュメントで紹介されている探し方は、次のとおりです。
- ターミナルで
flutter doctor -vを実行する - 出てきた中の「Java binary at:」の後ろにある場所を見る
- その場所の最後の
javaをkeytoolに置き換えて、そのまま打つ
場所に空白が入っているときは、Mac・Linuxなら Program\ Files のように空白の前に \ を、Windowsなら "Program Files" のように " で囲みます。
コマンドではなく、Android Studioの画面から作る方法もあります。Androidの公式ドキュメントでは、Build → Generate Signed Bundle/APK → Android App Bundle を選び、Key store path の下の「Create new」から作る手順になっています。
参考:Build and release an Android app(Flutter docs、2026年11月13日確認)/Sign your app(Android Developers、2026年11月13日確認)
3. 手順2:key.properties を作る
次に、keystoreの場所とパスワードを書いたファイルを作ります。場所は、プロジェクトの android フォルダの直下です。
android/key.properties
storePassword=keystoreのパスワード
keyPassword=鍵のパスワード
keyAlias=upload
storeFile=keystoreのファイルの場所storeFile は、Flutterの公式ドキュメントの例では、Macなら /Users/ユーザー名/upload-keystore.jks、Windowsなら C:\\Users\\ユーザー名\\upload-keystore.jks です。Windowsは、\ を2つ重ねて書きます。
このファイルには、パスワードがそのまま書かれています。 Flutterの公式ドキュメントでも、key.properties とkeystoreのファイルは、公開のソース管理に入れないように、と書かれています。
Flutterで新しく作ったプロジェクトなら、android/.gitignore に、最初から次の行が入っています(FlutterのGitHubにある、プロジェクトのひな形で確かめました)。
key.properties
**/*.keystore
**/*.jks古いプロジェクトでは入っていないこともあるので、GitHubなどにプッシュする前に、一度 android/.gitignore を開いて確かめておくと安心です。
参考:Build and release an Android app(Flutter docs、2026年11月13日確認)/プロジェクトのひな形の android/.gitignore(Flutter の GitHub、2026年11月13日確認)
4. 手順3:build.gradle.kts に署名の設定を書く
いよいよ、リリースビルドを自分の鍵で署名するように設定します。開くのは android/app/build.gradle.kts です(android の直下ではなく、app の中のほうです)。
Flutterの公式ドキュメントでは、この build.gradle.kts を、Androidのビルドの既定のファイルとして説明しています。プロジェクトを作った時期によっては、拡張子のない build.gradle(Groovyという書き方)のこともあります。その場合は、この節の最後の書き方を見てください。
Kotlin(build.gradle.kts)の場合
足すのは、次の3か所です。
- ファイルの一番上に、
importを2行 android {の前に、key.properties を読み込む行android {の中にsigningConfigsを足し、buildTypesのreleaseの中の"debug"を"release"に変える
足し終わると、次のような形になります。
import java.util.Properties
import java.io.FileInputStream
plugins {
// もとからある行は、そのまま
}
val keystoreProperties = Properties()
val keystorePropertiesFile = rootProject.file("key.properties")
if (keystorePropertiesFile.exists()) {
keystoreProperties.load(FileInputStream(keystorePropertiesFile))
}
android {
// もとからある行は、そのまま
signingConfigs {
create("release") {
keyAlias = keystoreProperties.getProperty("keyAlias")
keyPassword = keystoreProperties.getProperty("keyPassword")
storeFile = keystoreProperties.getProperty("storeFile")?.let { file(it) }
storePassword = keystoreProperties.getProperty("storePassword")
}
}
buildTypes {
release {
signingConfig = signingConfigs.getByName("release")
}
}
}rootProject.file("key.properties") は、android フォルダの直下の key.properties を指しています。手順2で置いた場所と合っているかを、ここで確かめてください。
buildTypes の release の中は、getByName("debug") を消して、getByName("release") にします。 ここを直し忘れると、せっかく作った鍵が使われず、デバッグの鍵のままになります。
Groovy(build.gradle)の場合
古いプロジェクトで android/app/build.gradle のときは、同じ中身を次のように書きます。
import java.util.Properties
import java.io.FileInputStream
plugins {
// もとからある行は、そのまま
}
def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}
android {
// もとからある行は、そのまま
signingConfigs {
release {
keyAlias = keystoreProperties['keyAlias']
keyPassword = keystoreProperties['keyPassword']
storeFile = keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
storePassword = keystoreProperties['storePassword']
}
}
buildTypes {
release {
signingConfig = signingConfigs.release
}
}
}Flutterの公式ドキュメントでは、Gradleのファイルを直したあとは、前のビルドの残りが署名に影響しないように、flutter clean が要ることがある、とされています。設定を書き終えたら、一度 flutter clean してから次の手順に進むと確実です。
参考:Build and release an Android app(Flutter docs、2026年11月13日確認)
5. 手順4:flutter build appbundle でAABを作る
設定ができたら、プロジェクトのフォルダで次のコマンドを打ちます。
flutter build appbundleflutter build は、何も付けなければリリース版を作ります。終わると、AABが次の場所にできます。
build/app/outputs/bundle/release/app-release.aabFlutterの公式ドキュメントには app.aab と書かれていますが、実際にできるファイルの名前は app-release.aab です(Flutter本体のテストも、この名前のファイルができることを確かめています)。
android フォルダの中ではなく、プロジェクトの一番上の build フォルダの中です。「で、AABはどこにできてるねん!?」となったら、ここを見てください。
Flutterの公式ドキュメントでは、このAABには、DartのコードとFlutterの実行環境が、armeabi-v7a(ARMの32ビット)・arm64-v8a(ARMの64ビット)・x86-64の3つ向けに入っている、とされています。端末ごとに合うものを選んで届けるのは、Google Playの側の仕事です。
バージョンの番号を上げる
2回目からのアップロードで忘れやすいのが、バージョンの番号です。
番号を書く所は、Androidの設定ファイルではなく、プロジェクトの一番上にある pubspec.yaml の version の行です。
version: 1.0.0+1+ の前(1.0.0)がユーザーに見える番号(versionName)、+ の後ろ(1)がversionCodeになります。Androidの公式ドキュメントでは、前のバージョンで使ったversionCodeでは、Play ストアにアップロードできない、とされています。だから、上げるたびに + の後ろの数を増やします。
コマンドで一時的に変えたいときは、--build-name と --build-number で上書きできます。
flutter build appbundle --build-name=1.0.1 --build-number=2APKが欲しいとき
Google Playに出すならAABですが、手元の端末に入れて試したいときなどは、APKも作れます。
flutter build apk --split-per-abiFlutterの公式ドキュメントでは、このコマンドで build/app/outputs/flutter-apk/ の中に、端末の種類ごとのAPKが3つできる、とされています(app-arm64-v8a-release.apk など)。
参考:Build and release an Android app(Flutter docs、2026年11月13日確認)/gradle_plugin_bundle_test.dart(Flutter の GitHub、2026年11月13日確認)/Version your app(Android Developers、2026年11月13日確認)
6. よくあるつまずき
ここまでの手順で、初めての方がはまりやすい所をまとめておきます。
buildTypesが"debug"のまま
signingConfigsを足しても、release の中が getByName("debug") のままだと、デバッグの鍵で署名されます。手順3の最後の行を見直します。
- key.properties の場所や、storeFile のパスが違う
key.properties は android の直下、storeFile はkeystoreのファイルまでのフルパスで書くと迷いません。Windowsの \ は2つ重ねます。
- 前と同じversionCodeのまま上げようとした
pubspec.yaml の + の後ろを増やしてから、もう一度ビルドします。
- applicationId が com.example のまま
Flutterの公式ドキュメントでは、applicationIdは他と重ならないものにし、Play ストアにアップロードしたあとは変えられない、とされています。最初のアップロードの前に、build.gradle.kts の defaultConfig の中の applicationId を確かめておきます。
- Android Studioのメニューから作ったら、AABの場所が違う
Android Studioの Generate Signed Bundle/APK から作ったときは、ウィザードの最後の画面で選んだ保存先にできます。コマンドで作ったときの build/app/outputs/bundle/release/ とは別の場所になることがあるので、作り終わったときに出る「locate」の通知か、ウィザードで選んだ場所を見ます。
参考:Build and release an Android app(Flutter docs、2026年11月13日確認)/Sign your app(Android Developers、2026年11月13日確認)
ビルドの途中で、JavaやGradleのバージョンの赤いエラーが出て止まるときは、署名ではなく、ビルドの道具の組み合わせの問題です。
(Gradleのエラーの見分け方と直し方は、こちらの記事でも書いていますので、よろしければご覧ください)
7. keystoreとパスワードを、なくさないために
AABができたら、最後にもう1つだけ、やっておいてほしいことがあります。
keystoreのファイルと、パスワード2つと、エイリアス(upload)を、なくさない所に控えておくことです。
keystoreは、アプリを作ったときに1回作ったら、次に触るのはアップデートのときです。それが何か月も先になると、どこに置いたか、パスワードは何だったかを、すっかり忘れてしまいがちです。
ぼくも講座で教えていたとき、自分で作った教材に何を書いたかを思い出せず、講義の最中に探したことがあります。「作った本人であれや、もう忘れてしまってるという最低な状況なんですけど」と、受講生の前で笑いにしました。作った本人でも、人は忘れるんです。
Play アプリ署名を使っていれば、もしアップロード鍵をなくしても、アプリが終わりになるわけではありません。Play Console ヘルプでは、アップロード鍵をなくしたり、不正に使われた疑いがあったりしても、アプリを利用できなくなることはない、とされています。新しいアップロード鍵を作り、Play Consoleの「Play アプリ署名」のページから、アップロード鍵のリセットをリクエストする流れです。
ただ、リセットには手間がかかります。手元のkeystoreを、パソコンの外にもバックアップしておく方が、ずっと楽です。
(アップロード鍵をなくしたときの対処は、2023年にこちらの記事で書いています。画面は今と違うところがあるかもしれませんので、今の手順はPlay Console ヘルプでも確かめてください)
参考:Play アプリ署名を使用する(Play Console ヘルプ、2026年11月13日確認)/Sign your app(Android Developers、2026年11月13日確認)
8. AABができたら、次はPlay Consoleへ
AABができたら、Google Play Consoleにアップロードします。
ここで気をつけたいのが、新しい個人のデベロッパーアカウントの場合です。Play Console ヘルプでは、2023年11月13日以降に作った個人用アカウントは、12人以上のテスターが14日間続けてオプトインした状態で、クローズドテストを行う必要がある、とされています。その場合、作ったAABは、まずクローズドテストのトラックに上げることになります。
参考:新しい個人用デベロッパー アカウント向けのアプリテスト要件(Play Console ヘルプ、2026年11月13日確認)
(クローズドテストの進め方は、こちらの記事でも書いていますので、よろしければご覧ください)
Play Consoleでの申請に不安がある方へ
署名したAABができても、そのあとのPlay Consoleでは、ストアの掲載情報、データセーフティ、コンテンツのレーティングと、初めての方には見慣れない入力が続きます。どこまで埋めれば審査に出せるのかを、ひとりで見通すのは、意外と大変ですよね。
ぼくも自社アプリをFlutterで作り、Google PlayとApp Storeに出してきました。ぼくのGoogle Playリリースサポート・代行では、審査への提出から承認の確認までを、Zoomで一緒に進めることも、ぼくが代わりに行うこともできます。リジェクトされたときは、原因を見て、再申請までお手伝いします。ビルドの素材は、署名済みのAABのほか、プロジェクトのzipファイルや、GitHubへの招待でも受け付けています(2023年11月13日以降に作った個人のアカウントで、そのアプリを初めて本番に出すときは、先にクローズドテストを終えておく必要があります。一度本番に出したあとのアップデートでは、やり直さなくて大丈夫です)。よろしければ、お気軽にご相談ください。
まとめ
参考:Build and release an Android app(Flutter docs、2026年11月13日確認)/Sign your app・About Android App Bundles・Version your app(いずれもAndroid Developers、2026年11月13日確認)/Play アプリ署名を使用する(Play Console ヘルプ、2026年11月13日確認)
何かのお役に立てれば幸いです。
- FlutterでAndroidのリリースビルド(AAB)を作る手順は、①keystoreを作る ②key.propertiesを書く ③build.gradle.ktsに署名の設定を書く ④
flutter build appbundleの4つ - ひな形のままだと、リリースビルドはデバッグの鍵で署名されている。Google Playはデバッグの鍵で署名したアプリを受け付けない
- 自分で作るのはアップロード鍵。アプリ署名鍵は、Play アプリ署名でGoogle Playが持つ
- keystoreは
keytoolで作る。見つからないときはflutter doctor -vの「Java binary at:」の場所を使う - key.properties とkeystoreは、ソース管理に入れない。新しいプロジェクトの
android/.gitignoreには最初から入っている build.gradle.ktsは、signingConfigsを足し、buildTypesのreleaseをgetByName("release")に変える。直したらflutter clean- AABは
build/app/outputs/bundle/release/app-release.aabにできる - 2回目からは、
pubspec.yamlのversionの+の後ろ(versionCode)を増やしてからビルドする - keystore・パスワード2つ・エイリアスは、パソコンの外にも控えておく。アップロード鍵をなくしても、Play アプリ署名ならリセットをリクエストできる
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。








