ApkChannelPackage项目VasDolly命令行工具使用指南

工具概述

ApkChannelPackage项目中的VasDolly命令行工具是一个强大的APK渠道包管理工具，专门为Android应用开发者设计。该工具基于Java 8环境运行，提供了完整的渠道包管理功能，包括渠道信息查询、添加、删除等操作。

环境准备

在使用VasDolly命令行工具前，请确保：

1. 已安装Java 8或更高版本
2. 系统环境变量中配置了Java路径
3. 准备好需要操作的APK文件

基础命令结构

所有命令都遵循以下基本结构：

java -jar VasDolly.jar [主命令] [选项] [参数]

功能详解

1. 获取APK签名方式

开发者可以通过此命令快速查看APK使用的签名方案（V1或V2签名）：

java -jar VasDolly.jar get -s /path/to/your.apk

2. 渠道信息管理

查询渠道信息

java -jar VasDolly.jar get -c /path/to/your.apk

删除渠道信息

java -jar VasDolly.jar remove -c /path/to/your.apk

3. 添加渠道信息

VasDolly提供了多种添加渠道的方式，满足不同场景需求。

单渠道添加

java -jar VasDolly.jar put -c "channel_name" /path/to/base.apk /output/path/

多渠道批量添加

java -jar VasDolly.jar put -c "channel1,channel2" /path/to/base.apk /output/path/

通过渠道文件批量添加

java -jar VasDolly.jar put -c channel_list.txt /path/to/base.apk /output/path/

4. 高级功能

多线程渠道打包

当渠道数量较多时，可以使用多线程模式显著提升打包速度：

java -jar VasDolly.jar put -mtc channel_list.txt /path/to/base.apk /output/path/

快速模式(FastMode)

对于不需要严格校验的场景，启用快速模式可提升10倍以上速度：

java -jar VasDolly.jar put -c channel_list.txt -f /path/to/base.apk /output/path/

使用建议

1. 对于少量渠道包，使用普通模式即可
2. 当渠道数量超过50个时，建议启用多线程模式
3. 在CI/CD流水线中，可以考虑使用快速模式提高效率
4. 正式发布前，建议使用标准模式生成最终渠道包

常见问题

1. Java版本不兼容：确保使用Java 8环境
2. 文件路径问题：建议使用绝对路径，避免相对路径导致的文件找不到错误
3. 渠道格式错误：渠道名不应包含特殊字符
4. 签名验证失败：确保基础APK已正确签名

性能优化

对于大型项目或渠道数量特别多的情况：

1. 结合使用多线程和快速模式
2. 在性能较强的构建服务器上执行打包操作
3. 考虑将渠道包生成任务拆分到多个节点并行执行

VasDolly命令行工具为Android渠道包管理提供了完整的解决方案，通过合理使用各种模式和选项，可以显著提高开发效率。