FlutterでAndroidのリリースビルドを作る手順|keystoreの作成からflutter build appbundleでAABを作るまで

このページには広告が含まれる場合があります。

 

※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つです。

  1. keystore(アップロード鍵)を作る
  2. android/key.properties に、keystoreの場所とパスワードを書く
  3. android/app/build.gradle.kts に、署名の設定を書く
  4. 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 upload

Windows(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の公式ドキュメントで紹介されている探し方は、次のとおりです。

  1. ターミナルで flutter doctor -v を実行する
  2. 出てきた中の「Java binary at:」の後ろにある場所を見る
  3. その場所の最後の 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か所です。

  1. ファイルの一番上に、import を2行
  2. android { の前に、key.properties を読み込む行
  3. 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 appbundle

flutter build は、何も付けなければリリース版を作ります。終わると、AABが次の場所にできます。

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

Flutterの公式ドキュメントには 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=2

APKが欲しいとき

Google Playに出すならAABですが、手元の端末に入れて試したいときなどは、APKも作れます。

flutter build apk --split-per-abi

Flutterの公式ドキュメントでは、このコマンドで 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. よくあるつまずき

ここまでの手順で、初めての方がはまりやすい所をまとめておきます。

  1. buildTypes が "debug" のまま

signingConfigsを足しても、release の中が getByName("debug") のままだと、デバッグの鍵で署名されます。手順3の最後の行を見直します。

  1. key.properties の場所や、storeFile のパスが違う

key.properties は android の直下、storeFile はkeystoreのファイルまでのフルパスで書くと迷いません。Windowsの \ は2つ重ねます。

  1. 前と同じversionCodeのまま上げようとした

pubspec.yaml の + の後ろを増やしてから、もう一度ビルドします。

  1. applicationId が com.example のまま

Flutterの公式ドキュメントでは、applicationIdは他と重ならないものにし、Play ストアにアップロードしたあとは変えられない、とされています。最初のアップロードの前に、build.gradle.kts の defaultConfig の中の applicationId を確かめておきます。

  1. 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 アプリ署名ならリセットをリクエストできる

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

【無料】生年月日を入力するだけ!

あなたの知らない「あなた」がわかる
無料診断ツール

あすコロ式
使命・性格タイプ診断

生年月日を入力するだけで144通りの性格パターンを診断。あなたの知らない「本当のあなた(生きる目的・使命)」と「偽りのあなた(無意識の思いグセ)」がわかります!

今すぐ無料で診断する ▶
GAMBO(願望) ✦ 願望実現・目標達成の
17秒 / 68秒ワーク
GAMBO(願望) 引き寄せ難民だったぼくの挫折経験から生まれた誰でもできる願望実現サポートアプリ。かの有名な17秒/68秒ワークを独自の視覚化メソッドで簡単実践。
App Store / Google Play 詳しく見る →
Meiso(瞑想) ◎ 鐘音と自然音で
5分からのマインドフルネス
Meiso(瞑想) 初心者でも“迷わず続けられる”ことにこだわった、完全無料の瞑想アプリ。画面のガイドに従うだけで呼吸のリズムが整い、最短5分から瞑想を実践できます。
App Store / Google Play 詳しく見る →
小学生からの英検®単語 A ふりがな・音声付き
英検単語1日5分トレーニング
小学生からの英検®単語 ありそうでなかった!ふりがな付き英検®単語トレーニングアプリ!1日たった5分!スキマ時間を活用して、英検®頻出単語を効率的に習得。お子様の一人学習にも安心設計。
App Store / Google Play 詳しく見る →
オボエルンジャー ★ レトロゲームで
nバック脳トレ
オボエルンジャー 科学的脳力開発法「Nバック課題」をファミコン風8bitレトロゲームにアレンジした新感覚脳トレアプリ。記憶力・感情コントロール力・集中力の向上に。
App Store / Google Play 詳しく見る →
ゴイコイコイ 語 超高速フラッシュカードで
語彙習得
ゴイコイコイ 日常語1400語を視覚的に学べる、高速読み上げフラッシュカード式の語彙トレーニングアプリ。知育教室で行われるフラッシュカード学習を、家庭で“手軽に・安価に・正確に”再現。
App Store / Google Play 詳しく見る →

TOP