在日常开发中，可能会遇到同一份代码，需要根据运营需求打出不同包名、不同图标、不同名称的Apk，发布到不同的渠道中。Android Studio提供了便捷的多渠道打包实现方法`productFlavors`。本文介绍一下使用`productFlavors`来实现多渠道打包。 ## 创建productFlavors - 添加Dimension 在app包下的build.gradle中的android闭包下，添加`flavorDimension`，代码如下： ``` android { ... // 方式1 getFlavorDimensionList().add('example_value') // 方式2 flavorDimensions "example_value" } ``` 两种方式选择一种即可，方式1有代码补全提示，方式2没有。 - 创建productFlavor 在app包下的build.gradle中的android闭包下，创建`productFlavors`，代码如下： ``` android { ... productFlavors { // 原始渠道 origin{ // 这里的值与前面flavorDimensions设置的值保持一致 dimension 'example_value' } // 示例渠道 exampleFlavor { // 这里的值与前面flavorDimensions设置的值保持一致 dimension 'example_value' } } } ``` 网上找到的相关文章都说`productFlavor`中需要配置`dimension`，但是在尝试的过程中发现，如果只添加了一个`flavorDimensions`，那么`productFlavor`中的`dimension`可以不用特别声明（我的gradle版本为7.6，AGP为7.4.1）。构建完后可以在Build Variants中看到已配置的变体，如图：屏幕截图(8).png

## 渠道包参数配置打渠道包时，根据需求可能会需要配置不同参数，例如App的名称、图标、版本信息，服务器地址等。 - 配置不同的签名信息如果需要使用不同的签名文件，可以在app包下的build.gradle中的android闭包下配置`signingConfigs`，代码如下： ``` android { signingConfigs { origin { keyAlias 'expampledemo' keyPassword '123456' storeFile file('ExampleDemo') storePassword '123456' } exampleFlavor { keyAlias 'exampledemoflavor' keyPassword '123456' storeFile file('ExampleDemoFlavor.jks') storePassword '123456' } } flavorDimensions "example_value" productFlavors { origin{ signingConfig signingConfigs.origin } exampleFlavor { signingConfig signingConfigs.exampleFlavor } } buildTypes { debug { // 需要移除默认签名 signingConfig null } release { // 需要移除默认签名 signingConfig null } } } ``` 需要注意的是`signingConfigs`必须在`productFlavors`前面声明，否则构建会失败。 - 配置包名、版本号在`productFlavors`中可以配置渠道包的包名、版本信息，代码如下： ``` android { ... defaultConfig { applicationId "com.chenyihong.exampledemo" versionCode 1 versionName "1.0" ... } productFlavors { origin{ ... } exampleFlavor { applicationId "com.chenyihong.exampledflavordemo" versionCode 2 versionName "1.0.2-flavor" } } } ``` origin渠道表示的是原始包，不进行额外配置，使用的就是defaultConfig中声明的包名以及版本号。效果如图： origin ![1676109942922.png](https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/2be7d817ab9c465fbb16a23c9d5d53e9~tplv-k3u1fbpfcp-watermark.image?) exampleFlavor ![1676110092402.png](https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/590bf7d32014469a852f30cbbef04113~tplv-k3u1fbpfcp-watermark.image?) - 配置BuildConfig，字符串资源在`productFlavors`中配置BuildConfig或者resValue，可以让同名字段，在打不同的渠道包时有不同的值，代码如下： ``` android { ... productFlavors { origin{ buildConfigField("String", "example_value", "\"origin server address\"") resValue("string", "example_value", "origin tips") } exampleFlavor { buildConfigField("String", "example_value", "\"flavor server address\"") resValue("string", "example_value", "flavor tips") } } } ``` 配置完后重新构建一下项目，就可以通过`BuildConfig.example_value`以及`getString(R.string.example_value)`来使用配置的字段。效果如图： origin ![1676110403151.png](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/fa2738a0ca304298846946e5a893614f~tplv-k3u1fbpfcp-watermark.image?) exampleFlavor ![1676110302147.png](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/7d838d30c7d247e3b6525e9440233c81~tplv-k3u1fbpfcp-watermark.image?) - 配置manifestPlaceholders 有些三方SDK，会在Manifest中配置`meta-data`，并且这些值跟包名大概率是绑定的，因此不同渠道包需要替换不同的值，代码如下： ```

....

android { ... productFlavors { origin{ manifestPlaceholders = [channel_value: "origin channel"] } exampleFlavor { manifestPlaceholders = [channel_value: "flavor channel"] } } } ``` 效果如图： origin ![1676109422577.png](https://p6-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/eef9d29b5496482698be6edc62735ce6~tplv-k3u1fbpfcp-watermark.image?) exampleFlavor ![1676109298513.png](https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/aadd86e2e62a40aba19b16158e08a651~tplv-k3u1fbpfcp-watermark.image?) - 配置不同的依赖不同渠道包可能会引用不同的三方SDK，配置了`productFlavors`后，可以在`dependencies`中区分依赖包，代码如下： ``` dependencies { // origin 包依赖 originImplementation("com.google.code.gson:gson:2.10.1") // exampleFlavor包依赖 exampleFlavorImplementation("com.google.android.gms:play-services-auth:20.4.1") } ``` 示例：在`FlavorExampleActivity`中同时导入Gson包和Google登录包，效果如下： origin

exampleFlavor

- 配置不同的资源在app/src目录下，创建exampleFlavor文件夹，创建与main包下一样的资源文件夹，打渠道包时，相同目录下同名的文件会自动替换，可以通过这种方式来实现替换应用名称和应用图标。 ![1676111680651.png](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/3854bfa5f81846a8bf51fe9be57de056~tplv-k3u1fbpfcp-watermark.image?) 效果如图：

## 示例Demo 按照惯例，在示例Demo中添加了相关的演示代码。 [ExampleDemo github](https://github.com/ChenYiHong930921/example-demo) [ExampleDemo gitee](https://gitee.com/ChenYhong0921/example-demo)