Android Gradle 插件Gradle 基础配置 ⑤ ( gradle-wrapper.properties 配置分析 | GRADLE_USER_HOME 目录 )

Posted 2022-11-26 韩曙亮

文章目录

• 一、gradle-wrapper.properties 配置分析
• 二、GRADLE_USER_HOME 目录

一、gradle-wrapper.properties 配置分析

---

Gradle Wrapper 配置 主要的 gradle-wrapper.properties 配置文件 内容如下 :

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\\://services.gradle.org/distributions/gradle-6.7.1-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

该配置文件路径为 " Gradle 项目根目录\\gradle\\wrapper\\gradle-wrapper.properties " ;

初次打开 android Studio 项目时 , 会经过 很长时间的 Gradle 构建过程 , 这个过程中会 下载 gradle-wrapper.properties 中的 distributionUrl 配置的 Gradle 构建工具 , 以及 在 build.gradle 构建脚本中配置的 依赖库 ;

gradle-wrapper.properties 配置文件解析 :

• distributionBase 配置 : 存放 解压后的 Gradle 构建工具的路径 , 一般配置 " GRADLE_USER_HOME “ , 对应 ” C:\\Users\\用户名.gradle " 目录 ;
• distributionPath 配置 : 存放 Gradle 构建工具压缩包的路径 , 一般配置 " wrapper/dists “ , 对应 ” C:\\Users\\用户名.gradle\\wrapper\\dists " 目录 ;
• distributionUrl 配置 : Gradle 构建工具 下载地址 , gradle-6.7.1-bin.zip 指的是 二进制版本 , gradle-6.7.1-all.zip 指的是 包含源码和文档的 完整版本 ;
• zipStoreBase 配置 : 与 distributionBase 配置类似 , 存放的是 zip 格式的压缩包 ;
• zipStorePath 配置 : 与 distributionPath 配置类似 , 存放的是 zip 格式的压缩包 ;

二、GRADLE_USER_HOME 目录

---

GRADLE_USER_HOME 目录默认为 " C:\\Users\\用户名.gradle " 目录 ;

Android Studio 工程中 , 初次打开项目时 , 会经过 很长时间的 Gradle 构建过程 , 这个过程中会 下载 gradle-wrapper.properties 中的 distributionUrl 配置的 Gradle 构建工具 , 以及 在 build.gradle 构建脚本中配置的 依赖库 ;

下载的 Gradle 构建工具 , 依赖库 , 都保存在了 " C:\\Users\\octop.gradle " 目录 中 ; ( octop 是 Windows 系统用户名 )

该目录中 , 每个文件都有其职能 , 如 :

• 解压后的 Gradle 构建工具 存储在了 C:\\Users\\octop.gradle 目录中 ;
• Gradle 构建工具压缩包 存储在了 C:\\Users\\octop.gradle\\wrapper\\dists 目录中 ;
• Gradle 构建过程中下载的依赖库 存储在了 C:\\Users\\octop.gradle\\caches\\modules-2\\files-2.1 目录中 ;

其它目录文件都有其在 Gradle 构建过程中的作用 ;

如果修改了 gradle-wrapper.properties 配置文件 中的 distributionBase 配置 , 那么在打开时 , 需要 重新进行 Gradle 构建 , 上面的一系列目录都要重新下载配置一遍 , 耗时等同于初次启动 Android Studio 开发环境 , 可能需要十几分钟甚至半小时的时间 ;