Gradle 安装 & 命令行选项

系统学习 Gradle ,不局限于Android ,学习《实战Gradle》并简要记录

1 安装

直接参考 Gradle主页 安装方式,安装即可!

两种安装方式:

1.1 Install with a package manager (使用 包管理器 安装)

对于Mac系统,需要先安装 Homebrew ,然后在使用下面的命令 安 Gradle

$ brew install gradle

运行之后,提示如下信息(偶然性),需要升级 Xcode 版本,或者 干掉它。


之前的版本太低了,Homebrew 的版本需要更新

需要升级 Xcode

删掉还是升级,任选一种吧,处理之后:
正常安装

验证安装是否成功

$ gradle -v

查询结果如下,表示安装成功


安装成功
1.2 Install manually(手动安装)

参考官网,本文采取第一种安装方式

2 命令行选项

gradle 命令允许同时定义一个或多个命令行选项
比如下文要提到的 -i 和 -s 选项,就可以合并为 -is 或 -i -s

本文将介绍 最重要的10个命令行选项,并进行简单分类:

  • 日志选项 3个 ,-i / -s / -q
  • 参数选项 2个,-D / -P
  • 帮助任务 2个 ,tasks / properties
  • 其它选项3个, -? / -b / --offline

日志选项 (-i / -s / -q)

2.1 开始使用 Gradle ,并使用 -q 命令行选项

创建脚本文件,然后运行。
Gradle 构建脚本默认名字是 build.gradle

2.1.1 在对应路径下,创建脚本文件,从 Hello World 开始
创建脚本文件

脚本语言是Groovy(Gradle的通用语言),其中 task 和 action (doLast 就是一个 action)是这门语言(Gradle就是Groovy)的重要元素!

task helloWorld{
    doLast{
        println 'hello world !'
    }
}

<< 可以简单代表 doLast ,上述代码可简化为:

task helloWorld << {
        println 'hello world !'
}
2.1.2 运行脚本
gradle -q helloworld

<< 替换 doLast 后的两次运行结果一致,如下:


运行结果

去掉 -q 命令行选项,打印的信息如下:


去掉 -q 命令行选项
  1. doLast 是 task 执行的最后一个 action ,可用 << 简单代表
  2. 通过 -q 命令行选项 使其只输出该task相关的信息。同 --quiet 命令行选项
gradle --quiet helloworld
-q 命令行选项 等同于 --quiet 命令行选项

2.2 命令行选项 -i , --info

默认设置中不会提供大量的输出信息,如果想知道构建中发生了什么,
日志级别改到 INFO ,可以获取到更多信息

效果展示

2.3 命令行选项 -s , --stacktrace

-s 选项在有异常抛出时会打印出简短的堆栈跟踪信息,以帮助进行调试
将脚本故意多写一个大括号,以测试 -s 选项

task helloWorld << {
        println 'hello world !'
}
}

对比未使用 -s 和使用时的区别:

未使用 -s

使用 -s 选项,第一页

使用 -s 选项,最后一页

可以看到详细的堆栈信息(中间的没有截图,太多了)

参数选项 (-D / -P)

2.4 命令行选项 -D , --system-prop

Gradle 是以一个 JVM进程运行的,和所有的 Java 进程一样,可以提供一个系统参数。

-D, --system-prop         Set system property of the JVM (e.g. -Dmyprop=myvalue).

2.5 命令行选项 -P , --project-prop

项目参数是构建脚本中可用的变量,可以使用这个选项直接向构建脚本中传入参数

-P, --project-prop        Set project property for the build script (e.g. -Pmyprop=myvalue).

帮助任务 (tasks / properties)

2.6 命令行选项 tasks

显示项目中所有可运行的task,包括它们的描述信息。
项目中应用的插件可能会提供一些额外的task。


效果展示

2.7 命令行选项 properties

显示出项目中所有可用的属性。

jake@bogon:~/Documents/gradleTest$     gradle properties

> Task :properties

------------------------------------------------------------
Root project
------------------------------------------------------------

allprojects: [root project 'gradleTest']
ant: org.gradle.api.internal.project.DefaultAntBuilder@1a8f065b
antBuilderFactory: org.gradle.api.internal.project.DefaultAntBuilderFactory@5cdd0183
artifacts: org.gradle.api.internal.artifacts.dsl.DefaultArtifactHandler_Decorated@5e0ed76
asDynamicObject: DynamicObject for root project 'gradleTest'
baseClassLoaderScope: org.gradle.api.internal.initialization.DefaultClassLoaderScope@7dfd9b3b
buildDir: /Users/jake/Documents/gradleTest/build
buildFile: /Users/jake/Documents/gradleTest/build.gradle
buildPath: :
buildScriptSource: org.gradle.groovy.scripts.TextResourceScriptSource@1f22e701
buildscript: org.gradle.api.internal.initialization.DefaultScriptHandler@2b473c7f
childProjects: {}
class: class org.gradle.api.internal.project.DefaultProject_Decorated
classLoaderScope: org.gradle.api.internal.initialization.DefaultClassLoaderScope@294eef3c
components: SoftwareComponentInternal set
configurationActions: org.gradle.configuration.project.DefaultProjectConfigurationActionContainer@387b9d6d
configurationTargetIdentifier: org.gradle.configuration.ConfigurationTargetIdentifier$1@30e97f8c
configurations: configuration container
convention: org.gradle.api.internal.plugins.DefaultConvention@225f192a
defaultTasks: []
deferredProjectConfiguration: org.gradle.api.internal.project.DeferredProjectConfiguration@7cb62552
dependencies: org.gradle.api.internal.artifacts.dsl.dependencies.DefaultDependencyHandler_Decorated@18425f5c
dependencyLocking: org.gradle.internal.locking.DefaultDependencyLockingHandler_Decorated@632c46c7
depth: 0
description: null
displayName: root project 'gradleTest'
ext: org.gradle.api.internal.plugins.DefaultExtraPropertiesExtension@396085c1
extensions: org.gradle.api.internal.plugins.DefaultConvention@225f192a
fileOperations: org.gradle.api.internal.file.DefaultFileOperations@74b1ab0a
fileResolver: org.gradle.api.internal.file.BaseDirFileResolver@7e83a27f
gradle: build 'gradleTest'
group:
helloWorld: task ':helloWorld'
identityPath: :
inheritedScope: org.gradle.api.internal.ExtensibleDynamicObject$InheritedDynamicObject@7f18d916
layout: org.gradle.api.internal.file.DefaultProjectLayout@426b15b9
listenerBuildOperationDecorator: org.gradle.configuration.internal.DefaultListenerBuildOperationDecorator@3b7b0f05
logger: org.gradle.internal.logging.slf4j.OutputEventListenerBackedLogger@48044c24
logging: org.gradle.internal.logging.services.DefaultLoggingManager@5808d24f
modelRegistry: org.gradle.model.internal.registry.DefaultModelRegistry@61616031
modelSchemaStore: org.gradle.model.internal.manage.schema.extract.DefaultModelSchemaStore@15fbb562
module: org.gradle.api.internal.artifacts.ProjectBackedModule@7d30806e
name: gradleTest
normalization: org.gradle.normalization.internal.DefaultInputNormalizationHandler_Decorated@7bbd6779
objects: org.gradle.api.internal.model.DefaultObjectFactory@18dd5c2c
parent: null
parentIdentifier: null
path: :
pluginManager: org.gradle.api.internal.plugins.DefaultPluginManager_Decorated@6597fd2
plugins: [org.gradle.api.plugins.HelpTasksPlugin@6cd3e7c0]
processOperations: org.gradle.api.internal.file.DefaultFileOperations@74b1ab0a
project: root project 'gradleTest'
projectConfigurator: org.gradle.api.internal.project.BuildOperationCrossProjectConfigurator@7c45c38c
projectDir: /Users/jake/Documents/gradleTest
projectEvaluationBroadcaster: ProjectEvaluationListener broadcast
projectEvaluator: org.gradle.configuration.project.LifecycleProjectEvaluator@e0bcc14
projectPath: :
projectRegistry: org.gradle.api.internal.project.DefaultProjectRegistry@43e185e8
properties: {...}
providers: org.gradle.api.internal.provider.DefaultProviderFactory@76c75cee
repositories: repository container
resourceLoader: org.gradle.internal.resource.transfer.DefaultUriTextResourceLoader@30ff87b3
resources: org.gradle.api.internal.resources.DefaultResourceHandler@62f46b83
rootDir: /Users/jake/Documents/gradleTest
rootProject: root project 'gradleTest'
script: false
scriptHandlerFactory: org.gradle.api.internal.initialization.DefaultScriptHandlerFactory@32cf70a5
scriptPluginFactory: org.gradle.configuration.ScriptPluginFactorySelector@7d4e6dd1
serviceRegistryFactory: org.gradle.internal.service.scopes.ProjectScopeServices$4@31c0afd4
services: ProjectScopeServices
standardOutputCapture: org.gradle.internal.logging.services.DefaultLoggingManager@5808d24f
state: project state 'EXECUTED'
status: release
subprojects: []
tasks: task set
version: unspecified

Deprecated Gradle features were used in this build, making it incompatible with Gradle 5.0.
Use '--warning-mode all' to show the individual deprecation warnings.
See https://docs.gradle.org/4.10.2/userguide/command_line_interface.html#sec:command_line_warnings

BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

其它选项 (-? / -b / --offline)

2.8 命令行选项 -? , -h , --help

打印出所有可用的命令行选项。包含描述信息

// 任选一个命令
gradle -?
gradle -h
gradle --help

2.9 命令行选项 -b , --build-file

Gradle 构建脚本的默认命名约定是 build.gradle。
使用该命令可以执行一个特定名字的构建脚本。

创建一个名为 jake.gradle 的脚本文件,包含一个名为 test 的 task

命令结构为: gradle -b [文件名] [任务名]

gradle -b jake.gradle  test
运行结果
gradle -q -b jake.gradle  test
当然,也可以和 -q 选项同时使用

2.10 命令行选项 --offline

使用该选项可以以离线模式运行构建,仅仅在本地缓存中检查依赖是否存在。
在无网络且本地缓存没有时,若不使用该选项,构建都会失败。


Gradle 更多,待续...

你可能感兴趣的:(Gradle 安装 & 命令行选项)