当前位置：首页 > 科技 > 软件

VasDolly服务端打渠道包教程

来源：责编：时间：2023-08-09 23:03:00 241观看

导读本文我将给大家介绍一个 apk 打包工具 VasDolly 的使用介绍、原理以及如何在服务端接入 VasDolly 进行服务端打渠道包操作。使用介绍图片VasDolly 是一个快速多渠道打包工具，同时支持基于 V1 和 V2 签名进行多渠道打包

本文我将给大家介绍一个 apk 打包工具 VasDolly 的使用介绍、原理以及如何在服务端接入 VasDolly 进行服务端打渠道包操作。

使用介绍

图片

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

项目地址：https://github.com/Tencent/VasDolly
项目构建方式：gradle

VasDolly 官方对于 VasDolly 的定位是安卓端多渠道打包工具，由安卓开发接入安卓项目中使用。VasDolly 官方还提供了 jar 包工具通过命令行方式进行打包操作。

在安卓项目中要使用 VasDolly，你需要先在你的项目中添加对 VasDolly 插件和 helper 类库的依赖。具体步骤如下：

在根工程的 build.gradle 中，添加对打包插件的依赖：

dependencies {    classpath 'com.android.tools.build:gradle:7.0.3'classpath 'com.tencent.vasdolly:plugin:3.0.6'}

在主 App 工程的 build.gradle 中，添加对 VasDolly 插件的引用：

apply plugin: 'com.tencent.vasdolly'

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

dependencies {    api 'com.tencent.vasdolly:helper:3.0.6'}

配置渠道列表。你可以通过两种方式配置渠道列表，一种是在 gradle.properties 文件中指定渠道文件名称，该渠道文件必须位于根工程目录下，一行一个渠道信息。例如：

channel_file=channel.txt

其中 channel.txt 文件内容如下：

yingyongbaogamecenterxiaomihuaweioppovivo

另一种方式是在 channel 或者 rebuildChannel 属性中通过 channelFile 属性指定渠道文件，一行一个渠道信息。例如：

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

通过 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 的多渠道包。如果你选择根据已有基础包重新生成多渠道包，你需要配置渠道文件、基础包的路径和渠道包的输出目录。例如：

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

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

原理

VasDolly 实现原理官方讲解地址：https://github.com/Tencent/VasDolly/wiki/VasDolly%E5%AE%9E%E7%8E%B0%E5%8E%9F%E7%90%86

VasDolly 的原理是利用 APK 文件的特殊结构，将渠道信息写入到 APK 文件的空白区域，从而实现无损的多渠道打包。具体来说，VasDolly 根据 APK 文件使用的签名类别，选择不同的多渠道打包方式。

如果 APK 文件使用的是 V1 签名，那么 VasDolly 会将渠道信息写入到 APK 文件的 Zip Comment 区域。Zip Comment 是 Zip 文件格式中的一个字段，用于存储一些注释信息，通常不会被解压缩工具或者系统解析。因此，将渠道信息写入到 Zip Comment 区域，不会影响 APK 文件的完整性和安全性。同时，由于 Zip Comment 区域位于 APK 文件的末尾，所以写入渠道信息的速度非常快，只需要修改一个字节的偏移量即可。

如果 APK 文件使用的是 V2 或者 V3 签名，那么 VasDolly 会将渠道信息写入到 APK Signing Block 区域。APK Signing Block 是 V2 或者 V3 签名引入的一个新区域，用于存储签名相关的数据。每个数据都有一个 ID 来标识其类型，例如 0x7109871a 表示 V2 签名数据。VasDolly 会使用一个自定义的 ID（0x71777777）来标识渠道信息，并将其写入到 APK Signing Block 区域。由于这个区域不会被系统解析，所以不会影响 APK 文件的安全性。同时，由于这个区域位于中央目录和 EOCD 之前，所以写入渠道信息的速度也很快，只需要修改两个字节的偏移量即可。

通过这种方式，VasDolly 可以实现在不重新签名和对齐的情况下，快速生成多个渠道包。在应用运行时，可以通过 VasDolly 提供的 helper 类库来读取渠道信息，并进行相应的处理。

服务端接入 VasDolly 教程

安卓接入了 VasDolly 之后，就该我们服务端出手了，服务端如果能实现渠道打包的操作，运营每次上新渠道就不需要再找安卓进行新渠道打包，运营直接在后台上传母包，选定渠道后即可获取对应的渠道包，可以节约大家的时间，避免耗费人力在渠道打包这一步。由此可见，服务端进行渠道打包操作还是有必要的。

意外发现

一开始我是想用官方提供的 jar 包工具，通过命令行调用的方式来实现服务端打渠道包的，官方提供的 readme 文档如下，

图片

但是由于博主项目是使用容器环境部署，要是用命令行打包的话，需要引入 VasDolly jar 包并且挂载都容器中，感觉比较麻烦。就想能不能直接引入 VasDolly 依赖来实现打包操作。

于是我在 maven 中央仓库搜索了 com.tencent.vasdolly 关键字后，有了如下发现，

图片

可以看到 VasDolly 虽然是一个 Gradle 项目，但是官方也提供了部分模块的在 Maven 中的 pom 坐标。

查看 VasDolly 仓库代码，发现官方定义了 write 模块，

图片

进入其中，发现了 readme 内容如下，

图片

Ok，到这里，我们发现其实官方提供了 pom 依赖接入，直接使用 ChannelWriter 即可实现渠道打包的操作。

具体教程

在后端 maven 项目中引入 VasDolly 的 pom 依赖，当前最新依赖版本如下，

<dependency>      <groupId>com.tencent.vasdolly</groupId>      <artifactId>writer</artifactId>      <version>3.0.6</version>  </dependency>  <dependency>      <groupId>com.tencent.vasdolly</groupId>      <artifactId>common</artifactId>      <version>3.0.6</version>  </dependency>  <dependency>      <groupId>com.tencent.vasdolly</groupId>      <artifactId>reader</artifactId>      <version>3.0.6</version>  </dependency>

然后我们就可以利用 ChannelWriter 类实现渠道打包操作，ChannelWriter 类提供的 V2 签名打渠道包方法如下：

public static void addChannelByV2(File apkFile, String channel, boolean lowMemory) throws IOException, SignatureNotFoundException {      addChannelByV2(apkFile, apkFile, channel, lowMemory);  }

addChannelByV2 方法的 apkFile 参数是母包文件，channel 参数是需要打包的渠道名称，lowMemory 参数是 V2 签名打渠道包提供的参数，默认为 false。该方法会直接将我们传入的 apkFile 母包修改成 V2 签名的渠道包。如此一来，我们就获得了我们需要的渠道包了。

除了利用 ChannelWriter 类实现打渠道包操作，我们还可以利用 ChannelReader 类来实现读取渠道包的渠道参数，ChannelReader 类提供的 V2 签名渠道包参数读取方法如下：

public static String getChannelByV2(File channelFile) {      System.out.println("try to read channel info from apk : " + channelFile.getAbsolutePath());      return IdValueReader.getStringValueById(channelFile, -2012129793);  }

getChannelByV2 方法的 channelFile 参数就是打包后渠道包，该方法会返回渠道包中的渠道信息。

本文链接：http://www.28at.com/showinfo-26-5156-0.htmlVasDolly服务端打渠道包教程

声明：本网页内容旨在传播知识，若有侵权等问题请及时与本网联系，我们将在第一时间删除处理。邮件：2376512515@qq.com

上一篇： SpringBoot3进阶用法，你学会了吗？

下一篇：图形编辑器开发：一些会用到的简单几何算法

标签：

热门焦点

石头自清洁扫拖机器人G10S评测：多年黑科技集大成之作懒人终极福音

科技圈经常能看到一个词叫“缝合怪”，用来形容那些把好多功能或者外观结合在一起的产品，通常这样的词是贬义词，但如果真的是产品缝合的好、缝合的实用的话，那它就成了中性词，今
28个SpringBoot项目中常用注解，日常开发、求职面试不再懵圈

前言在使用SpringBoot开发中或者在求职面试中都会使用到很多注解或者问到注解相关的知识。本文主要对一些常用的注解进行了总结，同时也会举出具体例子，供大家学习和参考。注解
摸鱼心法第一章——和配置文件说拜拜

为了能摸鱼我们团队做了容器化，但是带来的问题是服务配置文件很麻烦，然后大家在群里进行了“亲切友好”的沟通图片图片图片图片对比就对比，简单对比下独立配置中心和k8s作为配
Automa-通过连接块来自动化你的浏览器

1、前言通过浏览器插件可实现自动化脚本的录制与编写，具有代表性的工具就是：Selenium IDE、Katalon Recorder，对于简单的业务来说可快速实现自动化的上手工作。Selenium IDEKat
“又被陈思诚骗了”

作者｜张思齐出品｜众面（ID：ZhongMian_ZM）如今的国产悬疑电影，成了陈思诚的天下。最近大爆电影《消失的她》票房突破30亿断层夺魁暑期档，陈思诚再度风头无两。你可以说陈思诚的
认真聊聊东方甄选：如何告别低垂的果实

来源：山核桃作者：财经无忌爆火一年后，俞敏洪和他的东方甄选依旧是颇受外界关心的“网红”。7月5日至9日，为期5天的东方甄选“甘肃行”首次在自有App内直播，
四年持续更迭坚持探索行业无人之境，HarmonyOS 4带来五大升级多项创新

除了华为每年新发布的旗舰手机系列，上亿花粉更加期待鸿蒙系统每次的跨版本大更新。8月4日，HarmonyOS 4于HDC 2023正式发布，这也是该系统历经四年的再
2021中国国际消费电子博览会与青岛国际软件融合创新博览会新闻发布会隆重举行

9月18日，2021中国国际消费电子博览会与青岛国际软件融合创新博览会新闻发布会在青岛国际新闻中心隆重举行。发布会上青岛市政府领导联袂出席，对本次双展会情
亲历马斯克血洗Twitter，硅谷的苦日子在后头

文/刘哲铭　　编辑/李薇　　马斯克再次挥下裁员大刀。　　美国时间11月14日，Twitter约4400名外包员工遭解雇，此次被解雇的员工的主要工作为内容审核等。此前，T