1. Gradle 使用¶

GRADLE_USER_HOME 是一个非常重要的 Gradle 环境变量，它指定了 Gradle 用户主目录（Gradle User Home Directory）的位置。这个目录是 Gradle 用来存储所有用户特定和全局配置、缓存、日志等文件的地方。

1. GRADLE_USER_HOME 的默认位置¶

如果没有设置 GRADLE_USER_HOME 环境变量，Gradle 会使用操作系统的默认位置：

• Linux/macOS: ~/.gradle
• Windows: C:\Users\<your-username>\.gradle

2. GRADLE_USER_HOME 的主要作用¶

这个目录包含了 Gradle 运行所需和生成的所有关键文件：

• 全局 Gradle 配置文件 (gradle.properties): 可以在这里设置全局的 Gradle 属性，例如 JVM 参数、代理设置、并行构建数量等，这些属性会影响所有 Gradle 项目。
  • 例如，您在前面的问题中提到的 SOCKS5 代理配置 (systemProp.socks.proxyHost=...) 就可以放在这个目录下的 gradle.properties 文件中。
• Gradle Wrappers 缓存: 存储不同版本的 Gradle Wrapper 脚本和下载的 Gradle 分发包。当一个项目指定了一个特定的 Gradle 版本时，如果本地缓存中没有，Gradle 就会下载它并存储在这里。
• 依赖库缓存 (caches 目录): 这是最重要的一部分。Gradle 会缓存从 Maven Central、JCenter、Google Maven 等远程仓库下载的所有第三方依赖库（JARs, AARs 等）。这可以避免每次构建都重复下载，显著提高构建速度。
• 编译缓存 (build-cache 目录): Gradle 的构建缓存功能会将任务的输出缓存起来，如果输入没有变化，下次可以直接复用缓存的输出，进一步加速构建。
• 守护进程日志 (daemon 目录): 存储 Gradle Daemon (守护进程) 的日志文件。Gradle Daemon 是一个后台进程，它保持运行状态以加速后续的构建。
• 初始化脚本 (init.gradle 或 .gradle/init.d/ 目录): 可以在这里放置自定义的初始化脚本，这些脚本会在每个 Gradle 构建开始时执行，用于配置全局行为或注入自定义任务。

3. GRADLE_USER_HOME 的影响¶

a. 构建性能¶

• 优点： 缓存机制使得 Gradle 可以快速复用已下载的依赖和已完成的编译结果，大大缩短构建时间。
• 影响： 如果这个目录被清空，所有依赖都需要重新下载，构建时间会显著增加。

b. 磁盘空间占用¶

• 优点： 无。
• 影响： 随着项目数量和依赖库的增加，GRADLE_USER_HOME 目录可能会变得非常大，占用大量的磁盘空间（GB 甚至几十GB）。尤其是在长时间的开发过程中，缓存文件会不断累积。

c. 环境隔离与多用户¶

• 优点： 不同的用户可以在同一台机器上拥有独立的 Gradle 环境，互不影响。通过设置 GRADLE_USER_HOME 变量，可以在不同场景下（例如 CI/CD 环境，或者为了测试目的）使用不同的 Gradle 缓存和配置。
• 影响： 如果不小心删除了默认目录，可能会导致所有项目的构建都受到影响。

d. 配置管理¶

• 优点： 提供了全局配置点，可以方便地为所有 Gradle 项目设置通用属性（例如代理），而无需修改每个项目的 build.gradle 文件。
• 影响： 全局配置可能会与项目特定配置冲突，需要理解 Gradle 配置的优先级规则。

e. 故障排除¶

• 优点： 当构建出现问题时，检查 GRADLE_USER_HOME 目录下的日志和缓存状态有时能帮助诊断问题（例如，下载的依赖损坏）。
• 影响： 损坏的缓存可能导致构建失败，此时可能需要清除 GRADLE_USER_HOME 中的 caches 目录来解决。

4. 何时以及如何修改 GRADLE_USER_HOME？¶

通常情况下，你不需要修改 GRADLE_USER_HOME 的默认位置。但以下情况可能需要：

• 磁盘空间不足： 如果你的系统盘空间紧张，而你有一个更大的数据盘，可以考虑将 GRADLE_USER_HOME 移动到数据盘，以释放系统盘空间。
• 特定的 CI/CD 环境： 在持续集成/持续部署 (CI/CD) 环境中，你可能需要为每个构建作业设置一个临时的或特定的 Gradle 用户主目录，以确保构建的隔离性和可重复性。
• 多个项目需要不同配置： 虽然不常见，但如果某些项目需要完全独立的 Gradle 环境，可以通过设置 GRADLE_USER_HOME 来实现。

如何修改：

1. 设置环境变量：

   • Linux/macOS:

     export GRADLE_USER_HOME="/path/to/your/new/gradle/home"
     

     可以将其添加到 ~/.bashrc, ~/.zshrc 或 ~/.profile 中使其永久生效。
   • Windows: 在系统环境变量中添加 GRADLE_USER_HOME 变量，并设置其值为新的路径。

2. 启动 Gradle/Android Studio： 确保在启动 Gradle 命令或 Android Studio 之前，该环境变量已经设置并生效。

注意： 修改位置后，原先缓存的文件不会自动迁移过去。你需要重新构建项目，让 Gradle 在新的位置下载或生成文件。如果需要保留旧缓存，需要手动将其复制到新位置。

总结¶

GRADLE_USER_HOME 是 Gradle 的“大本营”，存储着所有全局配置和缓存。了解它的作用能帮助你更好地管理 Gradle 项目、优化构建性能、解决一些网络或依赖相关的问题，并在必要时对其进行调整。