android多渠道打包channel,ApkChannelPackage是一种快速多渠道打包工具

687474703a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d425344332d627269676874677265656e2e7376673f7374796c653d666c617468747470733a2f2f696d672e736869656c64732e696f2f62616467652f72656c656173652d322e302e332d7265642e73766768747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e73766768747470733a2f2f696d672e736869656c64732e696f2f62616467652f57696b692d6f70656e2d627269676874677265656e2e737667

简介

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

目前Gradle Plugin 2.2以上默认开启V2签名,所以如果想关闭V2签名,可将下面的v2SigningEnabled设置为false。

signingConfigs {

release {

...

v1SigningEnabled true

v2SigningEnabled false

}

debug {

...

v1SigningEnabled true

v2SigningEnabled false

}

}

接入流程

添加对VasDolly Plugin的依赖

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

dependencies {

classpath 'com.android.tools.build:gradle:3.0.0'

classpath 'com.leon.channel:plugin:2.0.3'

}

引用VasDolly Plugin

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

apply plugin: 'channel'

添加对VasDolly helper类库的依赖

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

dependencies {

api 'com.leon.channel:helper:2.0.3'

}

配置渠道列表

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

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

channel_file=channel.txt

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

channel{

//指定渠道文件

channelFile = file("/Users/leon/Downloads/testChannel.txt")

}

rebuildChannel{

//指定渠道文件

channelFile = file("/Users/leon/Downloads/testReChannel.txt")

}

通过Gradle生成多渠道包

直接编译生成多渠道包

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

channel{

//指定渠道文件

channelFile = file("/Users/leon/Downloads/testChannel.txt")

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

baseOutputDir = new File(project.buildDir,"xxx")

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

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

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

isFastMode = false

//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指定的渠道列表拥有更高的优先级,且和原始的文件方式是互斥的。

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

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

rebuildChannel {

//指定渠道文件

channelFile = file("/Users/leon/Downloads/testReChannel.txt")

baseDebugApk = 已有Debug APK

baseReleaseApk = 已有Release APK

//默认为new File(project.buildDir, "rebuildChannel/debug")

debugOutputDir = Debug渠道包输出目录

//默认为new File(project.buildDir, "rebuildChannel/release")

releaseOutputDir = Release渠道包输出目录

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

isFastMode = false

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

lowMemory = false

}

然后,通过gradle rebuildChannel命令生成多渠道包。

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

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

从V1.0.5版本开始支持命令行,具体使用文档可参考command目录下的README。

读取渠道信息

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

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

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

Demo参考

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

实现原理

问题反馈

遇到任何问题或者有好的建议,欢迎提issues,或者QQ(1031747903)联系。

TODO

增加单元测试

防渠道信息篡改

提供Python脚本

License

VasDolly is under the BSD license. See the LICENSE file for details.

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值