由于android端应用商店和推广渠道较多,为了市场和运营的数据统计和推广,我们就需要对apk包根据渠道加以区分。因此往往一次版本迭代,可能都需要构建多个甚至十多个apk包,不仅费时费力,还容易搞错渠道。而使用命令和脚本的方式,打包就可以全自动完成啦,启动脚本后,喝杯咖啡也打包好了。
一:打包命令 想了解常用命令看这里------>
Flutter 常用命令
:
flutter build apk --release --build-number 1 --build-name=1.0.0 --dart-define=APP_CHANNEL=normal --target-platform android-arm,android-arm64 --split-per-abi
其中我们简单了解一下自定义参数的功能 --dart-define,我们可以用这个命令参数在打包或运行 App 时设置参数。
--dart-define=APP_CHANNEL=normal
--dart-define=APP_CHANNEL=normal --dart-define=OTHER_VAR=other
flutter层中即可通过以下代码获取参数:
class EnvironmentConfig {
static const String APP_CHANNEL = String.fromEnvironment('APP_CHANNEL');
static const String OTHER_VAR = String.fromEnvironment('OTHER_VAR');
android原生则通过以下方式获取:
def dartEnvironmentVariables = [
APP_CHANNEL: 'main',
OTHER_VAR: 'other',
if (project.hasProperty('dart-defines')) {
dartEnvironmentVariables = dartEnvironmentVariables + project.property('dart-defines')
.split(',')
.collectEntries { entry ->
def pair = URLDecoder.decode(entry).split('=')
[(pair.first()): pair.last()]
很多时候我们需要区分apk包的版本渠道等信息,就需要修改apk文件名,通过以下方式实现。
defaultConfig {
applicationId "com.xxx.xxx"
minSdkVersion 21
targetSdkVersion 30
versionCode flutterVersionCode.toInteger()
versionName flutterVersionName
multiDexEnabled true
archivesBaseName = "app_v${defaultConfig.versionName}_${defaultConfig.versionCode}_channel_${dartEnvironmentVariables.APP_CHANNEL}"
这时候我们就能在android原生层和flutter原生层获取对应的渠道信息,一个简单的渠道包也就构建好了。
二:多渠道脚本打包
上文已经简单说明了一个简单的渠道包如何构建,但是在实际开发过程中,总是需要构建很多个不同渠道的apk包,一个个打包不仅容易出错,还十分费时。这时候就可以通过脚本的方式自动打包,代码如下:
# 版本号
buildNumber=1
# 版本名
buildName="1.0.0"
# 渠道列表
# channel=("vivo" "huawei" "tencent" "xiaomi" "oppo" "operation" );
#channel=("vivo" "huawei" "tencent" "oppo");
channel=("vivo");
for item in ${channel[*]}
flutter build apk --release --build-number ${buildNumber} --build-name=${buildName} --dart-define=APP_CHANNEL=${item} --target-platform android-arm,android-arm64 --split-per-abi
mv build/app/outputs/flutter-apk/app-armeabi-v7a-release.apk build/app/outputs/flutter-apk/hole_${item}-32-release.apk
mv build/app/outputs/flutter-apk/app-arm64-v8a-release.apk build/app/outputs/flutter-apk/hole_${item}-64-release.apk
我们的项目是需要构建android-arm和android-arm64两种不同建构的apk包(这样分别打包会比32位、64位通用包体积更小),所以在命令加上了–split-per-abi配置,该配置会在build/app/outputs/flutter-apk文件夹下生成对应架构的包,然后根据不同渠道修改文件名。这里大家可以根据自己的需求修改。灰常好用
多渠道打包
Flutter 常用命令
自定义apk名称
由于android端应用商店和推广渠道较多,为了市场和运营的数据统计和推广,我们就需要对apk包根据渠道加以区分。因此往往一次版本迭代,可能都需要构建多个甚至十多个apk包,不仅费时费力,还容易搞错渠道。而使用命令和脚本的方式,打包就可以全自动完成啦,启动脚本后,喝杯咖啡也打包好了。
多渠道打包介绍
多渠道打包的主要作用是满足产品的运营需求,统计渠道和活动效果。在之前原生(Android、iOS)开发 App 有各种工具来辅助我们完成多渠道打包。在我们开发过程中也需要为渠道功能负责,原生的开发工具就基本满足我们调试渠道包内容,但是在 Flutter 上需要更多的配置才可以完成,下文将一一介绍从配置=>调试=>打包的全部流程和细节。
多渠道配.
由于最开始是用脚本一个个打包,一直想解决打包过慢的问题,但是网上大多教程是基于命令行参数或flavor,实质上并没有根本解决打包效率的问题。直到发现了文章的主角 walle。
应用解决方案
walle
walle是美团开源的一个打包插件,这里就不做介绍了,传送门。
flutter插件
由于源码Android端的,就想着写一个Flutter插件吧。
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`文件中指定的属性名一致。
- 打包时需要分别运行不同渠道的打包命令。