入门指南

每个人都必须从某个地方开始，如果你是新手，这就是起点。

在开始之前

为了有效地使用Gradle，您需要知道它是什么，并理解它的一些基本概念。所以在你认真使用Gradle之前，我们强烈推荐你阅读什么是Gradle?

即使你有使用Gradle的经验，我们建议你阅读关于Gradle你需要知道的5件事，因为它澄清了一些常见的误解。

如果您只想运行现有的Gradle项目，如果项目中带有 Gradle Wrapper，可以通过项目根目录中的文件 gradlew 或 gradlew 识别，那么您就不需要安装Gradle。您只需要确保您的系统满足 Gradle的先决条件。

Android Studio 自己附带了一个 Gradle，所以在这种情况下也不需要单独安装Gradle。

为了创建新的项目或向现有构建添加 Wrapper(包装器)，您需要根据这些说明安装Gradle。请注意，除了页面上描述的方法之外，可能还有其他方法来安装Gradle，因为不可能列举所有的包管理器。

积极使用Gradle是一个很好的学习它的方法，所以一旦你安装了Gradle，尝试下列介绍性的实践教程:

还有许多其他教程和指南可供选择，您可以根据类别进行筛选——例如基础知识。

有些人是命令行的铁杆用户，而另一些人则宁愿永远不离开IDE。许多人很高兴地同时使用这两种方法，而也Gradle不去歧视任一种方法。多个主流的IDE 都支持 Gradle，所有可以从命令行完成的工作都可以通过工具API 提供给IDE。

Android Studio 和 IntelliJ IDEA 的用户可以考虑在编辑时使用 Kotlin DSL 脚本来获得高级IDE的功能支持。

如果您遵循上面链接的任何教程，您将执行Gradle构建。但是，如果你得到了一个没有任何说明的Gradle项目，你会怎么做呢?

以下是一些有用的步骤:

确定项目是否有Gradle Wrapper（包装器），如果有就使用它——当 Wrapper（包装器）可用时，主IDE默认会使用 Wrapper（包装器）。
检查项目结构。
要么用IDE导入构建，要么从命令行运行gradle项目。如果只列出根项目，则为单个项目。否则，它是一个多项目结构。
找出可以运行哪些任务。
如果您已经将项目导入IDE，那么您能够访问一个显示所有可用任务的视图。从命令行运行 gradle <taskname>。
通过了解更多关于任务的信息可以通过命令 gradle help --task <taskname>。
gradle help 可以显示关于任务的额外信息，包括哪些项目包含该任务以及该任务支持哪些选项。
运行您感兴趣的任务。
许多遵守标准约定的Gradle项目都集成了一套生命周期任务，所以当您没有更具体的想要在构建中做的事情时，可以直接使用这些构建。例如，大多数项目构建都有清理、检查、组装和构建等任务。
在命令行中，只需运行 gradle <taskname> 命令就可以执行指定的任务。有关命令行执行的更多信息，请参阅相应的用户手册一章。如果您正在使用IDE，请查看它的文档，了解如何运行任务。

Gradle项目都遵守标准的项目结构和约定的任务，如果你熟悉其他相同类型的项目，如 Java、Android 或者系统原生项目，那么文件和目录结构、任务和项目属性都相差无几。

对于更专业化的项目或需要高度定制的项目，理想情况下您应该能够访问关于如何运行项目构建以及可以配置哪些构建属性的文档.

学习创建和维护Gradle项目是一个过程，需要一点时间。我们建议您从适合您的项目的核心插件及其约定开始，然后随着您对该工具的了解越来越多，逐步合并定制。

下面是一些在你第一步掌握Gradle旅程中非常有用的要点：

用户手册包含了许多其他有用的信息，你可以在 Gradle指南中找到更多关于各种Gradle特性的教程。

Gradle的灵活性意味着它可以很容易地与其他工具一起工作，例如我们的第三方工具页面上列出的那些工具。

集成方式主要有两种：

现有的 java 开放 api 的工具集成起来很方便。您可以在Gradle的插件市场上找到许多这样的集成工具。