【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略

Hi~ 豆皮粉们!最近在学什么,变厉害了没?今回就请大家来读读由字节跳动的“saucxs” 精心制作的《Flutter打包的基础配置和包体积优化策略》,涨涨跨端领域的知识,在你的前端“全栈”化的大路上走上一小步。

作者:saucxs
来源:原创
前言 读者朋友们,你们有没有遇到过快乐地用 flutter 项目开发完,该上线了,但你对打包过程不熟悉,遇到大大小小问题的时候?来看看我这个过来人怎么打包加优化的吧。
一、背景 在本地开发中,使用flutter run命令还是 Android studio 运行或者调试,flutter 构建的是 debug 版本,也就是本地调试右上角出现 debug 标志。
当本地调试 OK 后,准备 release 版本,比如发布到应用商城,或者交付用户使用。
二、前期检查工作 1、检查AndroidManifest配置
查看/android/app/src/main/中的AndroidManifest.xml文件,并验证这些属性是否正确,特别是:
  • application 属性,这是应用的名称。
  • uses-permission 属性,启用 flutter 工具和 app 应用进行通信,默认是开启,如果不开启,直接删除该属性这一行。
2、查看构建配置
查看/android/app/build.gradle,验证这些属性是否正确:
  • defaultConfig 属性
    • applicationId:制定始终唯一的 appid。
    • versionCode && versionName:app 应用版本号和版本号字符串。
    • minSdkVersion && targetSdkVersion:指定最低的 API 级别以及应用程序设计运用的 API 级别。
3、app签名
创建 keystore 。
如果之前已经创建过 keystore,那就跳过本步骤直接看 4、应用中引入keystore
创建一个keystore,执行命令:
For more details, please visit https://support.apple.com/kb/HT208050. yourMacBook-Pro:~ username$ keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key

生成的文件是 key.jks
默认文件地址:/Users/<你电脑名称>/key.jks
注意:密钥是私密文件,不要加到git中。
下面是详细的执行过程
Last login: Mon Nov2 14:17:41 on ttys005The default interactive shell is now zsh. To update your account to use zsh, please run `chsh -s /bin/zsh`. For more details, please visit https://support.apple.com/kb/HT208050. yourMacBook-Pro:~ username$ keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key 输入密钥库口令: 再次输入新口令: 它们不匹配。请重试 输入密钥库口令: 再次输入新口令: 您的名字与姓氏是什么? [Unknown]:C 您的组织单位名称是什么? [Unknown]:byte 您的组织名称是什么? [Unknown]:byte 您所在的城市或区域名称是什么? [Unknown]:nj 您所在的省/市/自治区名称是什么? [Unknown]:nj 该单位的双字母国家/地区代码是什么? [Unknown]:cn CN=C, OU=byte, O=byte, L=nj, ST=nj, C=cn是否正确? [否]:y正在为以下对象生成 2,048 位RSA密钥对和自签名证书 (SHA256withRSA) (有效期为 10,000 天): CN=C, OU=byte, O=byte, L=nj, ST=nj, C=cn 输入 的密钥口令 (如果和密钥库口令相同, 按回车): 再次输入新口令: [正在存储/Users/username/key.jks]Warning: JKS 密钥库使用专用格式。建议使用 "keytool -importkeystore -srckeystore /Users/username/key.jks -destkeystore /Users/username/key.jks -deststoretype pkcs12" 迁移到行业标准格式 PKCS12。 yourMacBook-Pro:~ username$

4、应用中引入keystore
/android下新建 key.properties 的文件,其中包含对密钥库的引用:
storePassword=<你输入的密码> keyPassword=<你输入的密码> keyAlias=key storeFile=/Users/<你电脑名称>/key.jks

5、在构建配置中添加签名
/android/app/build.gradle文件做修改:
// ... apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"// 新增的内容 def keystorePropertiesFile = rootProject.file("key.properties") def keystoreProperties = new Properties() keystoreProperties.load(new FileInputStream(keystorePropertiesFile))android { compileSdkVersion 28// ... // ...defaultConfig { // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html). applicationId "com.example.flutter_tester" minSdkVersion 18 targetSdkVersion 28 versionCode flutterVersionCode.toInteger() versionName flutterVersionName }// 新增内容 这块就是从 signingConfigs { release { keyAlias keystoreProperties['keyAlias'] keyPassword keystoreProperties['keyPassword'] storeFile file(keystoreProperties['storeFile']) storePassword keystoreProperties['storePassword'] } } // 新增内容 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.release } }

现在应用打包的 release 版本将自动进行签名。
三、打包命令 然后执行打包命令,构建发布版(release)APK。如果您完成了前一节中的签名步骤,则会对APK进行签名。
使用命令行:
cd( 为您的工程目录). 运行flutter build apk (flutter build 默认会包含 --release选项).

打包好的发布APK位于/build/app/outputs/apk/app-release.apk
四、包体积优化策略 步骤三执行完,打包的这个过程就结束了,但为了追求极致,我们会发现打包之后体积有点大。
下一步,我们来分析一下这个 APK 包的构成,我们主要来看不混淆的情况下。
【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

一般静态资源文件占有大量内存,我们发现图片在 apk 占比为 80% + 0% = 80%
  • Flutter 引用资源(assets 文件夹) 80%
  • Android 启动页背景和 app 的 logo(res 文件夹) 0%
主要是因为用了大量的图片,并且没有设置 Android 启动页背景和 app 的 logo。
(一)图片和代码优化
1、处理图片资源使用外部服务 与其将图像资产捆绑在应用程序内,不如将图像托管在诸如 firebase 之类的外部服务上,并使用包cached_network_image 在应用程序内调用这些图像。在首次启动应用程序时,程序包会从提供的URL 中获取图像并对其进行缓存,因此您在随后使用该应用程序时会得到一个缓存的图像,因此这些图像不占用下载空间,因为它们没有捆绑在应用程序内。
2、压缩 png 和 jpg 如果有的图片不想从外部主机获取,必须从本地获取,所用的图片必须压缩 png 和 jpg,因为高质量的 png 和 jpg 会占用应用程序的大小。
3、使用 svg 格式图标 我们尽量使用矢量图 svg,而不是使用 png,因为 svg 可以兼容不同的 dpi 设备,并且能减少 apk 大小。
4、去掉未使用的包 在 pubspec.yaml 文件中不需要或者根本没有使用的库或者包。
5、特殊字体使用 http 缓存方式 字体也是程序大小的一个原因,当 UX 需要使用特定的字体,我们可以不用把字体文件,比如 *.ttf或者 .otf 文件存储在应用程序中,然后映射到pubspec.yaml文件中,我们可以通过http获取一次,并缓存到应用程序的文件系统中。
6、使用 proguard 优化器 proguard 是 java 的优化器,优化器不会改变表现形式并且使用更紧凑的方式优化代码。
proguard 混淆原始名称无所谓的类型,字段,方法名称,将长命名字符串替换为短字符串,比如换成a,b,c 以提高效率。然而包和类的名称可能很长,但是不会影响效率。
我们在 /android/app/build.gradle中的构建类型与以下所示类似:
buildTypes { release { minifyEnabled true //添加proguard proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//添加proguard signingConfig signingConfigs.release//这是发布的默认值 } }

在同一目录中,创建文件proguard-rules.pro并添加以下代码:
## Flutter wrapper -keep class io.flutter.app.** { *; } -keep class io.flutter.plugin.** { *; } -keep class io.flutter.util.** { *; } -keep class io.flutter.view.** { *; } -keep class io.flutter.** { *; } -keep class io.flutter.plugins.** { *; } # -keep class com.google.firebase.** { *; } // uncomment this if you are using firebase in the project -dontwarn io.flutter.embedding.** -ignorewarnings

最后我们在 gradle.properties 文件中添加:
extra-gen-snapshot-options=--obfuscate

7、shrinkResources 去掉无用代码 在 build.gradle 中
buildTypes { release { minifyEnabled true // added previously shrinkResources true // add this proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' // added previously signingConfig signingConfigs.release // added previously } }

PS:使用 shrinkResource 和 proguard 优化器,优化后,体积减少了0.1MB。
【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

从147.0MB减少到146.9MB,减少的太少了。
(二)so优化
针对 Flutter 打出的 Apk 包,排在第二位的是lib,28.7MB,占19.7%
将我们编写的 Dart 代码转化为不同架构下的 so 库,以供原生调用。
针对不同 CPU 架构所代表含义:
  • x86_64: Intel 64 位,一般用于平板或者模拟器,支持 x86 以及 x86_64 CPU 架构设备。
  • arm64-v8a: 第 8 代 64 位,包含 AArch32、AArch64 两个执行状态,且对应 32 、64 bit,并且支持 armeabi、armeabi-v7a 以及 arm64-v8a。
  • armeabi-v7a: 第 7 代 arm v7,使用硬件浮点运算,具有高级拓展功能,兼容 armeabi 以及 armeabi-v7a,而且目前大部分手机都是这个架构。
我们通过以下不同命令分别打包,构建制定的CPU架构的APK包,
flutter build apk --target-platform android-arm,android-arm64,android-x64 --split-per-abi

我们来解释一下这个:
  • flutter build apk 表示当前构建 release 包。
  • 后面 android-arm,andriod-arm64,andriod-x64 则表示生成制定的架构的 release 包。
  • 最后--split-per-abi 则表示按照不同架构分别打包,如果移除就包含所有 CPU 架构的 apk 包。
【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

看看 app-armeabi-v7a-release.apk 包大小 126.2MB,爽啊,由 146.9 MB 直接减少到 126.2 MB。
我们看下对应的 apk 内容:
【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

lib 占比也从原来的 19.7%,28.7 MB 直接减少为 6.4%,8 MB。
(三)混淆优化
Flutter 也为我们提供了混淆命令:
flutter build apk --obfuscate --split-debug-info=//

简单说明一下:
  • --obfuscate:开启混淆开关。
  • --split-debug-info:混淆生成的map符号表缓存到此位置。
我们先测试一下,构建完整的apk的大小。
执行
flutter build apk --obfuscate --split-debug-info=splitMap

【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

大小从 146.9MB 降到 145.9MB,减少了1MB。
在项目根目录下生成了符号文件:
【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

我们再试一下,直接针对不同 CPU 生成对应的 Apk 并添加混淆结果。
flutter build apk --obfuscate --split-debug-info=// --target-platform android-arm,android-arm64,android-x64 --split-per-abi

我们执行:
flutter build apk --obfuscate --split-debug-info=splitMap --target-platform android-arm,android-arm64,android-x64 --split-per-abi

【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

未混淆的 v7a 大小与开启混淆相比,126.2MB 减少到 125.9MB 。开启混淆减少了 0.3 MB。
觉得差别不大。
五、总结 一旦打包的基础配置完事后,基本上不用怎么改,优化配置完事后,需要一个优化的打包命令。
觉得这是一个比较有用的打包命令:
flutter build apk --obfuscate --split-debug-info=splitMap --target-platform android-arm,android-arm64,android-x64 --split-per-abi

  • 不同CPU结构分别打包
  • 要混淆,生产的字符串Map在splitMap文件夹中
The End 【【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略】【手把手学习flutter】Flutter打Android包的基本配置和包体积优化策略
文章图片

    推荐阅读