创建新的Gradle构建项目

原文:https://guides.gradle.org/creating-new-gradle-builds/?_ga=2.31763454.1944813557.1520676566-756017329.1520676566

跟随指导,你将创建一个简单的Gradle项目,执行一些基础Gradle命令,并了解Gradle如何管理项目。

目录

  • 你需要准备什么
  • 初始化项目
  • 创建一个任务
  • 应用一个插件
  • 探索和调试你的构建项目
  • 下一步
  • 帮助改进本指南

你需要准备什么

  • 11分钟
  • 一个命令行窗口或一个集成开发环境
  • 确保已安装Java开发环境,必须是1.7或更高版本
  • 确保已安装Gradle4.6,或更高

初始化项目

首先,让我们为项目创建一个新的文件夹。

然后,在命令行窗口中跳转到新创建的文件夹下,输入命令:gradle init

C:\Users\Administrator>I:

I:\>cd Gradle\gradle-demo\

I:\Gradle\gradle-demo>gradle init
Starting a Gradle Daemon, 2 incompatible and 1 stopped Daemons could not be reused, use --status for details
:wrapper
:init

BUILD SUCCESSFUL

以下是Gradle为你生成的项目结构:

《创建新的Gradle构建项目》 项目结构

01.项目配置脚本,用于配置当前项目中的任务
02.Gradle Wrapper可执行代码库
03.Gradle Wrapper配置属性
04.基于Unix的系统的Gradle Wrapper脚本
05.Windows系统的Gradle Wrapper脚本
06.用于配置哪些项目参与构建的配置脚本

创建一个任务

Gradle提供了创建和配置任务的基于Groovy或Kotlin特定领域语言的API。
Gradle自带一个任务库,你可以在你的项目中对此任务库进行配置。例如,有一个名为copy的任务,可以将文件从一个位置复制到另一个位置。copy任务非常有用(详细信息请参阅文档),但在这里,我们只介绍最简单的用法。执行以下步骤:

01.创建一个文件夹:src
02.在src中添加一个文件myfile.txt。可以填写任意内容(甚至什么都不填),但为了方便,添加一行“Hello, World!”进去吧。
03.在build.gradle中定义一个名为copy类型为Copy(注意大小写)的任务,它将src中的文件复制到一个名为dest的新文件夹中(你无需创建dest文件夹,copy任务会替你创建)。

task copy(type: Copy, group:"Custom", description:"task description") {
    from "src"
    into "dest"
}

在这里,group和description的内容可以填写任意。你甚至可以省略它们,但是这样做也会在任务报告中省略它们,稍后会用到它们。
现在执行你的新任务copy:
输入命令:gradle copy

I:\Gradle\gradle-demo>gradle copy
:copy

BUILD SUCCESSFUL

译者注:
我在执行时发现一个坑,就是在编辑build.gradle时,任务的左大括号不能另起一行,要写到括号的末尾,>否则会执行失败:

正确:

task taskName() {
}

错误:

task taskName()
{
}

使用插件

Gradle包含一系列插件,在Gradle插件网站上还有更多的插件。在你下载的发布版中,包含了一个基本插件。结合任务类型Zip,你可以创建zip存档,并且可以配置文件名和文件位置。
使用关键字plugins将base插件添加至你的build.gradle中。请务必在文件顶部添加插件{}块:

plugins {
    id "base"
}

现在添加一个从src目录创建一个zip存档的任务:

task zip(type: Zip, group: "Archive", description: "task description") {
    from "src"
}

base插件会根据设置在build\distributions文件夹中创建一个存档文件:basic-demo.zip。

下面执行zip任务:

gradle zip

如果执行成功,可以在build\distributions中看到basic-demo.zip。

探索和调试你的构建项目

来看看在我们的新项目中还能用Gradle做些什么。点击查看完整的命令行参考

查看可用的任务列表

tasks命令可以列出所有可以执行的任务,包括你添加的插件中的和你自定义的任务。

gradle tasks

下面是我的执行结果:

《创建新的Gradle构建项目》 执行结果

下一步

恭喜!你已经创建了一个新的Gradle构建项目,并学习了如何检查Gradle构建项目!
您可能希望为特定平台创建库或应用程序,因此以下是一些指南,可以帮助您更多地了解如何在所选平台中创建构建项目:

  • 构建安卓应用
  • 构建C++可执行文件
  • 构建Groovy库
  • 构建Java库
  • 构建Kotlin JVM库
  • 构建Scala库

你也可以在GitHub上检出很多Gradle构建项目示例。

帮助改进本指南

有反馈或问题?发现错字?像所有Gradle指南一样,帮助只是一个GitHub问题。请向Gradle-Guides/Creating-new-gradle-build添加问题或提出请求,我们会尽快与你联系。

    原文作者:安静的程序员
    原文地址: https://www.jianshu.com/p/9ef1ab5874f3
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞