Gradle Wrapper
我们推荐使用 Gradle Wrapper 执行gradle 构建,(后面简称Wrapper).Wrapper 实质上是一个脚本,这个脚本使用申明版本的gradle 执行构建任务。如果本地没有Wrapper 中申明的gradle 版本,Wrapper会先下载它。这样开发者不必必须下载和项目指定版本相同的gradle,就可以完成构建。从而为公司节约时间、节约成本。
-
Wrapper仅仅是一个执行gradle的脚本 。 -
Wrapper只是为了让我们更方便快捷的使用gradle。
AndroidStudio 中的 Gradle Wrapper
我们在 AndroidStudio 打包的时候会使用到这样的命令./gradlew assmeble。为什么可以使用这个命令?其实gradlew就是一个脚本,可以打开它看一看( 部分)。
#!/usr/bin/env sh
##############################################################################
##
## Gradle start up script for UN*X
##
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
PRG="$0"
# Need this for relative symlinks.
while [ -h "$PRG" ] ; do
ls=`ls -ld "$PRG"`
link=`expr "$ls" : '.*-> \(.*\)$'`
if expr "$link" : '/.*' > /dev/null; then
PRG="$link"
else
PRG=`dirname "$PRG"`"/$link"
fi
done
这就是Wrapper中的执行的脚本,那么它在哪里确定gradle 的版本的呢,它还有个配置文件gradle-wrapper.properties
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.4-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
-
distributionBase的值为GRADLE_USER_HOME,那GRADLE_USER_HOME代表的路径是什么呢?就是~/.gradle/这个文件夹,也就是当前用户下的.gradle文件夹 。如Use/xxxxx/.gradle -
distributionUrl指定Wrapper中使用的gradle版本。Wrapper如果本地没有这个gradle版本它就会去下载。然后放在distributionBase+distributionPath路径下。也就是~/.gradle/wrapper/dists路径下。 - 我本地就有这些下好的
gradle版本。
gradle_1
Wrapper到底为我们提供了什么便利?
我们本地开发的时候gradle 肯定需要下载。但比如给同事的电脑上打个包什么的,我们希望只把代码 clone 下来就行了。如果还要下载配置gradle 环境也太麻烦了。或 Jenkins 上,没有我们需要 gradle版本。实质上我们现在从git仓库clone 代码后并不需要配置gradle 环境,使用 gradlew相关命令就可以进行打包了。而这一切当然都是Wrapper的功劳。
我们会把哪些对于打包比较重要的文件上传到git仓库(这里主要说和Wrapper相关的)
-
gradlew这个文件的重要性自然不必说了,这是个脚本文件。 -
gradle-wrapper.properties这是Wrapper配置文件,肯定要 上传 。 - 跟
gradle-wrapper.properties同在gradle/wrapper下的gradle-wrapper.jar,这个jar包可以勉强认为就是gradle - 比如
build.gradle、settings.gradle、gradle.properties等等我就不一一列举了。
在这些文件的通力合作下,我们可以在没有gradle的情况下使用Wrapper完成打包等任务。
Wrapper如此强大,为什么我们还会出现 gradle 版本的问题呢?
既然Wrapper如此强大,这个报错又是怎么回事呢?
Error : minimum supported gradle version is 4.6 in android studio 3.0.1
这是因为 Android Gradle插件。Android Studio 编译系统以 Gradle 为基础,并且 Android Gradle插件添加了几项专用于编译 Android 应用的功能。虽然 Android插件通常会与Android Studio的更新步调保持一致,但插件(以及 Gradle 系统的其余部分)可独立于 Android Studio 运行并单独更新。另外由于gradle各个版本之间支持的功能存在差异。所以会存在不同Android Gradle插件,对支持的gradle最低版本有要求 。在project的 build.gradle 文件中指定Android Gradle插件版本。如下
dependencies {
classpath 'com.android.tools.build:gradle:3.1.0'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
Gradle 环境配置
如果你没有配置gradle 环境,执行gradle相关命令是无法找到命令的。如果需要深入研究gradle 这也是无法逃避的一个环节。那么我们现在就来配置下Mac 平台的gradle环境。(其他环境类似,请自行配置,就是不配置也不影响本文的阅读)
-
Terminal中执行如下命令
vim ~/.bash_profile
- 在配置文件
.bash_profile中增加如下
#gradle
export GRADLE_HOME=/Users/zhang/.gradle/wrapper/dists/gradle-5.1.1-all/97z1ksx6lirer3kbvdnh7jtjg/gradle-5.1.1/bin
export PATH=$GRADLE_HOME:$PATH
- 注意这是我的
Gradle路径,我们刚刚已经找到Wrapper帮我们下载好的各个版本Grale。我这里选了gradle-5.1.1版本的进行配置。指定路径的时候需要一直指定到bin路径下。 - 执行
source ~/.bash_profile使刚刚配置的gradle路径生效即可。 - 执行
gradle -v,如果显示gradle的 版本信息,则说明配置成功。
总结
Android Gradle插件、Gradle、Gradle Wrapper 共同组成了android的构建体系。本文并没有就三者的关系进行死磕,仅仅点到即止。我们需要形成的是大局观。好吧,就这么多了。
