根据Android官方文档的兼容性要求,**Gradle插件版本4.0.0与Gradle 6.1.1并不完全匹配**,以下是详细分析及修正建议:
---
### **一、版本兼容性对照**
| **Android Gradle插件版本 (AGP)** | **官方要求的Gradle版本范围** |
|------------------------------|---------------------------|
| `4.0.0`(2020年发布) | **Gradle 6.1.1 ~ 6.5.1** |
| `4.1.0` | Gradle 6.5 ~ 6.7.1 |
| `4.2.0` | Gradle 6.7.1 ~ 7.0 |
- **关键结论**:
- **AGP 4.0.0 官方支持的最低Gradle版本是6.1.1**,但建议升级到**Gradle 6.5.1**以修复已知问题。
- 若项目使用`Gradle 6.1.1 + AGP 4.0.0`,可能因版本兼容性边界问题导致以下异常:
```bash
# 常见报错示例
Could not initialize class com.android.sdklib.repository.AndroidSdkHandler
Unsupported class file major version 61 # JDK版本冲突
```
---
### **二、解决方案**
#### **方案1:升级Gradle至6.5.1(推荐)**
修改项目根目录的 **`gradle-wrapper.properties`** 文件:
```properties
distributionUrl=https\://services.gradle.org/distributions/gradle-6.5.1-bin.zip
```
此版本是AGP 4.0.0的官方推荐版本,稳定性更高且兼容JDK 8。
#### **方案2:降级AGP版本(谨慎选择)**
若因特殊原因必须使用Gradle 6.1.1,可降级AGP至 **3.6.0**(对应Gradle 5.6.4+):
```groovy
# 项目根目录 build.gradle
classpath "com.android.tools.build:gradle:3.6.0"
```
但此方案可能失去部分新功能(如Android 11兼容性优化)。
---
### **三、验证配置正确性**
1. **检查Gradle与JDK版本**
- AGP 4.0.0 + Gradle 6.1.1需配合 **JDK 8**(不支持JDK 11+)。
- 若使用JDK 11,需升级Gradle至6.5+或更高。
2. **同步项目后观察日志**
执行 **`./gradlew sync --stacktrace`**,若输出以下内容则表明版本已兼容:
```bash
BUILD SUCCESSFUL in 10s
```
---
### **四、加速Gradle下载的技巧**
若需下载Gradle 6.5.1,可通过国内镜像加速:
```properties
# 替换distributionUrl为腾讯镜像地址
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-6.5.1-bin.zip
```
---
通过上述调整,可解决版本兼容性问题并提升构建稳定性。若仍有报错,建议清理缓存:
```bash
rm -rf ~/.gradle/caches/
```