文章目录
Gradle 是一种先进的构建工具,它被广泛应用于 Android 开发。Gradle 提供了强大的构建功能、灵活的配置和丰富的插件生态。以下是关于 Android 中 Gradle 的详细用法:
1. 基本概念
在了解 Gradle 的用法之前,首先需要了解以下基本概念:
- Project:Gradle 构建的基本单位,通常对应一个工程。
- Task:Gradle 构建的操作单位,用于执行具体的构建任务,如编译、打包等。
- Build Script:Gradle 构建脚本,使用 Groovy 或 Kotlin DSL 编写,用于配置构建过程。
- Plugin:Gradle 插件,用于扩展构建功能和简化构建配置。
2. 配置构建脚本
在 Android 项目中,通常有两个 Gradle 构建脚本:build.gradle
(项目级)和 build.gradle
(模块级)。
2.1 项目级构建脚本
项目级 build.gradle
文件主要用于配置整个项目的构建设置。以下是一个典型的项目级构建脚本:
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
repositories {
google()
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:4.1.0'
}
}
allprojects {
repositories {
google()
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
buildscript
:配置构建脚本的依赖,如 Android Gradle 插件。repositories
:配置依赖库的仓库,如 Google Maven 仓库和 JCenter 仓库。allprojects
:配置所有子项目(模块)的设置,这些设置将应用于所有子项目。task
:定义自定义任务,如clean
任务用于删除项目的构建输出。
2.2 模块级构建脚本
模块级 build.gradle
文件主要用于配置模块的构建设置。以下是一个典型的模块级构建脚本:
apply plugin: 'com.android.application'
android {
compileSdkVersion 30
buildToolsVersion "30.0.2"
defaultConfig {
applicationId "com.example.myapp"
minSdkVersion 21
targetSdkVersion 30
versionCode 1
versionName "1.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'androidx.appcompat:appcompat:1.2.0'
implementation 'com.google.android.material:material:1.2.1'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'androidx.test.ext:junit:1.1.2'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
}
apply plugin
:应用 Android Gradle 插件。android
:配置 Android 构建设置,如 SDK 版本、应用 ID、版本号等。defaultConfig
:配置默认的构建变体设置。buildTypes
:配置不同的构建类型,如 debug 和 release。dependencies
:配置模块的依赖库。
3. 自定义构建变体和应用 flavorDimensions
在 Android 项目中,你可以使用 Gradle 自定义构建变体(如 debug、release 等)。flavorDimensions
的作用是为构建变体提供分组维度,使得你可以更灵活地管理和生成不同版本的应用。以下是如何自定义构建变体并应用 flavorDimensions
:
android {
// ...
// 定义构建变体的维度,例如这里定义了一个 "tier" 维度
flavorDimensions "tier"
// 根据 flavorDimensions 定义不同的产品风味,如 free 和 pro
productFlavors {
free {
dimension