实用

Android 多渠道打包的方案总结

2022-07-11  本文已影响0人  JeffreyWorld

美团的 Walle 方案：https://github.com/Meituan-Dianping/walle
腾讯的 VasDolly 方案：https://github.com/Tencent/VasDolly
packer-ng-plugin 方案：https://github.com/mcxiaoke/packer-ng-plugin

先从 Github 开源维护的情况看，packer-ng-plugin 项目已经停止维护，Walle 最新的维护是在2年前，VasDolly 最新的维护在5个月前。从开源维护的角度来说，腾讯的 VasDolly 方案，更胜一筹。

可商用的多渠道自动化打包方案

VasDolly

先说使用后的体验：

因为 VasDolly官方最新的版本为 v3.0.4，所以直接集成最新版本的情况，没去试历史旧版本的情况。
项目环境为：

dependencies {
classpath 'com.android.tools.build:gradle:7.0.3'
classpath 'com.tencent.vasdolly:plugin:3.0.4'
}
distributionUrl=https://services.gradle.org/distributions/gradle-7.0.2-all.zip

即可成功编译，并且按教程配置，可以打出对应的渠道包。官方的 Demo 给的就是这个 Gradle 编译环境。打20个渠道包，时间可以控制在1分钟左右。

但是，例如项目环境为：

dependencies {
classpath "com.android.tools.build:gradle:4.1.3"
classpath 'com.tencent.vasdolly:plugin:3.0.4'
}
distributionUrl=https://services.gradle.org/distributions/gradle-6.6-all.zip

编译项目会报这个错：

Unable to load class 'com.android.build.api.extension.AndroidComponentsExtension'.
This is an unexpected error. Please file a bug containing the idea.log file.

VasDolly 实现原理：

https://github.com/Tencent/VasDolly/wiki/VasDolly%E5%AE%9E%E7%8E%B0%E5%8E%9F%E7%90%86

通过Gradle生成多渠道包

若是直接编译生成多渠道包，首先要配置渠道文件、渠道包的输出目录和渠道包的命名规则：

channel{
    //指定渠道文件
    channelFile = file("/Users/leon/Downloads/testChannel.txt")
     //多渠道包的输出目录，默认为new File(project.buildDir,"channel")
    outputDir = new File(project.buildDir,"xxx")
    //多渠道包的命名规则，默认为：${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}-${buildTime}
    apkNameFormat ='${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}'
    //快速模式：生成渠道包时不进行校验（速度可以提升10倍以上，默认为false）
    fastMode = false
    //buildTime的时间格式，默认格式：yyyyMMdd-HHmmss
    buildTimeDateFormat = 'yyyyMMdd-HH:mm:ss'
    //低内存模式（仅针对V2签名，默认为false）：只把签名块、中央目录和EOCD读取到内存，不把最大头的内容块读取到内存，在手机上合成APK时，可以使用该模式
    lowMemory = false
}

其中，多渠道包的命名规则中，可使用以下字段：

然后，通过 gradle channelDebug、gradle channelRelease 命令分别生成 Debug 和 Release 的多渠道包。

为了方便临时生成渠道包进行测试，从v2.0.0开始支持添加渠道参数：gradle channelDebug(channelRelease) -Pchannels=yingyongbao,gamecenter，这里通过属性 channels 指定的渠道列表拥有更高的优先级，且和原始的文件方式是互斥的。

根据已有基础包重新生成多渠道包

若是根据已有基础包重新生成多渠道包，首先要配置渠道文件、基础包的路径和渠道包的输出目录：

rebuildChannel {
  //指定渠道文件
  channelFile = file("/Users/leon/Downloads/testReChannel.txt")
  // 已有APK文件地址（必填）,如new File(project.rootDir, "/baseApk/app_base.apk"),文件名中的base将被替换为渠道名
  baseApk = 已有APK文件地址（必填）
  //默认为new File(project.buildDir, "rebuildChannel")
  outputDir = 渠道包输出目录
  //快速模式：生成渠道包时不进行校验（速度可以提升10倍以上，默认为false）
  fastMode = false
  //低内存模式（仅针对V2签名，默认为false）：只把签名块、中央目录和EOCD读取到内存，不把最大头的内容块读取到内存，在手机上合成APK时，可以使用该模式
  lowMemory = false
}

通过命令行生成渠道包、读取渠道信息：

https://github.com/Tencent/VasDolly/blob/master/command/README.md

读取渠道信息

通过 helper 类库中的 ChannelReaderUtil 类读取渠道信息。

String channel = ChannelReaderUtil.getChannel(getApplicationContext());

如果没有渠道信息，那么这里返回 null，开发者需要自己判断。

Walle

先说使用后的体验：

Walle 官方库已经2年多没更新，v1.1.7 为最新的版本。打20个渠道包，时间也可以控制在1分钟左右。
项目环境为：

dependencies {
classpath 'com.android.tools.build:gradle:4.1.3'
classpath 'com.meituan.android.walle:plugin:1.1.7'
}
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-6.6-all.zip

即可成功编译，并且按教程配置，可以打出对应的渠道包。
因为 Walle 最新的维护是在2年前，很多依赖的库和 Gradle 版本都太低，所以自己在 Github 仓库去尝试升级维护这个库，地址如下：https://github.com/jeffreyxuworld/MeituanWalle

Walle 实现原理

可看下美团的官方链接：https://tech.meituan.com/2017/01/13/android-apk-v2-signature-scheme.html

捋了一遍原理后，总结如下：
大前提都是针对 APK 签名方案去做的相关事情。
Android 支持以下三种应用签名方案：

更细节的要点如下：

最后总结：

  1. AndroidManifest.xml 里，友盟 SDK 需要获取应用的渠道名称
<meta-data
       android:name="UMENG_CHANNEL"
       android:value="${UMENG_CHANNEL_VALUE}" />
  1. 在主 App 工程的 build.gradle 中，如果写了如下代码：
  flavorDimensions "versionCode", "serverUrl"

           applicationVariants.all { variant ->
                variant.outputs.all { output ->
                    def fileName
                    if (variant.buildType.name == "release") {
                        fileName = "XXAPP-${variant.productFlavors[0].name}-${variant.versionName}-Android.apk"
                    } else {
                        fileName = "XXAPP-Android.apk"
                    }
                    outputFileName = fileName
                }
            }

productFlavors {
        yingyongbao {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "yingyongbao"]
        }
        huawei {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "huawei"]
        }
        xiaomi {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
        }
        oppo {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "oppo"]
        }
        vivo {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "vivo"]
        }
        weibo {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "weibo"]
        }
        bzhan {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "bzhan"]
        }
        toutiao {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "toutiao"]
        }
        guangdiantong {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "guangdiantong"]
        }
        baidu {
            dimension "versionCode"
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "baidu"]
        }
        urlTest {
            dimension "serverUrl"
            buildConfigField("int", "SERVER_TYPE", "1")
        }
        urlOnline {
            dimension "serverUrl"
            buildConfigField("int", "SERVER_TYPE", "2")
        }
    }

这些渠道包相关的配置，都会和 VasDolly 、Walle 的方案有所冲突，所以要按照 VasDolly 、Walle 官方教程里的写法来写。

上一篇下一篇

猜你喜欢

热点阅读