ApkMultiChannelPlugin
这是一个为了方便 Android 多渠道打包的 Android Studio / IDEA 插件:
- 支持 v2 签名:jarsigner 和 apksigner
- 支持 2 种渠道打包方式:
- 修改 AndroidManifest.xml 的 meta-data (name 为 UMENG_CHANNEL) 的 value 值,没有则插入,然后重新打包签名
- 美团的方式,直接往 apk 的 META-INF 目录里添加空文件(文件名为:c_ 渠道)
- packer-ng-plugin 的方式,往 apk 注释字段保存渠道号和验证标记字节
安装
- 打开 Android Studio: 打开
Setting/Preferences -> Plugins -> Browse repositories
然后搜索ApkMultiChannel
安装重启
或者
- 下载 ApkMultiChannelPlugin.jar
然后
Setting/Preferences -> Plugins -> Install plugin from disk
选择ApkMultiChannelPlugin.jar
安装重启
使用方式
1. 选择 apk
选择一个 apk 然后右键,点击 Build MultiChannel
2. 配置
配置签名信息,打包方式和渠道等
配置说明:
Key Store Path: 签名文件的路径
Key Store Password: 签名文件的密码
Key Alias: 密钥别名
Key Password: 密钥密码
Zipalign Path: zipalign 文件的路径(用于优化 apk;zipalign 可以确保所有未压缩的数据均是以相对于文件开始部分的特定字节对齐开始,这样可减少应用消耗的 RAM 量。)
Signer Version: 选择签名版本:apksigner 和 jarsigner
Build Type: 打包方式
Channels: 渠道列表,每行一个,最前面可加 >
或不加(保存信息的时候,程序会自行加上)
3. 开始打包
配置完成之后按 OK 就会开始进行渠道打包,文件会输出在选中的 apk 的当前目录下的 channels 目录中
说明
在开始打包前,配置信息先会保存在项目根目录的 channels.properties:
渠道可以直接在 channels.properties 添加(这里必须要在前面加 >
,为了方便解析,只有加了 >
才会参与打包),也可以删除和注释(#)
配置完后,想改配置但是又不想直接修改 channels.properties 文件的话,可以在 Build > Channel Setting
打开配置界面,
在这里打开配置界面按 OK 按钮后不会自动开始打包,仅用于修改配置。
Build Type 说明
update AndroidManifest.xml
先解压提取 AndroidManifest.xml 文件到 temp 文件夹中,然后根据渠道列表配置修改 meta-data,复制 1 个 apk 到 channels 文件夹下(除了 META-INF 目录下的签名文件), 同时替换 AndroidManifest.xml,最后重新签名。
add channel file to META-INF
复制 1 个 apk,先检查签名版本,如果未签名则进行签名(配置选择 jarsigner 则在渠道打包前签名,apksigner 则是添加空文件到其 META-INF 目录后再签名)。 读取渠道:ChannelHelper
write zip comment
先判断选中的 apk 中 comment 是否含有 SIGN 字节,如果有则不进行渠道打包并提示;之后检查是否是 v2 签名,如果是 v2,则复制 1 个不带签名文件的 apk 到 temp 文件夹并重新签名为 v1,
最后开始渠道打包。( v2 签名之后不能修改 ZIP End of Central Directory
区块,而且如果先修改 ZIP End of Central Directory
区块再 v2 签名,comment 会被抹掉。)
读取渠道:ZipCommentHelper
以后要加的功能
- 添加支持选择项目路径外的 apk 文件进行多渠道打包
- buildType 添加支持美团新一代渠道包生成方式 Walle
有什么问题欢迎大家在 Issues 中提问
参考致谢
- ntop001/AXMLEditor
- Bilibili/apk-channelization
- 美团 Android 自动化之旅—生成渠道包
- apksigner
- packer-ng-plugin
- 新一代开源 Android 渠道包生成工具 Walle
- apksig
License
GPL-3.0