一、功能
Gradle 和 Android 插件完成以下方面的构建配置
构建类型
build 类型定义 Gradle 在构建和打包应用时使用的某些属性,通常针对开发生命周期的不同阶段进行配置。例如,调试 build 类型支持调试选项,并会使用调试密钥为应用签名;而发布 build 类型则会缩减应用、对应用进行混淆处理,并使用发布密钥为应用签名以进行分发。如需构建应用,您必须至少定义一个 build 类型。Android Studio 默认会创建调试 build 类型和发布 build 类型。如需开始为应用自定义打包设置,请了解如何配置构建类型。
产品变种
产品变种代表您可以向用户发布的不同应用版本,如免费版应用和付费版应用。您可以自定义产品变种以使用不同的代码和资源,同时共享并重用所有应用版本共用的部分。产品变种是可选的,您必须手动创建。如需开始创建应用的不同版本,请了解如何配置产品变种。
构建变体
构建变体是构建类型与产品变种的交叉产物,也是 Gradle 用来构建应用的配置。利用构建变体,您可以在开发期间构建产品变种的调试版本,或者构建产品变种的已签名发布版本以供分发。虽然您无法直接配置构建变体,但可以配置组成它们的构建类型和产品变种。创建额外的构建类型或产品变种也会创建额外的构建变体。如需了解如何创建和管理构建变体,请参阅配置构建变体概览。
清单条目
您可以在构建变体配置中为清单文件中的某些属性指定值。这些 build 值会替换清单文件中的现有值。如果您要为应用生成多个变体,让每一个变体都具有不同的应用名称、最低 SDK 版本或目标 SDK 版本,便可运用这一技巧。当存在多个清单时,Gradle 会合并清单设置。
依赖项
构建系统会管理来自本地文件系统以及来自远程代码库的项目依赖项。这样一来,您就不必手动搜索、下载依赖项的二进制文件包以及将它们复制到项目目录中。如需了解详情,请参阅添加 build 依赖项。
签名
构建系统既允许您在 build 配置中指定签名设置,也可以在构建流程中自动为应用签名。构建系统通过已知凭据使用默认密钥和证书为调试版本签名,以避免在构建时提示输入密码。除非您为此构建明确定义签名配置,否则,构建系统不会为发布版本签名。如果您没有发布密钥,可以按为应用签名中所述生成一个。
代码和资源缩减
构建系统允许您为每个构建变体指定不同的 ProGuard 规则文件。在构建应用时,构建系统会应用一组适当的规则以使用其内置的缩减工具(如 R8)缩减您的代码和资源。
多 APK 支持
通过构建系统可以自动构建不同的 APK,并让每个 APK 只包含特定屏幕密度或应用二进制接口 (ABI) 所需的代码和资源。如需了解详情,请参阅构建多个 APK。请注意,我们建议的方法是发布单个 AAB,因为它除了让您可以按屏幕密度和 ABI 进行拆分以外,还可以让您按语言进行拆分,同时还可以降低因必须上传多个工件到 Google Play 所造成的复杂性
Android Gradle 插件版本说明
https://developer.android.com/studio/releases/gradle-plugin?buildsystem=ndk-build#updating-gradle
二、成员
开始新项目时,Android Studio 会自动为您创建其中的部分文件(如图 2 所示),并为其填充合理的默认值
有一些 Gradle 构建配置文件是 Android 应用的标准项目结构的组成部分。您必须了解其中每个文件的范围和用途及其应定义的基础 DSL 元素,才能着手配置构建。
1、settings.gradle
2、local.properties
配置本地环境属性,其中包括:
ndk.dir
- NDK 的路径。此属性已被弃用。NDK 的所有下载版本都将安装在 Android SDK 目录下的ndk
目录中。sdk.dir
- SDK 的路径。cmake.dir
- CMake 的路径。ndk.symlinkdir
- 在 Android Studio 3.5 及更高版本中,创建指向 NDK 的符号链接,该符号链接的路径可比 NDK 安装路径短。
sdk.dir=/home/duchao/Android/Sdk
sdk.dir=/home/duchao/Android/ndk
也可以定义一些参数,可以通过getProperty获取
// local.properties
name=nameWord
pwd=pwdWord
// build.gradle
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
def name = properties.getProperty('name')
def pwd = properties.getProperty('pwd')
3、gradle.properties
配置项目全局 Gradle 设置
// 编译内存
org.gradle.jvmargs=-Xmx1600M
// aapt2
android.enableAapt2=false
4、根目录build.gradle
文件位于项目的根目录下,用于定义适用于项目中所有模块的依赖项
plugins {
id 'com.android.application' version '7.0.0' apply false
id 'com.android.library' version '7.0.0' apply false
id 'org.jetbrains.kotlin.android' version '1.6.10' apply false
}
task clean(type: Delete) {
delete rootProject.buildDir
}
配置项目全局属性
对于包含多个模块的 Android 项目,可能有必要在项目级别定义某些属性并在所有模块之间共享这些属性
ext {
sdkVersion = 28
supportLibVersion = "28.0.0"
...
}
android {
compileSdkVersion rootProject.ext.compileSdkVersion
}
dependencies {
implementation "com.android.support:appcompat-v7:${rootProject.ext.supportLibVersion}"
}
5、module下build.gradle
配置构建设置提供自定义打包选项
- defaultConfig{} 默认配置,是ProductFlavor类型。它共享给其他ProductFlavor使用
- sourceSets{ } 源文件目录设置,是AndroidSourceSet类型。
- buildTypes{ } BuildType类型
- signingConfigs{ } 签名配置,SigningConfig类型
- productFlavors{ } 产品风格配置,ProductFlavor类型
- testOptions{ } 测试配置,TestOptions类型
- aaptOptions{ } aapt配置,AaptOptions类型
- lintOptions{ } lint配置,LintOptions类型
- dexOptions{ } dex配置,DexOptions类型
- compileOptions{ } 编译配置,CompileOptions类型
- packagingOptions{ } PackagingOptions类型
- jacoco{ } JacocoExtension类型。 用于设定 jacoco版本
- splits{ } Splits类型
build.gradle内成员
compileSdkVersion
指定Gradle编译使用的Android API级别, 项目可以使用此级别及其更低版本API功能
buildToolsVersion
指定SDK构建工具的命令行版本 (Gradle应该用来构建应用程序的实用程序和编译器)
此属性是可选的,默认使用推荐版本的构建工具
compileOptions
编译使用的jdk版本
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
sourceSets
sourceSets {
main {
manifest.srcFile "AndroidManifest.xml"
java.srcDirs = ["src"]
res.srcDirs = ["res"]
assets.srcDirs = ["assets"]
jniLibs.srcDirs = ["jni"]
aidl.srcDirs = ["aidl"]
}
debug.setRoot('')
}
debug.setRoot('')作用:当资源位于同一个根目录下时,可以使用setRoot区分指定
如下例子:res区分为免费和付费,debug环境使用免费,release使用付费,可以使用setRoot
多变种
splits 针对多个 APK 配置 build (分辨率分apk , ABI分apk)
https://developer.android.com/studio/build/configure-apk-splits
dependencies
multiDexEnabled方法数超过 64K
https://developer.android.com/studio/build/multidex
proguardFiles、minifyEnabled、shrinkResources (混淆代码优化缩减R8)
https://developer.android.com/studio/build/shrink-code
signingConfigs 签名与秘钥
https://developer.android.com/studio/publish/app-signing
cpp/c编译
externalNativeBuild {
cmake {
path file('src/main/cpp/CMakeLists.txt')
version '3.18.1'
cppFlags ''
abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
}
}
使用 Maven Publish 插件 (如上传sdk)
https://developer.android.com/studio/build/maven-publish-plugin