flutter打渠道包-多渠道脚本打包

由于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

//--build-number 1:构建的版本号;
//--build-name 1.0.0:构建的版本名;
//--dart-define=APP_CHANNEL=normal :自定义参数,可定义多个(APP_CHANNEL为key,normal为值);
//--target-platform android-arm,android-arm64: 指定生成对应架构的release包;
//--split-per-abi:表示告知需要按照我们指定的类型分别打包,如果移除则直接构建包含所有 CPU 架构的 Apk 包;

其中我们简单了解一下自定义参数的功能 --dart-define,我们可以用这个命令参数在打包或运行 App 时设置参数。

//定义并设置渠道参数
--dart-define=APP_CHANNEL=normal
//多个参数
 --dart-define=APP_CHANNEL=normal --dart-define=OTHER_VAR=other

flutter层中即可通过以下代码获取参数:

// main.dart
class EnvironmentConfig {
  //获取渠道配置
  static const String APP_CHANNEL = String.fromEnvironment('APP_CHANNEL');
  static const String OTHER_VAR = String.fromEnvironment('OTHER_VAR');
}

android原生则通过以下方式获取:

// android/app/build.gradle
/// 获取渠道参数使用,这里设置一下默认值
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

        //(两种方式二选一,改变的是android文件夹下apk)
        //        setProperty("archivesBaseName","app_v${defaultConfig.versionName}_${defaultConfig.versionCode}_channel_${dartEnvironmentVariables.APP_CHANNEL}")
        archivesBaseName = "app_v${defaultConfig.versionName}_${defaultConfig.versionCode}_channel_${dartEnvironmentVariables.APP_CHANNEL}"


        //这里不需要配置,通过打包命令配置
//        ndk {
//            //选择要添加的对应 cpu 类型的 .so 库。
//            // abiFilters 'armeabi', 'armeabi-v7a', 'x86', 'x86_64', 'mips', 'mips64', 'arm64-v8a'
//            abiFilters 'armeabi-v7a', 'arm64-v8a'
//            // 还可以添加
//        }
}

这时候我们就能在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[*]}
do
    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
done

我们的项目是需要构建android-arm和android-arm64两种不同建构的apk包(这样分别打包会比32位、64位通用包体积更小),所以在命令加上了–split-per-abi配置,该配置会在build/app/outputs/flutter-apk文件夹下生成对应架构的包,然后根据不同渠道修改文件名。这里大家可以根据自己的需求修改。灰常好用