Android构建和发布-中文网

在一般的开发过程中，我们可以使用 flutter run 命令，或者 IntelliJ 工具栏中的 Run 和 Debug 来测试 app。这时候，Flutter 默认会为我们构建 app 的调试版本。

当想要发布 app 时，比如发布到 Google Play Store，可以按照以下步骤来准备 Android 平台的发布版本。本页面的内容包含如下主题：

1. 添加启动图标

当我们创建一个新的 Flutter app 的时候，它会有一个默认的启动图标。要自定义这个图标，可以参考使用 flutter_launcher_icons 这个 package。

或者，如果我们想手动操作，可以参考以下方法：

查看 Material Design Product Icons 指南中图标设计部分。
在 <app dir>/android/app/src/main/res/ 目录下，把我们的图标文件放在以配置限定符命名的文件夹中。类似默认的 mipmap- 文件夹这样的命名方式。
在 AndroidManifest.xml 中，更新 application 标签中的 android:icon 属性来引用上一步骤中我们自己的图标文件 (例如，<application android:icon="@mipmap/ic_launcher" ...)。
用 flutter run 运行 app，检查启动程序中的 app 图标是否已经替换成我们自己的图标文件。

2. 启用 `Material` 组件

如果你的应用使用了平台视图 (Platform Views)，你可能要通过 Android 平台的入门指南文档中的步骤使用 Material 组件。

此处不涉及，暂不记录

3. 为 `app` 签名

要想把 app 发布到 Play store，还需要给 app 一个数字签名。我们可以采用以下步骤来为 app 签名：

Android 中有两种签名密钥: 部署和上传。终端用户下载到的 .apk 文件是被部署密钥签名过的文件，上传密钥用于验证开发者上载到 Play 商店的 .aab 或 .apk 文件。上传密钥是给予部署密钥重新签名的密钥，上载 Play 商店时候需要用到。

严重推荐你选择云托管的方式来管理部署密钥，更多相关信息，请参阅官方文档使用 Play 应用签名功能。

创建一个用于上传的密钥库

如果你已经有一个密钥库了，可以直接跳到下一步，如果还没有，需要参考下面的方式创建一个：

参考文档在 Android Studio 上为你的应用签名。
在命令行窗口运行如下的命令：在 macOS 或者 Linux 系统上，执行下面的代码：
1 2
keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA \ -keysize 2048 -validity 10000 -alias upload
在 Windows 系统上，在 PoweShell 内执行以下代码：
1 2 3
keytool -genkey -v -keystore %userprofile%\upload-keystore.jks ^ -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 ^ -alias upload
该命令将会把upload-keystore.jks文件储存在你的主文件夹中。如果你想要储存在其他地方，请通过指定 -keystore 传入参数。注意，请保证这个文件的私有性，不要将它提交到公共的代码管理空间。
提示:
- keytool 可能不在我们的系统路径中。它是 Java 的一部分，在安装 Android Studio 的时候会被一起安装。运行 flutter doctor -v，'Java binary at:' 之后打印出来的就是它的路径，然后用 java 来替换以上命令中的 keytool，并加上 keytool 的完整路径即可。如果文件路径包含空格，类似 Program Files 这样的，请使用平台允许的命名规则。例如，在 Mac/Linux 上使用 Program\ Files，而在 Windows 上可以使用 "Program Files"。
- 只有 Java 9 或更高版本才需要 -storetype JKS 标签。从 Java 9 版本开始，keystore 类型默认为 PKS12。

从 app 中引用密钥库

创建一个名为 [project]/android/key.properties 的文件，它包含了密钥库位置的定义。在替换内容时请去除 < > 括号：

storePassword=<password-from-previous-step>
keyPassword=<password-from-previous-step>
keyAlias=upload
storeFile=<keystore-file-location>

storeFile 密钥路径在 macOS 上类似于 /Users/<user name>/upload-keystore.jks，在 Windows 上类似于 C:\\Users\\<user name>\\upload-keystore.jks。

请注意: （再次）请保证这个文件的私有性，不要将它提交到公共的代码管理空间。

在 gradle 中配置签名

在以 release 模式下构建你的应用时，修改 [project]/android/app/build.gradle 文件，以通过 gradle 配置你的上传密钥。

在 android 代码块之前将你 properties 文件的密钥库信息添加进去：

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
      ...
}

将 key.properties 文件加载到 keystoreProperties 对象中。

找到 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.debug
    }
}

将其替换为我们的配置内容：

signingConfigs {
  release {
      keyAlias keystoreProperties['keyAlias']
      keyPassword keystoreProperties['keyPassword']
      storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
      storePassword keystoreProperties['storePassword']
  }
}
buildTypes {
   release {
       signingConfig signingConfigs.release
   }
}

现在我们 app 的发布版本就会被自动签名了。

当你更改 gradle 文件后，也许需要运行一下 flutter clean。这将防止缓存的版本影响签名过程

有关应用签名的更多信息，请查看 developer.android.com 的为您的应用设置签名。

4. 使用 R8 压缩你的代码

R8 是谷歌推出的最新代码压缩器，当你打包 release 版本的 APK 或者 AAB 时会默认开启。要关闭 R8，请运行 flutter build apk 或 flutter build appbundle 时加上 --no-shrink 参数。

混淆和压缩会大大地延长 Android 应用的编译时间。

5. 启用 multidex 支持

当你在编写较大的应用或使用体量较大的插件时，你可能会在最低的 API 目标版本低于 20 时，遇到 Android 的 dex 的 64k 方法数限制问题。当 flutter run 以调试模式运行应用时，由于缩减机制没有运行，该问题也有可能发生。

此处不涉及，暂不记录

6. 检查 app manifest 文件 (App名称以及网络权限)

检查位于 <app dir>/android/app/src/main 的默认 App Manifest 文件 AndroidManifest.xml，并确认各个值都设置正确，特别是：

application 编辑 application 标签中的 android:label 来设置 app 的最终名字。

uses-permission 如果你的代码需要互联网交互，请加入 android.permission.INTERNET 权限标签。标准开发模版里并未加入这个权限（但是 Flutter debug 模版加入了这个权限），加入这个权限是为了允许 Flutter 工具和正在运行的 app 之间的通信。

7. 检查构建配置

检查位于 [project]/android/app 的默认 Gradle 构建文件 (build.gradle) 并确认各个值都设置正确：

在 `defaultConfig` 配置中

applicationId 指定唯一的应用 ID。

minSdkVersion 指定应用适配的最低 SDK 版本。默认为 flutter.minSdkVersion。

targetSdkVersion 指定应用适配的目标 SDK 版本。默认为 flutter.targetSdkVersion。

versionCode 用于内部版本号的正整数。该数字仅用于比较两个版本间数字较大的为更新版本。该版本不会对用户展示。

versionName 向用户展示的版本号。该字段必须设置为原始字符串或字符串资源的引用。

buildToolsVersion 如果你正在使用高于 3.0.0 版本的 Android Gradle Plugin，你的项目会自动使用 AGP 默认指定的构建工具版本。你也可以手动指定构建工具的版本。

在 android 配置中

compileSdkVersion 指定 Gradle 用于编译应用的 API 版本。默认为 flutter.compileSdkVersion。

更多信息可以参考 Gradle 构建文件文档中模块级构建的部分。

8. 构建生产版本应用

当要发布到 Play Store 时，你有两种发布方式的选择：

App bundle (推荐）
APK

提示: Google Play 更推荐使用 app bundle 格式的应用，更多信息可以参考 Android App Bundle。

构建一个 app bundle

这个部分描述了如何构建一个发布的 app bundle。如果在前面的部分已经完成了签名步骤，发布的 bundle 会被签名。这时你也许想要混淆你的 Dart 代码以加大反编译难度。混淆你的代码需要在 build 的时候添加一些标志，并维护其他文件以消除反编译的堆栈跟踪。

使用如下命令：

运行 cd [project]。
运行 flutter build appbundle。 (运行 flutter build 默认构建一个发布版本。)

你的应用的 release bundle 会被创建到 <app dir>/build/app/outputs/bundle/release/app.aab.

此 app bundle 会默认地包含为 armeabi-v7a (ARM 32-bit)、arm64-v8a (ARM 64-bit) 以及 x86-64 (x86 64-bit) 编译的 Dart 和 Fluter 运行时代码。

测试 app bundle

一个 app bundle 可以用多种方法测试，这里介绍两种。

离线使用 bundle tool

如果你还没准备好，可以从 GitHub 仓库下载 bundletool。
从你的 app bundle 生成 APKs。
将这 APKs 部署到已连接的设备。

在线使用 Google Play

上传你的 bundle 到 Google Play 去测试它。或者在正式发布之前用 alpha 或 beta 频道去测试。
按照这些步骤把你的 bundle 上传到 Play Store。

构建一个 APK

虽然 app bundle 比 APKs 更被推荐使用，但是有一些 Store 目前还不支持 app bundle方式。这种情况下，要为各种目标 ABI (Application Binary Interface) 分别构建发布的 APK 文件。

如果你完成签名步骤，APK 就被签名了。这时你也许想要混淆你的 Dart 代码以加大反编译难度。混淆你的代码需要在构建时添加一些参数。

使用如下命令：

输入命令 cd [project]
运行 flutter build apk --split-per-abi （flutter build 默认带有 --release 参数。）

这个命令会生成如下三个 APK 文件

[project]/build/app/outputs/apk/release/app-armeabi-v7a-release.apk
[project]/build/app/outputs/apk/release/app-arm64-v8a-release.apk
[project]/build/app/outputs/apk/release/app-x86_64-release.apk

如果移除 --split-per-abi 将会生成一个包含所有目标 ABI 的 fat APK 文件。这种 APK 文件将会在比单独构建的 APK 文件尺寸要大，会导致用户下载一些不适用于其设备架构的二进制文件。

在设备上安装 APK 文件

按照如下这些步骤，将前一步中构建出来的 APK 安装到 Android 设备上。

使用如下命令：

用 USB 线将 Android 设备连接到电脑上；
输入命令 cd [project]；
运行 flutter install。

发布到 Google Play Store

要了解如何发布一个 app 到 Google Play Store，可以参考 Google Play 发布文档。

此处不涉及，暂不记录

更新应用版本号

每个应用默认的初始版本号是 1.0.0。若要更新它，请转到 pubspec.yaml 文件并更新以下内容：

version: 1.0.0+1

版本号由三个点分隔的数字组成，例如上面样例中的 1.0.0。然后是可选的构建号，例如上面样例中的 1，以 + 分隔。

版本号与构建号都可以在 Flutter 打包时分别使用 --build-name 和 --build-number 重新指定。

在 Android 中，build-number 被用作 versionCode， build-name 将作为 versionName 使用。更多信息请参考 Android 文档中的为你的应用添加版本。

当重新构建 Android 应用后，任何在 pubspec 文件所做的版本号更新，都将会更新 local.properties 文件中的 versionName 和 versionCode。

Android 发布常见问题

具体请查看 Android 发布常见问题

此处不涉及，暂不记录

文章目录

1. 添加启动图标

2. 启用 `Material` 组件

3. 为 `app` 签名

创建一个用于上传的密钥库

从 app 中引用密钥库

在 gradle 中配置签名

4. 使用 R8 压缩你的代码

5. 启用 multidex 支持

6. 检查 app manifest 文件 (App名称以及网络权限)

7. 检查构建配置

在 `defaultConfig` 配置中

在 android 配置中

8. 构建生产版本应用

构建一个 app bundle

测试 app bundle

离线使用 bundle tool

在线使用 Google Play

构建一个 APK

在设备上安装 APK 文件

发布到 Google Play Store

更新应用版本号

Android 发布常见问题

相关文章

最近文章

分类

标签

友情链接

其它

文章目录

1. 添加启动图标

2. 启用 Material 组件

3. 为 app 签名

创建一个用于上传的密钥库

从 app 中引用密钥库

在 gradle 中配置签名

4. 使用 R8 压缩你的代码

5. 启用 multidex 支持

6. 检查 app manifest 文件 (App名称以及网络权限)

7. 检查构建配置

在 defaultConfig 配置中

在 android 配置中

8. 构建生产版本应用

构建一个 app bundle

测试 app bundle

离线使用 bundle tool

在线使用 Google Play

构建一个 APK

在设备上安装 APK 文件

发布到 Google Play Store

更新应用版本号

Android 发布常见问题

相关文章

最近文章

分类

标签

友情链接

其它

2. 启用 `Material` 组件

3. 为 `app` 签名

在 `defaultConfig` 配置中