Android Gradle 入门指南（一）
下载与安装
下载地址
笔者下载的是当前的最新版本 Gradle:7.4.2。
环境配置
解压下载之后的.zip文件，配置环境变量。
open ~/.bash_profile 打开配置文件
export PATH=$PATH:/Users/xxx/Documents/gradle/gradle-7.4.2/bin
xxx:为电脑用户名。
配置好之后新起一个终端输入一下指令:
gradle -v
Hello World
进入gradle安装目录并创建build.gradle文件。
cd Documents/gradle
mkdir android-gradle-guide-code
cd android-gradle-guide-code
touch build.gradle
在build.gradle中输入以下代码:
task hello{
doLast{
println "Hello World"
}
}
保存，然后在终端中输入:gradle hello
执行结果如下：
GradleWrapper
原理:通过执行wrapper任务来生成。
生成指令:
gradle wrapper 不指定任何参数则默认使用Gradle版本作为生成的GradleWrapper版本。
gradle wrapper --gradle-version 7.4.2 用于指定gradle版本。
gradle wrapper --gradle-distribution-url 用于指定下载的Gradle地址。
创建一个本地项目:
mkdir gradle-wrapper-demo
cd gradle-wrapper-demo
touch settings.gradle
mdkir app
touch build.gradle
在终端中执行：
gradle wrapper
生成的文件结构如下：
gradlew和gradlew.bat:分别是Linux，Windows下的可执行脚本,用法与原生的gradle一致。
gradle-wrapper.jar:是具体业务逻辑实现的jar包。gradlew最终还是使用java执行这个jar包来执行相关的gradle操作。
gradlew 用法示例:
gradle-wrapper.properties文件
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-7.4.2-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionBase：下载的Gradle压缩包解压之后的主目录。
distributionPath：相对于distributionBase的Gradle压缩包解压后的路径。
zipStoreBase：同distributionBase,只不过存放的是Gradle压缩包。
zipStorePath：同distributionPath,只不过存放的是Gradle压缩包。
distributionUrl：Gradle发行版压缩包的下载地址。
自定义Wrapper任务
type:Wrapper代表继承自原有的Wrapper任务。
task wrapper123(type:Wrapper){
gradleVersion='7.2' //版本
archiveBase='GRADLE_USER_HOME'
archivePath='wrapper/dists'
distributionBase='GRADLE_USER_HOME'
distributionPath='wrapper/dists'
distributionUrl="https\\://services.gradle.org/distributions/gradle-7.2-bin.zip"
}
Gradle日志
日志
日志级别:
| 级别 | 用途 |
|---|---|
| ERROR | 错误消息 |
| QUIET | 重要消息 |
| WARNING | 警告消息 |
| LIFECYCLE | 进度消息 |
| INFO | 信息消息 |
| DEBUG | 调试消息 |
指令说明:
| 指令参数 | 日志输出级别 |
|---|---|
| 无参数 | LIFECYCLE及其更高级别 |
| -q,–quiet | QUIERT及其更高级别 |
| -w.–warn | WARNING及其更高级别 |
| -i,–info | INFO及其更高级别 |
| -d,–debug | DEBUG及其更高阶别 |
输出错误堆栈信息
指令说明:
| 指令参数 | 用途 |
|---|---|
| 无参数 | 没有堆栈信息输出 |
| -s,–stacktrace | 输出关键性的堆栈信息 |
| -S,–full-stacktrace | 输出完整的堆栈信息 |
打印日志
println():实际上是Java的System.out.println()方法。默认对应的日志级别为-q,–quiet重要消息。
logger.debug()
getLogger().debug()
project.getLogger().debug()
最终都是调用的Project.getLogger()方法。支持error,quiet,warn,lifecycle,info,debug级别。
Gradle常用命令
帮助指令
gradle -?.-h,-help 命令帮助，注意？要是中文的。
./gradlew -h,-help
查看项目中可执行的Tasks及其功能:
./gradlew tasks 输出结果会以分组的形式展示。比如Build,Help等。
内置的hekp任务
./gradlew help --task 任务名称 查看指定Task的帮助信息
./gradlew help --task help 查看help任务的帮助信息。
./gradlew hekp --task tasks 查看tasks任务的帮助信息
强制刷新依赖
./gradlew --refresh-dependencies 清除缓存强制刷新。
多任务执行
./gradlew clean assemble 执行多任务按照空格分开即可。
通过任务名字缩写执行
task helloWorld{
println "Hello World"
}
./gradlew hW 驼峰命名首字母即可，注意大小写。