原生移动开发 / 系统课时
批量生成多渠道 Release 包
批量生成多渠道 Release 包
渠道数量一多,逐个执行 assembleGoogleRelease、assembleHuaweiRelease 很容易漏包、拿错版本或留下命名不一致的产物。可以把所有 Release 变体收敛到一个 Gradle 入口,再统一复制和命名 APK,让 CI 与人工发包都只执行同一条命令。
学习目标
- 建立一个聚合 Gradle 任务批量构建多个 Release 渠道
- 用版本、渠道和构建类型生成稳定的产物文件名
- 验证批量任务没有漏渠道、混版本或覆盖产物
先固定渠道与命名规则
假设项目有 google、huawei、xiaomi 三个 Product Flavor,构建类型为 release,三者共享版本号 2.4.0。产物统一命名为 app-版本-渠道-release.apk,例如 app-2.4.0-google-release.apk。

命名规则最好只包含可稳定推导的字段。时间戳虽然能避免重名,但会降低复现性;若确实需要唯一标识,更适合附加 CI 构建号或 Git 提交短哈希,并在发布系统中保存对应关系。
注册批量构建和归档任务
下面是 app/build.gradle.kts 的片段示例,依赖已有 Android Application 插件,并假设没有启用 ABI 或 density split。三个渠道共享 defaultConfig.versionName,Release 签名仍由项目现有签名配置负责。
android {
defaultConfig {
versionName = "2.4.0"
}
flavorDimensions += "market"
productFlavors {
create("google") {
dimension = "market"
}
create("huawei") {
dimension = "market"
}
create("xiaomi") {
dimension = "market"
}
}
}
val marketChannels = listOf("google", "huawei", "xiaomi")
val artifactVersion = android.defaultConfig.versionName
?: error("defaultConfig.versionName must be set")
val assembleMarketRelease = tasks.register("assembleMarketRelease") {
dependsOn(
marketChannels.map { channel ->
val variant = channel.replaceFirstChar { it.uppercase() }
"assemble${variant}Release"
}
)
}
tasks.register<Copy>("collectMarketRelease") {
dependsOn(assembleMarketRelease)
into(layout.buildDirectory.dir("channel-release"))
marketChannels.forEach { channel ->
from(layout.buildDirectory.dir("outputs/apk/$channel/release")) {
include("*.apk")
rename {
"app-$artifactVersion-$channel-release.apk"
}
}
}
}assembleMarketRelease 只负责把三个标准 Android 构建任务聚合起来;collectMarketRelease 在它们完成后,把 APK 收集到 app/build/channel-release/。这样 CI 不需要知道每个渠道的原始输出文件名,只依赖最终归档目录和统一命名规则。
一条命令生成全部 Release 包
执行归档任务即可触发它依赖的全部渠道构建:
./gradlew :app:collectMarketRelease预期输出:
BUILD SUCCESSFUL in <TIME>Gradle 可能把已经完成且输入未变化的任务标记为 UP-TO-DATE,也可能根据本机并行设置调整执行顺序;这些差异不影响最终结果。若任意一个渠道编译、资源合并或签名失败,聚合任务应整体失败,而不是悄悄跳过该渠道。
检查产物数量和文件名
构建成功后,不要只看 BUILD SUCCESSFUL。还要确认归档目录里的 APK 数量与渠道清单一致,并检查文件名包含正确版本和渠道。下面的命令适用于 Bash:
for file in app/build/channel-release/*.apk; do
basename "$file"
done | sort预期输出:
app-2.4.0-google-release.apk
app-2.4.0-huawei-release.apk
app-2.4.0-xiaomi-release.apk如果缺少某个文件,先检查对应的 assemble<Channel>Release 任务是否存在并成功;如果出现同名覆盖,通常说明两个变体被映射成了相同文件名。CI 中还可以增加数量校验,要求最终 APK 数量与渠道清单严格一致。
处理常见边界
这套复制任务假设每个渠道只产生一个 APK。如果启用了 ABI、屏幕密度等 split,一个变体可能生成多个 APK,此时不能把它们全部重命名成同一个文件名,应把 ABI 或 density 也加入命名规则,否则复制阶段会发生覆盖。
同样,collectMarketRelease 不会自动把未签名 APK 变成可上架包。发布流水线仍要先正确配置 Release 签名,并根据目标市场决定交付 APK 还是 AAB;若市场要求 AAB,应改为聚合对应的 bundle<Channel>Release 任务,并为 Bundle 产物建立单独的归档逻辑。
批量任务的价值不是“少敲几条命令”,而是把渠道清单、构建类型和产物命名变成可审查的构建逻辑。只要单一入口能够稳定地产生完整、可区分、可追溯的 Release 产物,就能显著降低多市场发布时的人为差错。