Deprecated Gradle features were used in this build

问题分析

您在使用 Gradle 构建项目时，遇到了以下警告信息：

Deprecated Gradle features were used in this build, making it incompatible with Gradle 8.0.

这表明当前项目的构建脚本中使用了一些已被废弃的 Gradle 功能，这些功能在 Gradle 8.0 及更高版本中不再支持。尽管当前构建成功，但为了确保未来兼容性，建议尽快解决这些问题。

解决方案

1. 检查并更新构建脚本

Gradle 提供了详细的警告信息来帮助开发者定位废弃功能的使用位置。您可以通过以下步骤找到并修复这些问题：

• 启用详细警告模式
  您已经通过 gradle --warning-mode all 启用了详细警告模式，这会显示所有废弃功能的具体位置和原因。请仔细阅读输出日志，找到类似以下格式的警告信息：

  Deprecated Gradle features were used in this build, making it incompatible with Gradle 8.0.
  Use '--warning-mode all' to show individual deprecation warnings.
  See https://docs.gradle.org/8.4/userguide/command_line_interface.html#sec:command_line_warnings
  

  根据日志提示，定位到具体的构建脚本（如 build.gradle 或 settings.gradle）中的问题代码。

• 更新构建脚本
  根据警告信息，逐步替换废弃的功能。例如：

  • 如果使用了废弃的 API，请查阅 Gradle 官方迁移指南 中的相关文档，找到替代方案。
  • 如果是插件导致的问题，请确保使用的插件版本与 Gradle 8.0 兼容，并升级到最新版本。

2. 升级 Gradle Wrapper

确保项目使用的是最新版本的 Gradle Wrapper，以避免因版本过旧导致的兼容性问题。

• 检查当前 Gradle 版本
  在项目根目录下运行以下命令，查看当前 Gradle Wrapper 的版本：

  ./gradlew --version
  

• 升级 Gradle Wrapper
  如果版本较低，可以通过以下命令升级到最新版本（例如 8.4）：

  gradle wrapper --gradle-version 8.4
  

  升级后，重新运行构建命令以验证问题是否解决。

3. 检查依赖项的兼容性

某些第三方依赖项可能使用了废弃的 Gradle 功能，导致构建不兼容。请按照以下步骤排查：

• 更新依赖项版本
  检查 build.gradle 文件中的依赖项，确保所有库和插件都使用最新版本。例如：

  dependencies {
    implementation 'com.example:library:1.0.0' // 确保版本号为最新
  }
  

• 更换国内代理源
  如果依赖下载缓慢或失败，可以将依赖仓库配置为国内代理源，例如阿里云 Maven 仓库：

  repositories {
    maven {
        url 'http://maven.aliyun.com/nexus/content/groups/public/'
    }
  }
  

4. 运行 Gradle 的兼容性检查工具

Gradle 提供了内置工具来帮助开发者识别和修复不兼容问题：

• 运行兼容性检查
  使用以下命令生成兼容性报告：

  ./gradlew help --scan
  

  该命令会生成一个详细的报告，列出所有不兼容的功能及其修复建议。

• 自动修复部分问题
  Gradle 提供了 --refresh-dependencies 参数，可以强制刷新依赖缓存并重新解析依赖关系：

  ./gradlew build --refresh-dependencies
  

5. 测试构建结果

完成上述修改后，重新运行构建命令以验证问题是否解决：

./gradlew build

如果构建成功且无警告信息，则说明问题已解决。

注意事项

• 备份项目
  在进行任何修改之前，请务必备份项目代码，以防修改导致意外问题。

• 逐步升级
  如果项目当前使用的是较旧的 Gradle 版本（例如 6.x 或 7.x），建议逐步升级到中间版本（如 7.6），然后再升级到 8.0，以减少兼容性问题。

• 关注官方文档
  Gradle 官方文档提供了详细的迁移指南和废弃功能列表，请参考 Gradle 官方文档 获取更多信息。

通过以上步骤，您可以有效解决 Gradle 构建中因废弃功能导致的兼容性问题，并确保项目能够顺利迁移到 Gradle 8.0 及更高版本。