Android 渠道包生成

目前看到了两家打包实现:
美团
腾讯VasDolly

前言

其实本文大部分资料都来自github和google,如何有兴趣的读者,可以直接阅读官方文档~
什么是Gradle

Android 构建系统编译应用资源和源代码,然后将它们打包成可供您测试、部署、签署和分发的 APK。 Android Studio 使用 Gradle 这一高级构建工具包来自动执行和管理构建流程,同时也允许您定义灵活的自定义构建配置。

每个构建配置均可自行定义一组代码和资源,同时对所有应用版本共有的部分加以重复利用。 Android Plugin for Gradle 与这个构建工具包协作,共同提供专用于构建和测试 Android 应用的流程和可配置设置。

Gradle 和 Android 插件独立于 Android Studio 运行。 这意味着,您可以在 Android Studio 内、计算机上的命令行或未安装 Android Studio 的计算机(例如持续性集成服务器)上构建 Android 应用。

如果您不使用 Android Studio,可以学习如何从命令行构建和运行您的应用。 无论您是从命令行、在远程计算机上还是使用 Android Studio 构建项目,构建的输出都相同。

注:由于 Gradle 和 Android 插件独立于 Android Studio 运行,您需要单独更新构建工具。

请阅读版本说明,了解如何更新 Gradle 和 Android 插件。Android 构建系统非常灵活,让您能够在不修改应用核心源文件的情况下执行自定义构建配置。

什么是 VasDolly

VasDolly是腾讯开源的一个高效的打包工具。腾讯作为国内的技术大厂,在技术层面上还是很牛逼and可靠的。而且开发团队在github上也是相对的活跃,对issue也解决也是很积极的。

VasDolly是一种快速多渠道打包工具,同时支持基于V1签名和V2签名进行多渠道打包。插件本身会自动检测Apk使用的签名类别,并选择合适的多渠道打包方式,对使用者来说完全透明。

VasDolly 是腾讯推出的新一代打包工具,相对于传统的打包工具,即AS自带的打包工具,速度有了非一般的提升。

Gradle Plugin本身提供了多渠道的打包策略: 首先,在AndroidManifest.xml中添加渠道信息占位符:

<meta-data android:name="InstallChannel" android:value="${InstallChannel}" />

然后,通过Gradle Plugin提供的productFlavors标签,添加渠道信息:

productFlavors{

"YingYongBao"{ manifestPlaceholders = [InstallChannel : "YingYongBao"] }

"360"{ manifestPlaceholders = [InstallChannel : "360"] }

}

这样,Gradle编译生成多渠道包时,会用不同的渠道信息替换AndroidManifest.xml中的占位符。我们在代码中,也就可以直接读取AndroidManifest.xml中的渠道信息了。

但是,这种方式存在一些缺点:

每生成一个渠道包,都要重新执行一遍构建流程,效率太低,只适用于渠道较少的场景。

Gradle会为每个渠道包生成一个不同的BuildConfig.java类,记录渠道信息,导致每个渠道包的DEX的CRC值都不同。一般情况下,这是没有影响的。但是如果你使用了微信的Tinker热补丁方案,那么就需要为不同的渠道包打不同的补丁,这完全是不可以接受的。(因为Tinker是通过对比基础包APK和新包APK生成差分补丁,然后再把补丁和基础包APK一起合成新包APK。这就要求用于生成差分补丁的基础包DEX和用于合成新包的基础包DEX是完全一致的,即:每一个基础渠道包的DEX文件是完全一致的,不然就会合成失败)

那有没有一种方案:可以在添加渠道信息后,不需要重新签名?

答案就是:VasDolly 。

背景

Android在国内的市场极度的碎片化,各大应用市场乐此不疲,OEM厂商也都自立山头。而作为一个成熟的、商业化的App,必然是要在各个应用市场占坑霸榜的。所以运营的同事一般都会要求Android小哥哥提供几个甚至十几个不同渠道的渠道包。而传统的打包工具的打包速度大家都心知肚明的,尽管Google不断的优化,但还是差强人意。因此一个快速,高效的打包工具就很必要了,可以节省开发小哥哥大量的工作时间。

使用VasDolly

在根工程的build.gradle中,添加对打包Plugin的依赖:

dependencies {     classpath'com.android.tools.build:gradle:3.0.0'classpath'com.leon.channel:plugin:2.0.3'
}

在主App工程的build.gradle中,添加对VasDolly Plugin的引用:

applyplugin:'channel'

添加对VasDolly helper类库的依赖
在主App工程的build.gradle中,添加读取渠道信息的helper类库依赖:

dependencies {    api'com.leon.channel:helper:2.0.3'}

配置渠道列表
目前有两种方式配置渠道列表,最终的渠道列表是两者的累加之和:

在gradle.properties文件指定渠道文件名称,该渠道文件必须位于根工程目录下,一行一个渠道信息。

channel_file=channelFile.txt

在channel或者rebuildChannel属性中通过channelFile属性指定渠道文件,一行一个渠道信息。

channel{

//指定渠道文件

channelFile = file("../channelFile.txt")

}

rebuildChannel{

//指定渠道文件

channelFile = file("../channelFile.txt")

}

channelFile.txt 为了方便经常git版本管理,我放在了项目的根目录下
image
channelFile.txt 中的内容是每一个渠道都单独成行
image
直接编译生成多渠道包
若是直接编译生成多渠道包,首先要配置渠道文件、渠道包的输出目录和渠道包的命名规则:

channel{

//指定渠道文件

channelFile=file("../channelFile.txt")

//多渠道包的输出目录,默认为new File(project.buildDir,"channel")

baseOutputDir = new File("${project.buildDir}/channelRoot/test")

//多渠道包的命名规则,默认为${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}

apkNameFormat='${appName}-${versionName}-${versionCode}-${flavorName}-${buildType}'

//快速模式:生成渠道包时不进行校验(速度可以提升10倍以上,默认为false)

isFastMode=true

//buildTime的时间格式,默认格式:yyyyMMdd-HHmmss

buildTimeDateFormat='yyyyMMdd-HH:mm:ss'

//低内存模式(仅针对V2签名,默认为false):只把签名块、中央目录和EOCD读取到内存,不把最大头的内容块读取到内存,在手机上合成APK时,可以使用该模式

lowMemory=false

}

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

appName : 当前project的name

versionName : 当前Variant的versionName

versionCode : 当前Variant的versionCode

buildType : 当前Variant的buildType,即debug or release

flavorName : 当前的渠道名称

appId : 当前Variant的applicationId

buildTime : 当前编译构建日期时间,时间格式可以自定义,默认格式:yyyyMMdd-HHmmss

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

为了方便临时生成渠道包进行测试,我们从v2.0.0开始支持添加渠道参数:gradle channelDebug(channelRelease) -Pchannels=yingyongbao,gamecenter,这里通过属性channels指定的渠道列表拥有更高的优先级,且和原始的文件方式是互斥的。
选择使用V1 还是V2签名
目前Gradle Plugin 2.2以上默认开启V2签名,所以如果想关闭V2签名,可将下面的v2SigningEnabled设置为false。


      release {

          ...           

          v1SigningEnabledtruev2SigningEnabledfalse

     }       

debug {

     ...           

     v1SigningEnabledtruev2SigningEnabledfalse

     } 

}

如图
image

读取渠道信息

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

Stringchannel=ChannelReaderUtil.getChannel(getApplicationContext());

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

调用Gradle Task 一键生成多个release版本渠道包,或者debug渠道包

在集成成功之后,重新rebuild项目,VasDolly就会自动在项目的Gradle Task中生成对应的Task ,在需要发布正式版的时候只要选择对应的task即可
image
完成打包之后,就可以在直接配置的输出目录中看到生成的应用安装包了
image

使用命令行生成渠道包

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

效果等同于上一种使用方式
image

Demo参考
详细的接入范式,可参考Demo

或者参考我自己写的Demo

本文转自:https://www.jianshu.com/p/933a67a834d6

posted @ 2022-10-25 16:54  似水流云  阅读(653)  评论(0编辑  收藏  举报