gradle的镜像源配置

Question

为什么配置了gradle的腾讯镜像源和阿里云的依赖镜像源后，其他的依赖都是从镜像源下载，但是唯独gradle src还是从官网下载？

Answer 1

上午好☀️☀️☀️️
本答案参考通义千问

在配置 Gradle 的镜像源时，可能会遇到某些依赖能够正确从镜像源下载，而 gradle-src.jar 仍然从官方源下载的问题。这通常是由于 Gradle 的默认行为或缓存机制导致的。以下是可能的原因及解决方案：

---

原因分析

1. Gradle 的源码依赖处理方式

   • Gradle 在构建过程中会尝试下载 gradle-src.jar 文件，这是为了支持源码调试。
   • 默认情况下，Gradle 会优先从官方源（如 https://services.gradle.org/distributions/）下载该文件。

2. 镜像源配置未覆盖所有依赖

   • 虽然你已经配置了腾讯或阿里云的镜像源，但这些镜像源可能并未完全覆盖 gradle-src.jar 的下载路径。

3. Gradle 缓存机制

   • 如果之前已经从官方源下载过 gradle-src.jar，Gradle 会将其缓存在本地目录中，后续构建时可能会直接使用缓存，而不重新从镜像源下载。

4. 镜像源的兼容性问题

   • 某些镜像源可能没有提供完整的 Gradle 相关资源，尤其是与源码相关的文件。

---

解决方案

1. 配置全局的 Gradle 镜像源

确保你的 init.gradle 文件中正确配置了镜像源，并且优先级高于默认的官方源。例如：

allprojects {
    repositories {
        maven {
            url "https://mirrors.tencent.com/gradle/"
        }
        maven {
            url "https://maven.aliyun.com/repository/gradle"
        }
        mavenCentral()
        google()
    }
}

注意：将腾讯或阿里云的镜像源放在最前面，以确保优先从镜像源下载。

---

2. 手动指定 gradle-src.jar 的下载路径

如果镜像源无法提供 gradle-src.jar，可以手动指定其下载路径。例如，在 gradle.properties 中添加以下内容：

org.gradle.download.onlyUseMirror=true

这会强制 Gradle 使用镜像源下载所有依赖，包括 gradle-src.jar。

---

3. 清除本地缓存并重新构建

如果本地缓存中存在从官方源下载的 gradle-src.jar，可以清除缓存并重新构建项目：

# 删除 Gradle 缓存
rm -rf ~/.gradle/caches/modules-2/files-2.1/org.gradle/gradle-core/

# 重新构建项目
./gradlew clean build

---

4. 替换 gradle-src.jar 文件

如果镜像源确实无法提供 gradle-src.jar，可以手动下载该文件并替换到本地缓存目录中。例如：

1. 从腾讯或阿里云的镜像源手动下载 gradle-src.jar。
2. 将下载的文件放入以下路径：

   ~/.gradle/caches/modules-2/files-2.1/org.gradle/gradle-core/
   

---

5. 使用自定义镜像源

如果现有的镜像源不完整，可以尝试使用其他更全面的镜像源。例如：

• 华为开源镜像站：https://repo.huaweicloud.com/
• 网易开源镜像站：http://mirrors.163.com/

在 init.gradle 或 build.gradle 中配置：

repositories {
    maven {
        url "https://repo.huaweicloud.com/repository/gradle/"
    }
}

---

6. 检查 Gradle 版本

有时，某些版本的 Gradle 可能对镜像源的支持不够完善。建议升级到最新版本的 Gradle，以获得更好的兼容性和性能。

---

总结

通过上述方法，你应该能够解决 gradle-src.jar 始终从官方源下载的问题。以下是关键步骤的有序列表：

1. 确保镜像源配置正确，并优先级高于默认源。
2. 在 gradle.properties 中启用强制镜像下载。
3. 清除本地缓存并重新构建项目。
4. 手动下载并替换 gradle-src.jar 文件。
5. 使用更全面的镜像源（如华为或网易）。
6. 升级 Gradle 到最新版本。

希望这些解决方案能帮助你解决问题！