原生移动开发 / 系统课时

批量生成多渠道 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。

多渠道 Release 批量构建与归档流程

命名规则最好只包含可稳定推导的字段。时间戳虽然能避免重名,但会降低复现性;若确实需要唯一标识,更适合附加 CI 构建号或 Git 提交短哈希,并在发布系统中保存对应关系。

注册批量构建和归档任务

下面是 app/build.gradle.kts 的片段示例,依赖已有 Android Application 插件,并假设没有启用 ABI 或 density split。三个渠道共享 defaultConfig.versionName,Release 签名仍由项目现有签名配置负责。

kotlin
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 包

执行归档任务即可触发它依赖的全部渠道构建:

bash
./gradlew :app:collectMarketRelease

预期输出:

text
BUILD SUCCESSFUL in <TIME>

Gradle 可能把已经完成且输入未变化的任务标记为 UP-TO-DATE,也可能根据本机并行设置调整执行顺序;这些差异不影响最终结果。若任意一个渠道编译、资源合并或签名失败,聚合任务应整体失败,而不是悄悄跳过该渠道。

检查产物数量和文件名

构建成功后,不要只看 BUILD SUCCESSFUL。还要确认归档目录里的 APK 数量与渠道清单一致,并检查文件名包含正确版本和渠道。下面的命令适用于 Bash:

bash
for file in app/build/channel-release/*.apk; do
    basename "$file"
done | sort

预期输出:

text
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 产物,就能显著降低多市场发布时的人为差错。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

批量生成多渠道 Release 包

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通