1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

💮 flutterのandroid署名手続き

1
Last updated at Posted at 2026-07-20

概要

個人でスマホアプリを作っています。

Google Play に出す準備を進めていたら、「release 署名の設定が必要」という壁に当たりました。keystore、upload key、Play App Signing……初見だと用語が多くて身構えますが、やってみたら役所の手続きみたいなものでした。「このアプリは間違いなく私が作ったものです」と証明するハンコを作って、ビルド時に押すようにする。それだけです。

同じところで止まっている人のために(あと未来の自分のために)、やったことを簡潔にまとめます。Flutter プロジェクト前提ですが、考え方は Android 共通です。

そもそも署名ってなに?

  • Google Play に出すアプリには「作った本人の証明」となる電子署名が必須
  • ハンコの実体は keystore というパスワード付きのファイル
  • Flutter の新規プロジェクトは「誰でも持っている練習用ハンコ(debug 署名)」のままなので、そのままでは提出できない

android/app/build.gradle.kts にこういう TODO が残っていたら、debug 署名のままです。

release {
    // TODO: Add your own signing config for the release build.
    signingConfig = signingConfigs.getByName("debug")
}

やることは3ステップ

  1. keytool で keystore(ハンコ)を作る
  2. key.properties(ハンコの場所とパスワードのメモ)を作る
  3. build.gradle.kts に「リリースビルド時はこのハンコを押す」設定を書く

📌 ステップ1:keystore を作る

mkdir -p ~/keystores/your-app

"/Applications/Android Studio.app/Contents/jbr/Contents/Home/bin/keytool" \
  -genkey -v \
  -keystore ~/keystores/your-app/upload-keystore.jks \
  -keyalg RSA -keysize 2048 -validity 10000 \
  -alias upload

chmod 600 ~/keystores/your-app/upload-keystore.jks

keytool をフルパスで呼んでいるのは、macOS 標準の /usr/bin/keytool が Java Runtime なしでは動かななかったためです。Android Studio を入れていれば同梱の keytool がそのまま使えます。

実行すると対話形式でパスワードと識別情報を聞かれます。姓名・組織などは何を入れてもよく、ストアに表示されることもありません。パスワードだけは絶対に忘れないように保管してください。

📌 ステップ2:key.properties を作る

android/key.properties を作り、ハンコの場所とパスワードを書きます。

storePassword=<keystoreのパスワード>
keyPassword=<同じもの>
keyAlias=upload
storeFile=/Users/あなた/keystores/your-app/upload-keystore.jks

⚠️ パスワードが平文で入るので、gitignore されていることを必ず確認してください。最近の Flutter テンプレートは android/.gitignore に key.properties が最初から入っていますが、確認は一瞬です。

git check-ignore android/key.properties && echo OK

📌 ステップ3:build.gradle.kts を直す

android/app/build.gradle.kts に「key.properties を読んで release ビルドに署名する」設定を書きます。

import java.util.Properties
import java.io.FileInputStream

// release 署名の情報を key.properties(gitignore 済み)から読む
val keystoreProperties = Properties()
val keystorePropertiesFile = rootProject.file("key.properties")
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(FileInputStream(keystorePropertiesFile))
}

android {
    signingConfigs {
        create("release") {
            keyAlias = keystoreProperties["keyAlias"] as String?
            keyPassword = keystoreProperties["keyPassword"] as String?
            storeFile = (keystoreProperties["storeFile"] as String?)?.let { file(it) }
            storePassword = keystoreProperties["storePassword"] as String?
        }
    }
    buildTypes {
        release {
            // key.properties が無い環境でもビルドが通るよう debug 署名へフォールバック
            signingConfig = if (keystorePropertiesFile.exists()) {
                signingConfigs.getByName("release")
            } else {
                signingConfigs.getByName("debug")
            }
        }
    }
}

動作確認

署名設定が効いているかは signingReport で見られます。

cd android && ./gradlew :app:signingReport -q

release の欄に自分の keystore のパスと Alias: upload が出ていれば成功です。あとは flutter build appbundle で、Play に提出できる署名済み AAB ができます。

注意:バックアップだけは忘れずに

Play App Signing のおかげで鍵の紛失は致命傷ではなくなりましたが、リセット申請には数日かかり、その間リリース作業が止まります。

  • パスワード → パスワードマネージャーへ
  • keystore ファイル → 外部ドライブなどに控えを

この2つだけはやっておきましょう。

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?