android-notes/blogs/Android/Gradle/Android Gradle 权威指南/读书笔记之二.md

---
读书笔记之二
---

#### 目录

1. 修改生成的 apk 文件名
2. 动态配置 AndroidManifest 文件
3. 自定义 BuildConfig
4. 动态添加自定义的资源
5. Java 编译选项

#### 修改生成的 apk 文件名

既然要修改生成的 apk 文件名，那么就要修改 Android Gradle 打包的输出。为了解决这个问题，Android 对象为我们提供了三个熟悉：applicationVariants（仅仅适用于 Android 应用 Gradle 插件）、libraryVariants（仅仅适用于 Android 库 Gradle 插件）、testVariants（以上两种 Gradle 插件都适用）。

以上三个属性返回的都是 DomainObjectSet 对象集合，里面的元素分别是 ApplicationVariant、LibraryVariant 和 TestVariant。这三个元素的名字直译来意思是变体，通俗的讲它们就是 Android 构建的产物。它们基于 BuildType 和 ProductFlavor 生成的产物。BuildType 即构建类型，Android 已经内置了 debug 和 release 两种构建类型。ProductFlavor 允许我们根据不同的情况生成多个不同的 APK 包，如果不针对我们自定义的 ProductFlavor 单独配置的话，会为这个 ProductFlavor 使用默认的 defaultConfig 的配置。defaultConfig 里面有我们熟悉的 verisonCode、versionName 等等。

```groovy
android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.example.demoproject"
        minSdkVersion 26
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        flavorDimensions "versionCode"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            zipAlignEnabled true
        }
        debug {
            
        }
    }

    productFlavors {
        google {

        }
    }

    applicationVariants.all { variant ->
        variant.outputs.each { output ->
            def timeNow = new Date().format("yyyyMMdd")
            def newName = 'app' + '_' + variant.buildType.name + '_' + variant.versionCode + "_" + timeNow + '.apk'
            output.outputFileName = newName
        }
    }
}
```

 build debug 包生成的 apk 文件名为 app_debug_1_20190521.apk。

#### 动态配置 AndroidManifest 文件

动态配置 AndroidManifest 文件，顾名思义就是可以在构建的过程中，动态修改 AndroidManifest 文件中的一些内容。Android Gradle 提供了非常便捷的办法，那就是使用 manifestPlaceholder，即 Manifest 占位符。

ManifestPlaceholders 是 ProductFlavor 的一个属性，是一个 Map 类型，所以我们可以同时配置很多个占位符。

比如想把 application 下的 meta-data 的 name 替换掉：

```
<meta-data android:name="CHANNEL_ID" android:value="${CHANNEL}"/>
```

```groovy
    productFlavors {
        google {
            manifestPlaceholders.put("CHANNEL", "google")
        }
        baidu {
            manifestPlaceholders.put("CHANNEL","baidu")
        }
    }
```

但是如果，渠道很多的情况下，一个一个添加还是很繁琐的，那就需要遍历添加了：

```groovy
    productFlavors {
        google {
        }
        baidu {
        }
    }

    productFlavors.all { flavor ->
        manifestPlaceholders.put("CHANNEL", name)
    }
```

#### 自定义 BuildConfig

```java
/**
 * Automatically generated file. DO NOT MODIFY
 */
package com.example.demoproject;

public final class BuildConfig {
  public static final boolean DEBUG = Boolean.parseBoolean("true");
  public static final String APPLICATION_ID = "com.example.demoproject";
  public static final String BUILD_TYPE = "debug";
  public static final String FLAVOR = "google";
  public static final int VERSION_CODE = 1;
  public static final String VERSION_NAME = "1.0";
}
```

BuildConfig 这个类是自动生成的，不可以修改，但是我们可以往里面添加我们自定义的常量，Android Gradle 提供了 buildConfigField。

```groovy
    productFlavors {
        google {
            buildConfigField('String', 'name', '"Omooo"')
        }
        baidu {
            buildConfigField('String', 'name', '"Omooo"')
        }
    }
```

**注意：**值是放在单引号里面的，所以是 '"Omooo"'！

上面都是在渠道（ProductFlavor）中配置的，其实在构建类型（BuildType）里面也是可以配置的：

```groovy
    buildTypes {
        debug {
            buildConfigField('String', 'name', '"Omooo"')
        }
    }
```

#### 动态添加自定义的资源

这里讲的自定义资源，是专门针对 res/values 类型资源的，它们不光可以在 res/values 文件夹里使用 xml 的方式定义，还可以在我们的 Android Gradle 中定义，大大增加了构建的灵活性。

实现这一功能的正是 resValue 方法，它在 BuildType 和 ProductFlavor 这两个对象中都存在。

```groovy
    productFlavors {
        google {
            resValue('string','name','Omooo_Google')
        }
        baidu {
            resValue('string','name','Omooo_Baidu')
        }
    }
```

然后我们在 app/build/generated/res/resValues/google/debug/values 下查看自动生成的资源文件。

上面演示的是 string 类型，当然也可以使用 id、bool、demin、color 等类型，和 buildConfigField 一样，它也是可以在 BuildType 中使用的。

#### Java 编译选项

```groovy
    compileOptions {
      	encoding = 'utf-8'
        targetCompatibility = JavaVersion.VERSION_1_8
        sourceCompatibility = JavaVersion.VERSION_1_8
    }
```

Android 对象提供了一个 compileOptions 方法，它接受一个闭包作为参数，来对 Java 编译选项进行配置。

compileOptions 是编译配置，它提供了三个属性，分别是 encoding、sourceCompatibility、targetCompatibility。sourceCompatibility 是配置 Java 源代码的编译级别，targetCompatibility 是配置生成的 Java 字节码的版本。