gradle-学习笔记(1)-初步使用
最近想深入的学习一下工程化方面相关的东西,在maven和gradle直接纠结不已,因为maven的扩展性太差劲了,学习成本颇高,所以最后投入了gradle的怀抱中,以后有时间再重新学习一下maven吧
最近的学习笔记是基于gradle 5 系列,其中各种教程和例子大都是来源于官方文档或者网络上的博客。内容涵盖我在学习gradle过程中的各种心得和gradle的一些使用方法
注意: 这里使用的配偶语言世kotlin 而不是使用groovy
gradle创建项目
一个命令
gradle init
用户可以通过这个命令创建一个基本的gradle项目包括gradle项目的目录结构
├── build.gradle (1) ├── gradle │ └── wrapper │ ├── gradle-wrapper.jar (2) │ └── gradle-wrapper.properties (3) ├── gradlew (4) ├── gradlew.bat (5) └── settings.gradle (6)
- (1) gradle 的构建脚本用来构建当前的gradle项目,最核心的配置文件
- (2) (3) 一个gradle副本和配置文件,用来当如果系统中的gradle版本和项目使用的gradle版本不同,将会在这里下载一个项目中的版本
- (4) (5) 配套使用的命令行工具 没有.bat后缀的是unix系统命令有的是windowns系统,可以用来执行gradle中定义的各种task 任务
- (6) 用于配置Gradle构建的Gradle设置脚本
gradle的task
gradle 方便用户进行配置的特性是源于gradle提供了方便使用task参数
这里编写一个很基本的copy文件的权限,在路径中添加一个src文件夹和dest文件夹,在src文件中添加一个文件markfile.txt 并且里面有一个内容hello world!
然后在build.gradle 中编写一个任务
task copy(type:Copy,group:"custom",description:"test one"){ from "src" into "dest" }
其中的type 字段将会调用系统中的Copy函数,而group和description 只是描述这个过程的描述符,只会影响系统的log输出,并不会影响实际的效果
./gradlew Copy
运行对应的命令就能运行对应的copy方法
使用一个gradle内部的插件系统
在项目中使用插件标签plugins添加指定的base插件到系统中
plugins { id "base" }
然后在指定的位置我们添加一个插件(和任务的使用方法相同,我怀疑其实gradle的插件就是打包好的任务)
task zip(type: Zip, group: "Archive", description: "Archives sources in a zip file") { from "src" setArchiveName "basic-demo-1.0.zip" }
然后运行对应的命令,就可以在对应的目录 build/distributions 中找到 src目录下的压缩文件了
./gradlew Zip
查看当前拥有的task
gradle 有一个内置的命令
./gradlew task
这条命令将会将所有的当前的gradle项目中拥有的构建命令全部列出来
> Task :tasks ------------------------------------------------------------ Tasks runnable from root project ------------------------------------------------------------ Archive tasks ------------- zip - Archives sources in a zip file Build tasks ----------- assemble - Assembles the outputs of this project. build - Assembles and tests this project. clean - Deletes the build directory. Build Setup tasks ----------------- init - Initializes a new Gradle build. wrapper - Generates Gradle wrapper files. Custom tasks ------------ copy - Copies sources to the dest directory Help tasks ---------- buildEnvironment - Displays all buildscript dependencies declared in root project 'gradle'. components - Displays the components produced by root project 'gradle'. [incubating] dependencies - Displays all dependencies declared in root project 'gradle'. dependencyInsight - Displays the insight into a specific dependency in root project 'gradle'. dependentComponents - Displays the dependent components of components in root project 'gradle'. [incubating] help - Displays a help message. model - Displays the configuration model of root project 'gradle'. [incubating] projects - Displays the sub-projects of root project 'gradle'. properties - Displays the properties of root project 'gradle'. tasks - Displays the tasks runnable from root project 'gradle'. Verification tasks ------------------ check - Runs all checks. Rules ----- Pattern: clean<TaskName>: Cleans the output files of a task. Pattern: build<ConfigurationName>: Assembles the artifacts of a configuration. Pattern: upload<ConfigurationName>: Assembles and uploads the artifacts belonging to a configuration. To see all tasks and more detail, run gradlew tasks --all To see more detail about a task, run gradlew help --task <task> BUILD SUCCESSFUL in 1s 1 actionable task: 1 executed <-------------> 0% WAITING > IDLE
gradle 提供的在线查看构建详情的方法 --scan命令
我们在使用构建命令的时候可以在命令的后面添加一个 --scan命令,通过这个命令可以链接到gradle官方的view显示仓库或者连接到自定义的链接仓库中,然后轻松的查看项目使用的构建任务,构建时间等等信息
./gradlew Zip --scan
然后可以登入命令行打出的一个网址,在其中的form表单中填写邮箱地址,然后就会将构建的信息发送到邮箱中了
注意:这个功能是收费的gradle 展示当前系统的可用参数信息 properties命令
$ ./gradlew properties > Task :properties ------------------------------------------------------------ Root project ------------------------------------------------------------ buildDir: /Users/.../basic-demo/build buildFile: /Users/.../basic-demo/build.gradle description: null group: name: basic-demo projectDir: /Users/.../basic-demo version: unspecified BUILD SUCCESSFUL