腾讯 VasDolly 教程

JAVA herman 1054浏览 0评论

做开发的必须时刻关注新技术的发展!最近腾讯开源了 VasDolly 。它是一款 Android V1和V2签名通道包插件,本文将详细介绍它的相关用法。

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

VasDolly 组件特性

  1. 支持V1签名
  2. 支持V2签名
  3. 支持已有注释块的APK
  4. 支持根据已有基础包,生成渠道包
  5. 支持多线程加速打包
  6. 支持渠道包强校验,可以放心使用
  7. 支持两种接入方式:Android Gradle Plugin和命令行

VasDolly

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

signingConfigs {
	release {
		...
		v1SigningEnabled true
		v2SigningEnabled false
	}
// 业余草:www.xttblog.com
	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:1.1.7'
}

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

apply plugin: 'channel'

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

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

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

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

channel_file=channel.txt

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

channel{
    //指定渠道文件
    channelFile = file("/Users/leon/Downloads/testChannel.txt")
}
rebuildChannel{
    //指定渠道文件
    channelFile = file("/Users/leon/Downloads/testReChannel.txt")
}

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

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倍以上)
    isFastMode = false
}

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

  • appName : 当前project的name
  • versionName : 当前Variant的versionName
  • versionCode : 当前Variant的versionCode
  • buildType : 当前Variant的buildType,即debug or release
  • flavorName : 当前的渠道名称
  • appId : 当前Variant的applicationId

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

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

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倍以上)
  isFastMode = false
}

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

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

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

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

业余草公众号

最后,欢迎关注我的个人微信公众号:业余草(yyucao)!可加QQ1群:135430763(2000人群已满),QQ2群:454796847,QQ3群:187424846。QQ群进群密码:xttblog,想加微信群的朋友,可以微信搜索:xmtxtt,备注:“xttblog”,添加助理微信拉你进群。备注错误不会同意好友申请。再次感谢您的关注!后续有精彩内容会第一时间发给您!原创文章投稿请发送至532009913@qq.com邮箱。商务合作可添加助理微信进行沟通!

本文原文出处:业余草: » 腾讯 VasDolly 教程