Android buildTypes 和 productFlav

一、buildTypes

1. 简介
   buildTypes 用于表示编译的类型，默认包含 debug 和 release 两种类型，一般情况下不会添加多的类型。

2. 使用

• 通常会在 debug 和 release 类型中区分混淆、压缩和签名等相关设置。另外，还可以区分 applicationId 等信息。

# 区分 applicationId
buildTypes {
    xiaobo {
        applicationIdSuffix ".xiaobo"
    }
}

• 再者，考虑如下场景，debug 版本需要使用 sd 卡上的 json 文本来初始化数据用于方便测试。因此在 debug 版本时就需要使用到 android.permission.READ_EXTERNAL_STORAGE 权限，因此可以在 src/debug/AndroidManifest.xml 中要求权限 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />，这样只有 debug 版本的权限清单里才会出现该权限。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="xxx">

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
</manifest>

二、productFlavors

1. 简介
   productFlavors 用于添加不同风味类型，主要方便多渠道打包，尤其在不同风味上有定制代码的开发时比较适合。

2. 使用

• 需要先添加风味维度，各维度下各提供一个风味参与编译
• 然后添加风味类型即可，同时需要制定该风味隶属于哪个维度

flavorDimensions "platform"

productFlavors {
    mobile {
        dimension "platform"
    }

    pc {
        dimension "platform"
    }
}

• 默认情况下，在 src 目录下添加以风味名称命名的文件夹，下面即可添加代码和资源文件，参考 main 目录下的格式

mobile 目录下的 Platform.kt

object Platform {

    const val PLATFORM_TEXT = "mobile"

}

pc 目录下的 Platform.kt

object Platform {

    const val PLATFORM_TEXT = "pc"

}

在 MainActivity.kt 中即可使用 Platform 类，会根据 AS 中左下角所指定的 Build Variants 来决定所使用的是哪一个 Platform 类

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        LogUtils.d("onCreate(), platform: ${Platform.PLATFORM_TEXT}")
    }
}

三、其它

• buildTypes 和 productFlavors 下的类型名不允许一致
• buildTypes 和 productFlavors 下的类型名均不允许以 test 或者 androidTest 开头（包括二者）
• buildTypes 和 productFlavors 中定义了同名资源，以 buildTypes 下的为准（定义同名类会报错类重复，前提是包名也一样）

• 工程目录

  
  工程目录.png
• build.gradle

plugins {
    id 'com.android.application'
    id 'kotlin-android'
}

android {
    compileSdk 30

    defaultConfig {
        applicationId "xxx"
        minSdk 21
        targetSdk 28
        versionCode 3
        versionName "1.1.1"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    viewBinding {
        enabled = true
    }

    signingConfigs {
        release {
        }
    }

    flavorDimensions "platform"

    productFlavors {
        mobile {
            dimension "platform"
        }

        pc {
            dimension "platform"
        }
    }

    buildTypes {
        xiaobo {
            signingConfig signingConfigs.release
        }

        debug {
            signingConfig signingConfigs.release
        }

        release {
            signingConfig signingConfigs.release
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

dependencies {
    // 根据 buildType 和 productFlavors 来添加依赖
    xiaoboImplementation 'androidx.core:core-ktx:1.3.2'
    mobileImplementation 'androidx.core:core-ktx:1.3.2'
}