packer-ng-plugin 下一代 Android 渠道打包工具 @codeKK AndroidOpen Source Website

packer-ng-plugin

Introduction: 下一代 Android 渠道打包工具

Tags:

提示：本项目已停止新功能开发，有需要的请自行 Fork 修改

对 Gradle 7.x 的支持，欢迎提 PR，或者 Fork 自己修改（2022.06.27）

极速渠道打包工具

v2.0.1 - 2018.03.23 - 支持 Android Plugin 3.x 和 Gradle 4.x
v2.0.0 - 2017.06.23 - 全新发布，支持 V2 签名模式，包含多项优化

特别提示

V2 版只支持APK Signature Scheme v2，要求在 signingConfigs 里 v2SigningEnabled true 启用新版签名模式，如果你需要使用旧版本，看这里 v1.0.9。

项目介绍

packer-ng-plugin 是下一代 Android 渠道打包工具 Gradle 插件，支持极速打包，100个渠道包只需要10秒钟，速度是 gradle-packer-plugin 的300倍以上，可方便的用于 CI 系统集成，同时提供命令行打包脚本，渠道读取提供 Python 和 C 语言的实现。

使用指南

Maven Central

修改项目配置

// build.gradle
buildscript {
    dependencies{
        classpath 'com.mcxiaoke.packer-ng:plugin:2.0.1'
    }
}

修改模块配置

apply plugin: 'packer'
// build.gradle
dependencies {
    compile 'com.mcxiaoke.packer-ng:helper:2.0.1'
}

注意：plugin 和 helper 的版本号需要保持一致

插件配置示例

packer {
    archiveNameFormat = '${buildType}-v${versionName}-${channel}'
    archiveOutput = new File(project.rootProject.buildDir, "apks")
//    channelList = ['*Douban*', 'Google/', '中文/@#市场', 'Hello@World',
//                   'GradleTest', '20070601!@#$%^&*(){}:"<>?-=[];\',./']
//    channelFile = new File(project.rootDir, "markets.txt")
    channelMap = [
            "Cat" : project.rootProject.file("channels/cat.txt"),
            "Dog" : project.rootProject.file("channels/dog.txt"),
            "Fish": project.rootProject.file("channels/channels.txt")
    ]
}

archiveNameFormat - 指定最终输出的渠道包文件名的格式模版，详细说明见后面，默认值是 ${appPkg}-${channel}-${buildType}-v${versionName}-${versionCode} (可选)
archiveOutput - 指定最终输出的渠道包的存储位置，默认值是 ${project.buildDir}/archives (可选)
channelList - 指定渠道列表，List 类型，见示例
channelMap - 根据 productFlavor 指定不同的渠道列表文件，见示例
channelFile - 指定渠道列表文件，File 类型，见示例

注意：channelList / channelMap / channelFile 不能同时使用，根据实际情况选择一种即可，三个属性同时存在时优先级为： channelList > channelMap > channelFile，另外，这三个属性会被命令行参数 -Pchannels 覆盖。

渠道列表格式

渠道名列表文件是纯文本文件，按行读取，每行一个渠道，行首和行尾的空白会被忽略，如果有注释，渠道名和注释之间用 # 分割。

渠道名建议尽量使用规范的中英文和数字，不要使用特殊字符和不可见字符。示例：channels.txt

集成打包

项目中没有使用 productFlavors
```
  ./gradlew clean apkRelease
```
项目中使用了 productFlavors

如果项目中指定了多个 flavor ，需要指定需要打渠道包的 flavor 名字，假设你有 Paid Free 两个 flavor ，打包的时候命令如下：
```
  ./gradlew clean apkPaidRelease
  ./gradlew clean apkFreeRelease
```
直接使用 ./gradlew clean apkRelease 会输出所有 flavor 的渠道包。
通过参数直接指定渠道列表(会覆盖build.gradle中的属性)：
```
  ./gradlew clean apkRelease -Pchannels=ch1,ch2,douban,google
```
渠道数目很少时可以使用此种方式。
通过参数指定渠道列表文件的位置(会覆盖build.gradle中的属性)：
```
  ./gradlew clean apkRelease -Pchannels=@channels.txt
```
使用@符号指定渠道列表文件的位置，使用相对于项目根目录的相对路径。
还可以指定输出目录和文件名格式模版：
```
  ./gradlew clean apkRelease -Poutput=build/apks
  ./gradlew clean apkRelease -Pformat=${versionName}-${channel}
```
这些参数 channels output format 可以组合使用，命令行参数会覆盖 build.gradle 对应的属性。
Gradle 打包命令说明

渠道打包的 Task 名字是 apk${flavor}${buildType} buildType 一般是 release，也可以是你自己指定的 beta 或者 someOtherType，如果没有 flavor 可以忽略，使用时首字母需要大写，假设 flavor 是 Paid，release类型对应的任务名是 apkPaidRelease，beta类型对应的任务名是 apkPaidBetaBeta，其它的以此类推。
特别提示

如果你同时使用其它的资源压缩工具或应用加固功能，请使用命令行脚本打包增加渠道信息，增加渠道信息需要放在 APK 处理过程的最后一步。

脚本打包

除了使用 Gradle 集成以外，还可以使用项目提供的 Java 脚本打包，Jar 位于本项目的 tools 目录，请使用最新版，以下用 packer-ng 指代 java -jar tools/packer-ng-2.0.1.jar，下面是几个示例。

参数说明：

packer-ng - 表示 java -jar packer-ng-2.0.1.jar
channels.txt - 替换成你的渠道列表文件的实际路径
build/archives - 替换成你指定的渠道包的输出路径
app.apk - 替换成你要打渠道包的 APK 文件的实际路径

直接指定渠道列表打包：

packer-ng generate --channels=ch1,ch2,ch3 --output=build/archives app.apk

指定渠道列表文件打包：

packer-ng generate --channels=@channels.txt --output=build/archives app.apk

验证渠道信息：

packer-ng verify app.apk

运行命令查看帮助

java -jar tools/packer-ng-2.0.1.jar --help

Python 脚本读取渠道：

python tools/packer-ng-v2.py app.apk

C 程序读取渠道：

cd tools
make
make install
packer app.apk

代码中读取渠道

// 如果没有找到渠道信息或遇到错误，默认返回的是""
// com.mcxiaoke.packer.helper.PackerNg
String channel = PackerNg.getChannel(Context)

文件名格式模版

格式模版使用 Groovy 字符串模版引擎，默认文件名格式是： ${appPkg}-${channel}-${buildType}-v${versionName}-${versionCode} 。

假如你的 App 包名是 com.your.company ，渠道名是 Google_Play ，buildType 是 release ，versionName 是 2.1.15 ，versionCode 是 200115 ，那么生成的默认 APK 的文件名是 com.your.company-Google_Player-release-2.1.15-20015.apk 。

可使用以下变量:

projectName - 项目名字
appName - App 模块名字
appPkg - applicationId (App 包名 packageName)
channel - 打包时指定的渠道名
buildType - buildType (release/debug/beta 等)
flavor - flavor (flavor 名字，如 paid/free 等)
versionName - versionName (显示用的版本号)
versionCode - versionCode (内部版本号)
buildTime - buildTime (编译构建日期时间)
fileSHA1 - fileSHA1 (最终 APK 文件的 SHA1 哈希值)

其它说明

渠道读取 C 语言实现使用 GenericMakefile 构建，APK Signing Block 读取和写入 Java 实现修改自 apksig 和 walle ，特此致谢。

关于作者

联系方式

开源项目

Rx 文档中文翻译: https://github.com/mcxiaoke/RxDocs
MQTT 协议中文版: https://github.com/mcxiaoke/mqtt
Awesome-Kotlin: https://github.com/mcxiaoke/awesome-kotlin
Kotlin-Koi: https://github.com/mcxiaoke/kotlin-koi
Next 公共组件库: https://github.com/mcxiaoke/Android-Next
Gradle 渠道打包: https://github.com/mcxiaoke/gradle-packer-plugin
EventBus 实现 xBus: https://github.com/mcxiaoke/xBus
蘑菇饭 App: https://github.com/mcxiaoke/minicat

License

Copyright 2014 - 2021 Xiaoke Zhang

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Apps

Android Developer Tools

Android Developer Tools Pro

About Me

Tools: TimeShining

GitHub: Trinea

Facebook: Dev Tools

JSON Format, Support error correction

MD5/SHA Encode, Support batch

Text Process

CSS Format and Compress