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 应用进行通信,默认是开启,如果不开启,直接删除该属性这一行。
查看
/android/app/build.gradle
,验证这些属性是否正确:- defaultConfig 属性
- applicationId:制定始终唯一的 appid。
- versionCode && versionName:app 应用版本号和版本号字符串。
- minSdkVersion && targetSdkVersion:指定最低的 API 级别以及应用程序设计运用的 API 级别。
创建 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 包的构成,我们主要来看不混淆的情况下。
文章图片
一般静态资源文件占有大量内存,我们发现图片在 apk 占比为 80% + 0% = 80%
- Flutter 引用资源(assets 文件夹) 80%
- Android 启动页背景和 app 的 logo(res 文件夹) 0%
(一)图片和代码优化
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。
文章图片
从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,而且目前大部分手机都是这个架构。
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 包。
文章图片
看看 app-armeabi-v7a-release.apk 包大小 126.2MB,爽啊,由 146.9 MB 直接减少到 126.2 MB。
我们看下对应的 apk 内容:
文章图片
lib 占比也从原来的 19.7%,28.7 MB 直接减少为 6.4%,8 MB。
(三)混淆优化
Flutter 也为我们提供了混淆命令:
flutter build apk --obfuscate --split-debug-info=//
简单说明一下:
- --obfuscate:开启混淆开关。
- --split-debug-info:混淆生成的map符号表缓存到此位置。
执行
flutter build apk --obfuscate --split-debug-info=splitMap
文章图片
大小从 146.9MB 降到 145.9MB,减少了1MB。
在项目根目录下生成了符号文件:
文章图片
我们再试一下,直接针对不同 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
文章图片
未混淆的 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文件夹中
文章图片