flutter 打包指定apk名称

### 使用 Flutter 打包生成 APK 文件 #### 准备工作 为了成功创建 APK 文件，开发者需先确保项目的配置无误并完成必要的设置。对于初次尝试打包的新手而言，掌握基础的签名流程至关重要[^3]。 #### 创建密钥库文件 第一步涉及生成用于签署应用程序的密钥库文件。这一步骤通过命令行工具 keytool 完成，该工具随 JDK 提供。具体指令如下所示： ```bash keytool -genkeypair -v -keystore my-release-key.keystore -alias alias_name -keyalg RSA -keysize 2048 -validity 10000 ``` 此命令会提示输入密码和其他细节信息来建立新的 keystore 和私钥对。 #### 配置 `build.gradle` 文件 接着，在 Android 工程目录下的 `app/build.gradle` 中指定刚才创建好的密钥路径及其他参数。这部分内容应放置于 android {} 节点内部： ```groovy android { ... signingConfigs { release { storeFile file('my-release-key.jks') storePassword 'your_store_password' keyAlias 'your_key_alias' keyPassword 'your_key_password' } } buildTypes { release { ... signingConfig signingConfigs.release } } } ``` 上述代码片段展示了如何将签名配置应用到发布版本上。 #### 构建 APK 当一切准备就绪后，可以通过运行以下命令来进行最终构建过程： ```bash flutter build apk --release ``` 这条命令将会依据之前所做的设定编译出已签名的应用程序安装包 (APK)，适用于分发给用户或上传至 Google Play 商店[^1]。 如果仅希望针对特定架构（如armeabi-v7a 或 arm64-v8a）进行优化，则可以在命令后面加上相应选项以控制输出类型；例如只打包32位/64位二进制文件。 此外，还可以自定义生成 APK 的名称。为此需要编辑模块级 Gradle 文件中的 defaultConfig 块加入额外属性： ```groovy defaultConfig { ... setProperty("archivesBaseName", "appName-$versionName") } ``` 这段脚本允许按照预设模式重命名产出物，其中变量 `$versionName` 将被实际版本号替代[^4]。

Flutter支持在不同的渠道上进行打包，可以根据不同的渠道配置不同的应用包。下面是实现Flutter多渠道打包的步骤： 1. 在Flutter项目根目录下的`android/app`目录下创建一个名为`channel`的文件夹，用于存放不同渠道的配置文件。 2. 在`channel`文件夹下创建不同渠道的配置文件，例如`channel/dev.properties`、`channel/prod.properties`等。配置文件的内容可以包括应用包名、应用名称、应用图标、应用版本号等信息。例如： ``` # dev.properties # 应用包名 package_name=com.example.dev # 应用名称 app_name=dev_app # 应用图标 app_icon=dev_icon # 应用版本号 app_version=1.0.0 ``` 3. 在`android/app/build.gradle`文件中添加如下配置： ``` android { // ... defaultConfig { // ... //应用包名 applicationId "com.example.app" //应用名称 manifestPlaceholders = [ appName: "My App" ] //应用版本号 versionCode 1 versionName "1.0.0" // ... } // ... buildTypes { release { // ... //在release模式下，根据不同渠道打包 applicationVariants.all { variant -> variant.outputs.all { def outputFile = outputFileName if (outputFile.endsWith('.apk') || outputFile.endsWith('.aab')) { def fileName = outputFile.replace(".${outputFile.split("\\.").last()}", "") def channelPropertiesFile = file("channel/${variant.flavorName}.properties") if (channelPropertiesFile.exists()) { def channelProperties = new Properties() channelProperties.load(new FileInputStream(channelPropertiesFile)) outputFileName = "${fileName}_${channelProperties.getProperty("app_version")}_${channelProperties.getProperty("app_name")}.apk" output.outputFileName = outputFileName manifestPlaceholders = [ appName: channelProperties.getProperty("app_name"), appIcon: channelProperties.getProperty("app_icon") ] } } } } } } } ``` 4. 在Flutter项目根目录下运行以下命令，生成不同渠道的应用包： ``` flutter build apk --flavor dev flutter build apk --flavor prod ``` 其中，`--flavor`参数指定了打包时所使用的渠道配置文件。 5. 打包完成后，在`build\app\outputs\flutter-apk`目录下可以看到生成的不同渠道的应用包。 注意事项： - 渠道名称需要与`buildTypes`中的名称一致。 - 配置文件中的属性名需要与`build.gradle`文件中指定的属性名一致。 - 打包时需要分别运行不同渠道的打包命令。