zl程序教程

您现在的位置是:首页 >  APP

当前栏目

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

2023-04-18 14:28:37 时间





一、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 项目根目录gradlewrappergradle-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用户名.gradlewrapperdists " 目录 ;
  • 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:Usersoctop.gradle " 目录 中 ; ( octop 是 Windows 系统用户名 )

在这里插入图片描述
该目录中 , 每个文件都有其职能 , 如 :

  • 解压后的 Gradle 构建工具 存储在了 C:Usersoctop.gradle 目录中 ;
  • Gradle 构建工具压缩包 存储在了 C:Usersoctop.gradlewrapperdists 目录中 ;
  • Gradle 构建过程中下载的依赖库 存储在了 C:Usersoctop.gradlecachesmodules-2files-2.1 目录中 ;

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


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