在 Android 项目的 gradle 文件中熟练使用 productFlavors

2023-12-29 00:56:37

Android 项目中 gradle 文件中 productFlavors 的常见配置

在 Android 开发中，我们经常会遇到需要针对不同的环境或配置打包应用的情况。例如，我们可能需要为开发、测试和生产环境打包不同的版本。为了实现这个目的，Android Gradle 插件提供了 productFlavors 功能，它允许我们在项目中定义不同的产品风味，每个风味都可以针对特定的环境或配置进行自定义。

在 app/build.gradle 文件中，我们可以使用 productFlavors 块来定义不同的产品风味。每个产品风味都可以有自己的构建配置、依赖项和资源。

常用配置

下面是一些在 productFlavors 中常用的配置：

applicationIdSuffix ：为产品风味设置一个唯一的后缀，这将添加到应用程序的包名中。这对于为不同的风味创建具有唯一签名和安装路径的 APK 很有用。
versionNameSuffix ：为产品风味设置一个版本名称后缀，这将添加到应用程序的版本名称中。这对于区分不同风味之间的版本很有用。
minSdkVersion ：设置产品风味的最小 SDK 版本。这将确保应用程序仅在支持该版本或更高版本的设备上安装。
targetSdkVersion ：设置产品风味的 target SDK 版本。这将指示 Android 系统应用程序的预期运行时环境。
testInstrumentationRunner ：设置产品风味用于运行测试的测试工具。
resValue ：覆盖主模块的资源值。这允许为不同的产品风味自定义字符串、颜色和布局文件等资源。

示例

productFlavors {
    dev {
        applicationIdSuffix ".dev"
        versionNameSuffix "-dev"
        minSdkVersion 21
        targetSdkVersion 31
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        resValue "string", "app_name", "My App Dev"
    }
    test {
        applicationIdSuffix ".test"
        versionNameSuffix "-test"
        minSdkVersion 21
        targetSdkVersion 31
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        resValue "string", "app_name", "My App Test"
    }
    prod {
        applicationIdSuffix ""
        versionNameSuffix ""
        minSdkVersion 21
        targetSdkVersion 31
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
}