命令行接口

这部分官方文档来自Command-Line Interface, 总结平时会通过终端来执行的常用的一些命令。

概述

很多标记选项可以在gradle.properties中配置而不用每次执行的时候键盘敲入, 详情查看 configuring build environment guide

贴出目录链接方便查阅

Executing tasks
使用最多, gradle task_name即可, 支持模糊的任务名
:assemble 编译代码
:lib_xxx:assemble执行工程lib_xxx下的:assemble任务
Common tasks
build Computing all outputs
clean Cleaning outputs
Project reporting
projects 列出所有的工程
tasks 列出所选工程的所有任务, 所在目录是主工程就是root project, 其他工程可以进入目录或者加前缀
dependencies 列出所有依赖,查看依赖冲突时常用
Command-line completion
Debugging options
-S, --full-stacktrace, -s, --stacktrace gradle命令执行异常分析
-Dorg.gradle.debug=true 开启调试, 自定义Gradle plugin需要使用, 带上--no-daemon避免守护进程占用端口
--stop停止所有指定版本(指./gradlew的方式)守护进程的gradle, 端口占用执行来杀死所有进程
Performance options
Logging options
整理的时候发现的日志功能,没用过(习之), 平时用println或者调试
Execution options
Environment options
Bootstrapping new projects
init, wrapper放在Gradle Wrapper中
Continuous Build

官方文档
使用Gradle Wrapper来执行任务是官方推荐的方式.直接"盗用"官方的wrapper工作流程图:

The Wrapper workflow

gradle wrapper

选项

所以选用all必须手动指定,不然可能花费大量时间来下载gradle. 比如我下载了gradle-4.6-all版本并且配置到环境变量中,想直接拿来初始化wrapper, 切换到工程根目录执行下面目录即可:

gradle wrapper --gradle-version 4.6 --distribution-type all

 # Upgrading the Wrapper version
$ ./gradlew wrapper --gradle-version 4.2.1
# Checking the Wrapper version after upgrading
$ ./gradlew -v

上面两个步骤生成一个没有任何子工程和代码的root project, 加点料吧.
./gradlew init
选项

--type java-library 使用指定的类型初始化工程. --type可以是java-application, java-library, scala-library,groovy-library,groovy-application,basic
init --dsl kotlin: gradle默认使用groovy作为dsl语言, 通过--dsl指定为kotlin

下面来添加一个groovy的库

$ mkdir greeting-library
$ cd greeting-library
$ ../gradlew init --type groovy-library

保留build.gradle和src目录, 其余文件(夹)全部删除, 添加include 'greeting-library'到rootDir/settings.gradle中. 这样边不需要手动创建约定的源码目录, 其他类型的工程类似. Android工程点这里