打包并发布 Android 应用

目录

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

During a typical development cycle, you test an app using flutter run at the command line, or by using the Run and Debug options in your IDE. By default, Flutter builds a debug version of your app.

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

When you’re ready to prepare a release version of your app, for example to publish to the Google Play Store, this page can help. Before publishing, you might want to put some finishing touches on your app. This page covers the following topics:

添加启动图标

Adding a launcher icon

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

When a new Flutter app is created, it has a default launcher icon. To customize this icon, you might want to check out the flutter_launcher_icons package.

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

Alternatively, you can do it manually using the following steps:

  1. 查看 Material Design Product Icons 指南中图标设计部分。

    Review the Material Design product icons guidelines for icon design.

  2. 在 <app dir>/android/app/src/main/res/ 目录下，把我们的图标文件放在以 配置限定符 命名的文件夹中。类似默认的 mipmap- 文件夹这样的命名方式。

    In the <app dir>/android/app/src/main/res/ directory, place your icon files in folders named using configuration qualifiers. The default mipmap- folders demonstrate the correct naming convention.

  3. 在 AndroidManifest.xml 中，更新 application 标签中的 android:icon 属性来引用上一步骤中我们自己的图标文件 (例如，<application android:icon="@mipmap/ic_launcher" ...)。

    In AndroidManifest.xml, update the application tag’s android:icon attribute to reference icons from the previous step (for example, <application android:icon="@mipmap/ic_launcher" ...).

  4. 用 flutter run 运行 app，检查启动程序中的 app 图标是否已经替换成我们自己的图标文件。

    To verify that the icon has been replaced, run your app and inspect the app icon in the Launcher.

启用 Material 组件

Enabling Material Components

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

If your app uses Platform Views, you may want to enable Material Components by following the steps described in the Getting Started guide for Android.

举个例子：

For example:

  1. 在 <my-app>/android/app/build.gradle 文件中添加 Android Material 组件依赖：

    Add the dependency on Android’s Material in <my-app>/android/app/build.gradle:

dependencies {
    // ...
    implementation 'com.google.android.material:material:<version>'
    // ...
}

查看最新的版本，请访问 Google Maven 仓库。

To find out the latest version, visit Google Maven.

  1. 在 <my-app>/android/app/src/main/res/values/styles.xml 文件中设置主题：

    Set the theme in <my-app>/android/app/src/main/res/values/styles.xml:

-<style name="LaunchTheme" parent="Theme.AppCompat">
+<style name="LaunchTheme" parent="Theme.MaterialComponents.NoActionBar">

为 app 签名

Signing the app

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

To publish on the Play Store, you need to give your app a digital signature. Use the following instructions to sign your app.

创建一个密钥库

Create a keystore

如果我们已经有一个密钥库，可以跳到下一步。如果没有，在命令行中运行以下的命令来创建一个：

If you have an existing keystore, skip to the next step. If not, create one by running the following at the command line:

在 macOS 或者 Linux 系统上，执行下面的代码

On Mac/Linux, use the following command:

```terminal
keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key

在 Windows 系统上，执行下述代码：

On Windows, use the following command:

keytool -genkey -v -keystore c:\Users\USER_NAME\key.jks -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 -alias key