build.gradle
gradle-wrapper.properties
和 build.gradle
是 Gradle 项目中两个关键配置文件,它们分工明确且相互配合。以下是它们的详细关系和配置指南:
1. 文件职责对比
文件 | 作用 | 配置重点 |
---|---|---|
gradle-wrapper.properties |
定义 Gradle 发行版 的版本和下载地址 | 控制构建工具本身的版本 |
build.gradle |
定义项目的 构建逻辑(插件、依赖、任务等) | 控制项目具体的构建行为 |
2. 配置协同关系
gradle-wrapper.properties
(路径:gradle/wrapper/gradle-wrapper.properties
)
properties
复制
# 指定Gradle发行版版本
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
# 其他可选参数
distributionSha256Sum=... # 校验SHA256哈希(可选)
zipStoreBase=GRADLE_USER_HOME # 缓存目录位置
build.gradle
(路径:build.gradle
或 app/build.gradle
)
gradle
复制
// 指定Android Gradle插件版本(与Gradle版本需兼容)
buildscript {
dependencies {
classpath 'com.android.tools.build:gradle:8.0.0' // AGP版本
}
}
3. 版本兼容性配置
必须确保两个文件中定义的版本相互兼容:
Gradle 版本 | 兼容的 Android Gradle Plugin (AGP) 版本 |
---|---|
8.0 | 8.0.0+ |
7.5 | 7.3.0+ |
7.0 | 7.0.0+ |
官方兼容性表:
👉 Android Gradle Plugin 版本说明
4. 完整配置示例
gradle-wrapper.properties
示例
properties
复制
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.0-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
build.gradle
(项目级) 示例
gradle
复制
buildscript {
repositories {
google() // 必须包含Google仓库
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:8.0.0'
}
}
allprojects {
repositories {
google() // 所有子项目共用仓库
mavenCentral()
}
}
日夜颠倒头发少 ,单纯好骗恋爱脑 ,会背九九乘法表 ,下雨只会往家跑 ,搭讪只会说你好 ---- 2050781802@qq.com