You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
178 lines
6.0 KiB
178 lines
6.0 KiB
---
|
|
读书笔记之二
|
|
---
|
|
|
|
#### 目录
|
|
|
|
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 字节码的版本。 |