Flutter打包APK记录

第一次打包Flutter APK，还是有点小激动的hh。

1.通过 CMD / 终端命令生成 jks

切换到你想存放 jks 文件的目录（比如项目根目录的 android/key 文件夹，先手动创建 key 文件夹）：

cmd 复制代码

cd D:\ljhwork\android_project\warm_todo\android\key

执行生成命令

cmd 复制代码

keytool -genkey -v -keystore warm_todo.jks -keyalg RSA -keysize 2048 -validity 10000 -alias warm_todo_alias

命令参数解释（按需修改）：

参数	含义
`-keystore warm_todo.jks`	生成的 jks 文件名（自定义，比如你的项目名）
`-keyalg RSA`	加密算法（固定 RSA）
`-keysize 2048`	密钥长度（固定 2048）
`-validity 10000`	有效期（10000 天，约 27 年）
`-alias warm_todo_alias`	别名（自定义，记住即可）

填写信息并设置密码

执行命令后，会依次提示你输入：

密钥库密码（jks 文件的密码，务必记住，比如 123456）；
确认密码；
姓名、组织、城市等信息（可随便填，不影响签名）；
密钥密码（建议和密钥库密码一致）；
确认后，会在当前目录生成 warm_todo.jks 文件。

2. 配置 Flutter 打包时使用 jks

在 android 目录下创建 key.properties 文件，内容如下（替换为你的信息）：

properties 复制代码

storePassword=123456
keyPassword=123456
keyAlias=warm_todo_alias
# 替换为 jks 文件路径（相对于 android 目录）
# 比如你把 jks 放在 android/app/key/warm_todo.jks，就写 key/warm_todo.jks
storeFile=key/warm_todo.jks

打开 android/app/build.gradle.jks，添加签名配置：

kotlin 复制代码

// 🔥 步骤1：导入必要的 Java 核心类（解决 Properties/FileInputStream 未解析）
import java.util.Properties
import java.io.FileInputStream

plugins {
    id(&#34;com.android.application&#34;)
    id(&#34;kotlin-android&#34;)
    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
    id(&#34;dev.flutter.flutter-gradle-plugin&#34;)
}

// 🔥 读取 key.properties（修复类型转换警告）
val keystoreProperties = Properties()
val keystorePropertiesFile = rootProject.file(&#34;key.properties&#34;)
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(FileInputStream(keystorePropertiesFile))
}

android {
    namespace = &#34;com.hluck.warm_todo&#34;
    compileSdk = flutter.compileSdkVersion
    ndkVersion = flutter.ndkVersion

    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }

    // 🔥 步骤2：替换废弃的 jvmTarget，使用 compilerOptions
    kotlin {
        jvmToolchain(17)
        compilerOptions {
            jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_17)
        }
    }

    // 🔥 签名配置（移除多余的类型转换）
    signingConfigs {
        create(&#34;release&#34;) {
            keyAlias = keystoreProperties[&#34;keyAlias&#34;] as String? ?: &#34;&#34;
            keyPassword = keystoreProperties[&#34;keyPassword&#34;] as String? ?: &#34;&#34;
            storeFile = file(keystoreProperties[&#34;storeFile&#34;] as String? ?: &#34;&#34;)
            storePassword = keystoreProperties[&#34;storePassword&#34;] as String? ?: &#34;&#34;
        }
    }

    defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId = &#34;com.hluck.warm_todo&#34;
        // You can update the following values to match your application needs.
        // For more information, see: https://flutter.dev/to/review-gradle-config.
        minSdk = flutter.minSdkVersion
        targetSdk = flutter.targetSdkVersion
        versionCode = flutter.versionCode
        versionName = flutter.versionName
    }

    buildTypes {
        release {
            // 🔥 步骤3：替换为 release 签名配置（原是 debug）
            signingConfig = signingConfigs.getByName(&#34;release&#34;)
        }
    }
}

flutter {
    source = &#34;../..&#34;
}

3.打包发布版 APK

执行 Flutter 打包命令即可生成签名后的 APK：

cmd 复制代码

flutter build apk --release

创建打包脚本

在项目根目录创建 build_apk.sh 文件

sh 复制代码

#!/bin/bash
# 打包并自定义文件名
flutter build apk --release

# 读取版本号
VERSION=$(grep -o 'version: [0-9.]*' pubspec.yaml | cut -d' ' -f2 | cut -d'+' -f1)

# 重命名
cp build/app/outputs/flutter-apk/app-release.apk build/app/outputs/flutter-apk/warm_todo_v${VERSION}-release.apk

# 提示
echo &#34;✅ 打包完成！文件路径：&#34;
echo &#34;build/app/outputs/flutter-apk/warm_todo_v${VERSION}-release.apk&#34;

运行

cmd 复制代码

sh build_apk.sh

恭喜！你已经学会了Flutter打包APk!