Gradle 相关命令

//指定相应版本号的gradle

gradle wrapper --gradle-version [version]

编译命令

检查依赖并编译打包

./gradlew build

编译并打出Debug包

./gradlew assembleDebug

编译打出Debug包并安装

./gradlew installDebug

编译并打出Release包

./gradlew assembleRelease

编译打出Release包并安装

./gradlew installRelease

Debug/Release编译并打印日志

./gradlew assembleDebug --info

./gradlew assembleRelease --info

清除构建目录下的产物

./gradlew clean

卸载Debug/Release安装包

./gradlew uninstallDebug

./gradlew uninstallRelease

输出：

Uninstalling com.yechaoa.gradlex (from app:debug) from device 'Pixel_5_API_31(AVD) - 12' (emulator-5554).
Uninstalled com.yechaoa.gradlex from 1 device.

adb卸载
在Android Studio中执行是直接卸载的当前项目安装包，如果是adb执行则需要指定包名。

adb uninstall packagename  

任务相关

查看主要Task

./gradlew tasks

查看所有Task

./gradlew tasks --all

执行Task

./gradlew taskName
// or
./gradlew :moduleName:taskName

查看依赖

查看项目根目录下的依赖

./gradlew dependencies

查看app模块下的依赖

./gradlew :app:dependencies

查看依赖输出到文件

./gradlew app:dependencies > dependencies.txt

性能相关

离线编译

./gradlew assembleDebug --offline

构建缓存

./gradlew assembleDebug --build-cache // 开启

./gradlew assembleDebug --no-build-cache // 不开启

配置缓存

./gradlew assembleDebug --configuration-cache // 开启

./gradlew assembleDebug --no-configuration-cache // 不开启

并行构建

./gradlew assembleDebug --parallel // 开启

./gradlew assembleDebug --no-parallel // 不开启

离线编译、构建缓存、配置缓存、并行构建均需要在gradle.properties中配置

编译并输出性能报告

./gradlew assembleDebug --profile

性能报告位于构建项目的GradleX/build/reports/profile/路径下。

See the profiling report at: file:///Users/yechao/AndroidStudioProjects/GradleX/build/reports/profile/profile-2022-11-29-23-13-29.html

编译并输出更详细性能报告

./gradlew assembleDebug --scan

首次执行需要邮箱验证，授权即可，完事之后即可打开链接，scan报告内容比profile更加详细。

动态传参

比较常用的传参属性，--project-prop，我们一般常用-P表示，用来设置根项目的项目属性

获取参数

 ./gradlew assembleDebug -PisTest=true 

这里我们用-P传了一个isTest字段，并赋值为true。

那在代码里如何获取这个参数呢？然后在build.gradle中编写如下代码：

if (hasProperty("isTest")){
    println("---hasProperty isTest yes")
}else {
    println("---hasProperty isTest no")
}

我们可以用hasProperty来获取命令行(CLI)的参数，module或者插件也可以这么获取：

project.property('isTest')

然后我们用上面的命令编译看下输出：

➜  GradleX git:(master) ✗ ./gradlew assembleDebug -PisTest=true 
---Gradle：开始初始化了
---Gradle：settingsEvaluated Settings对象评估完毕
---Gradle：projectsLoaded 准备加载Project对象了

> Configure project :
---Gradle：Projec beforeEvaluate Project开始评估，对象是 = GradleX
---hasProperty isTest yes //   --- 看这里 ---
---Gradle：Projec afterEvaluate Project评估完毕，对象是 = GradleX

> Configure project :app
---Gradle：buildFinished 构建结束了

获取参数值

我们可以用getProperty()来获取：

if (hasProperty("isTest")) {
    println("---hasProperty isTest yes")
    if (Boolean.valueOf(getProperty('isTest'))) {
        println("---isTest true")
    } else {
        println("---isTest false")
    }
} else {
    println("---hasProperty isTest no")
}

注意，getProperty('isTest')这里要用单引号，另外命令行里面的参数值都是对象，还需要基本数据类型转换一下，即Boolean.valueOf(getProperty('isTest'))。

自定义操作

我们就可以针对获取的参数去做一些自定义的操作了，比如修改我们的依赖。

app>build.gradle：

dependencies {

    implementation 'androidx.core:core-ktx:1.7.0'

    if (project.hasProperty("isTest")) {
        println("---hasProperty isTest yes")
        if (Boolean.valueOf(getProperty('isTest'))) {
            println("---isTest true")

            implementation 'com.yechaoa.gradlex.devtools:devtools:1.1.1'

        } else {
            println("---isTest false")

            implementation 'com.yechaoa.gradlex.devtools:devtools:2.2.2'
        }
    } else {
        println("---hasProperty isTest no")
    }

    testImplementation 'junit:junit:4.13.2'
}