{"id":9,"title":"使用build.gradle实现安卓APP的多版本发布","abstraction":"在构建持续部署（CD, Continuous Deployment）流水线时，经常会遇到针对不同的用户发布不同特性的需求。Android Studio为build.gradle设计了一系列概念和语法，帮助我们方便地实现这些需求。","content":"

在构建持续部署（CD, Continuous Deployment）流水线时，经常会遇到针对不同的用户发布不同特性的需求。Android Studio为build.gradle设计了一系列概念和语法，帮助我们方便地实现这些需求。

基本概念

Build Variant：是指最终发布的APP的变体，例如针对免费版用户发布Free版、针对付费版用户发布Pro版，两者可以使用不同的代码集、资源、包名。变体（Variant）在build.gradle中不是直接指定的，而是通过Build Type和Product Flavor的组合来指定。
Build Type：用于指定APP的编译、打包配置，包含是否保留调试信息、使用哪一组签名信息等。Android Studio默认使用debug和release两种Build Type。
Product Flavor：用户于指定软件特性和设备需求，例如使用哪些源代码、资源文件，最低支持的API版本等。在与Build Type组合后，可以定义多种Build Variant。例如增加一个名为demo的flavor后，就可以分别编译出debugDemo、releaseDemo两种软件安装包。

典型需求

下面以一种常见的需求为例，说明如何使用build.gradle.kts。在安卓APP开发过程中，我们会碰到开发过程中的APP和Release版本签名过的APP无法同时安装的问题，这就是因为两者的包名有冲突，无法同时安装在同一部手机中。也会遇到开发过程需要连接服务器localhost，而最终发布版的APP需要连接远程服务器的需求。这两个需求可以更明确地使用上述术语进行定义：

需要定义两种Build Type，使用不同的签名和包名信息；
需要定义两种Product Flavor，使用不同的服务器连接地址。

定义Build Type

这里以Kotlin语法进行定义，注意build.gradle.kts是以kts结尾的。

android {\n     defaultConfig {\n        applicationId = \"com.example.demo\"\n    }\n\n    signingConfigs {\n        create(\"release\") {\n            storeFile = file(\"/home/john/some-keystore.jks\")\n            storePassword = \"The-Password\"\n            keyAlias = \"Key-Alias\"\n            keyPassword = \"The-Password\"\n        }\n    }\n     \n    buildTypes {\n        getByName(\"release\") {\n            isMinifyEnabled = true\n            signingConfig = signingConfigs.getByName(\"release\")\n            proguardFiles(getDefaultProguardFile(\"proguard-android.txt\"), \"proguard-rules.pro\")\n        }\n\n        getByName(\"debug\") {\n            applicationIdSuffix = \".debug\"\n            isDebuggable = true\n        }\n    }\n}

通过上面的定义，就实现了Debug版本的APP包名为com.example.demo.debug，而Release版本的APP包名为com.exmaple.demo。另外，注意这里的KeyStore密码直接写入在源代码中，您可以替换为环境变量，以增加安全性。

定义Product Flavor

这里定义两种Flavor，分别使用local和remote指代开发版、发布版。但是，Google在这里增加了一个术语：Flavor Dimension。所谓Flavor Dimension，我们可将它理解为定义软件的一个维度，通过定义多个维度，可以组合出更多种类的安装包。例如定义两种Flavor Dimension，一种Dimension定义服务器的远程连接地址，一种Dimension定义UI界面，那么就可以排列组合出不同的安装包了，排列组织的过程是Gradle自动完成的。

我们定义的需求较为简单，所以这里只定义一种Dimension，称其为env。

android {\n    ...\n    defaultConfig {...}\n\n    flavorDimensions += \"env\"\n    productFlavors {\n        create(\"local\") {\n            dimension = \"env\"\n        }\n        create(\"remote\") {\n            dimension = \"env\"\n        }\n    }\n}

定义代码集

上面定义的两种Product Flavor可以使用不同的源代码，假设我们将服务器的远程连接地址定义在一个Constant.kt文件中，则需要在app/src/目录下新建子目录local和remote，并按照Java对目录、包名的约定建立子文件夹。具体来讲，local环境的文件内容如下：

// 文件位置：app/src/local/java/com/example/demo/falvors\npackage com.example.demo.flavors\n\nobject Constant {\n    const val API_SERVER = \"http://192.168.2.1:3000\"\n}

remote环境的文件内容如下：

// 文件位置：app/src/remote/java/com/example/demo/falvors\npackage com.example.demo.flavors\n\nobject Constant {\n    const val API_SERVER = \"https://www.some.address.com\"\n}

编译

通过上面的定义，现在我们就可以在Android Studio调试APP，并使用gradle工具编译待发布的版本，且两者可以同时安装同一部设备中。使用命令行编译Release版本的方法如下：

# 注意这里的assemble是固定的，后面的Remote代表Product Flavor，Release代表Build Type\n./gradlew assembleRemoteRelease

","user_id":1,"published":true,"created_at":1742516429141,"updated_at":1743039698294,"visits":0}