【Android】多渠道打包配置

简介

多渠道打包 是指在打包一个 Android 应用时，一次编译生成多个 APK 文件，每个 APK 文件针对一个特定的渠道。不同的渠道可能代表不同的应用商店、推广合作伙伴、地区等。每个渠道可能有不同的配置，例如不同的包名、资源、应用 ID、签名信息等。

打包配置

在打包之前，先聊一下我的需求。

我现在想打三个渠道的包，分别为 xiaomi、huawei、meizu。通过多渠道打包的方式能够实现一次编译打三个包，且通过多渠道打包生成的包生成位置不同、包名不同的 App、AndroidManifest.xml 文件不同的包。

在 Android Studio 里，打包是由 Gradle 脚本去完成，因此，毫无疑问，以下的一些配置都是写在了 build.gradle 文件里。

由于 build.gradle 文件是从上往下执行的，因此，导入其它插件的代码一般写在最上面第一二行的位置。在 build.gradle 文件中，部分配置是有一个先后的执行顺序，就是说，他们的先后执行顺序如果错乱，就会出现各种奇怪的问题。

签名配置

多渠道打包 app 的签名配置在了 signingConfigs 里，分为了三个签名配置，分别是 xiaomiSigningConfigs 、huaweiSigningConfigs 、meizuSigningConfigs 。

android {
	. . .
	// 多渠道打包签名配置
    signingConfigs {
		// 配置 xiaomi 渠道的签名
        xiaomiSigningConfigs {
            storeFile file('../keystore/xiaomi.jks')
            storePassword '123456'
            keyAlias 'xiaomi'
            keyPassword '123456'
        }
		// 配置 huawei 渠道的签名
        huaweiSigningConfigs {
            storeFile file('../keystore/huawei.jks')
            storePassword '123456'
            keyAlias 'huawei'
            keyPassword '123456'
        }
		// 配置 meizu 渠道的签名
        meizuSigningConfigs {
            storeFile file('../keystore/meizu.jks')
            storePassword '123456'
            keyAlias 'meizu'
            keyPassword '123456'
        }
    }
    . . .
}

PS：填写 storeFile 的 jks 文件配置时，需确认所在路径是否存在相应的 jks 文件，否则会在 Sync Now 或打包的时候出现某些奇奇怪怪的问题。

渠道配置

android {
	. . .
	// 配置渠道
    productFlavors {
        // xiaomi渠道
        xiaomi {
            // 配置与ndk相关的配置
            ndk {
                // 配置打包的安装包支持的设备架构
                abiFilters 'arm64-v8a', 'armeabi-v7a'
            }
            // 在包名后面添加包名的内容
            applicationIdSuffix '.xiaomi'
            // 替换strings.xml文件里对应名称的值
            resValue "string", "app_name", "@string/app_name_xiaomi"
            // 配置渠道打包所需的签名
            signingConfig signingConfigs.xiaomiSigningConfigs
        }
        // huawei渠道
        huawei {
            applicationIdSuffix '.huawei'
            ndk {
                abiFilters 'arm64-v8a', 'armeabi-v7a'
            }
            resValue "string", "app_name", "@string/app_name_huawei"
            signingConfig signingConfigs.huaweiSigningConfigs
        }
        // meizu渠道
        meizu {
            applicationIdSuffix '.meizu'
            ndk {
                abiFilters 'arm64-v8a', 'armeabi-v7a'
            }
            resValue "string", "app_name", "@string/app_name_meizu"
            signingConfig signingConfigs.meizuSigningConfigs
        }
    }
    . . .
}

PS：在渠道包配置里写了与签名相关的配置后，就不能够在 buildTypes 里写，否则会 buildTypes 的签名被覆盖，且打包时只能使用命令行打包，使用开发工具打包签名会被选择打包签名的那一个签名给覆盖掉。

配置打包出来的App名称

android {
	. . .
    // 配置各个渠道包打包出来的app名称
    def buildTime = buildTime()
    android.applicationVariants.configureEach { variant ->
    	// 根据渠道名称判断打的渠道包是什么
        if (variant.name.contains('xiaomi')) {
            variant.outputs.configureEach { output ->
	            // 修改打出来的包的名称
                output.outputFileName = "多渠道打包-xiaomi-${buildTime}.apk"
            }
        } else if (variant.name.contains('huawei')) {
            variant.outputs.configureEach { output ->
                output.outputFileName = "多渠道打包-huawei-${buildTime}.apk"
            }
        } else if (variant.name.contains('meizu')) {
            variant.outputs.configureEach { output ->
                output.outputFileName = "多渠道打包`-meizu-${buildTime}.apk"
            }
        }
    }
    . . . 
}

正式包与测试包配置

android {
	. . .
	// 配置buildTypes
    buildTypes {
        // 配置打release包时的配置
        release {
        	// 配置打release包时的签名（经过测试，无效果）
            signingConfig signingConfigs.xiaomiSigningConfigs
            debuggable false // 打出来的包是否包含调试信息
            minifyEnabled false  // 启用或禁用代码混淆
            shrinkResources false // 是否移除未使用的资源
            zipAlignEnabled true // 控制是否对apk进行优化
            testCoverageEnabled false // 是否启用代码覆盖率报告
            versionNameSuffix '-xiaomi' // 附加打包版本名称后缀
            multiDexEnabled true // 是否启用多dex支持（适用于方法数超过65536的应用）
            embedMicroApp false // 配置是否将微应用嵌入到主应用中
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
        // 配置打debug包时的配置
        debug {
            signingConfig signingConfigs.xiaomiSigningConfigs
            minifyEnabled false
            shrinkResources false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    . . .
}

打包方式

开发工具打包

打开 Android Studio，在顶部菜单栏依次选择 Build 👉 Generate Signed App Bundle / Apk

打包可以选择多个渠道打包，快捷键为 Control + 鼠标左键 ，如下：

点击 Create 再过几分钟就会在 Module 下面生成对应的 app。

PS：使用 Android Studio 开发工具打包，多个app一起打包时，无法生成不同签名的app，最终打出来的app签名都会是同一个。

命令行打包

使用命令行打包前，需要提前配置好 Java 环境，并将其添加到系统的环境变量。

点击打开 Android Studio 的 Terminal ，输入 ./gradlew 确定是否可以正常使用。

./gradlew

若已经完成多渠道的相关配置，继续执行 ./graldew tasks 查看可执行的命令，命令及执行结果如下：

./graldew tasks

上图的执行结果展示了可执行的任务，打所有渠道的正式包使用的是 assembleRelease 命令：

./graldew assembleRelease

执行完成如下图所示：

使用命令行打包不会提示打的包保存在了哪里，可以到该路径下查看 项目所在路径\csdn-demo\multi-channel-package\build\outputs\apk\。

优缺点

优点

• 通过多渠道打包，可以统一管理应用的不同版本，简化发布流程和后续维护。
• 可以分别统计每个渠道的下载量、活跃用户、用户留存等数据，从而进行更精细的运营和推广。
• 可以针对不同市场定制不同版本的应用，满足不同国家和地区的法律法规、文化习惯和用户需求。
• 不同渠道可以使用不同的资源配置（如图标、启动页、应用名称等），满足不同市场或合作伙伴的需求。
• 不同的合作伙伴可能有不同的要求，通过多渠道打包可以更好地满足他们的需求，从而提升合作伙伴的满意度。

缺点

• 需要为不同渠道配置不同的资源和代码，增加了开发和维护的复杂度和工作量。
• 需要管理多个市场和渠道的发布和更新，这可能导致市场碎片化和管理难度增加。
• 不同渠道的资源配置可能会导致资源冗余，增大APK文件的体积，占用更多的存储空间。
• 多渠道打包需要配置多个构建变体，构建和发布流程变得更复杂，需要更细致的管理和协调。
• 不同渠道版本的应用可能存在差异，容易导致一些特定渠道版本出现质量问题，需要更多的测试和质量保证工作。

常见问题

• Caused by: groovy.lang.MissingMethodException: No signature of method: java.lang.Integer.call() is applicable for argument types: (build_dnmb91jd12bvybe4o3deskrm1${}_{r}u{n}_{c}losure1$_closure4${}_{c}losure10)values:[buil{d}_{d}nmb91jd12bvybe4o3deskrm1$_run_closure1${}_{c}losure4$_closure10@5e0c18f1]
  解决办法：buildTypes 对象里的参数不能以数字命名。
• Caused by: groovy.lang.MissingPropertyException: Could not get unknown property ‘xiaomiSigningConfigs’ for SigningConfig container of type org.gradle.api.internal.FactoryNamedDomainObjectContainer.
  解决办法：
  1、检查是否存在 xiaomiSigningConfigs 的配置。
  2、signingConfigs 的配置是否写在了 buildTypes 的下方。（由于 Gradle 编译顺序是从文件上往下编译的，如果 buildTypes 在 signingConfigs 的上方，意味着 buildTypes 会先被编译，自然会出现这种找不到 signingConfigs 里面配置的问题）

参考文档

• 配置 build 变体
• Gradle 官网