Gradle

扩展的容器。

返回此 Gradle 实例。此方法在初始化脚本中显式访问 Gradle 属性和方法时非常有用。例如，使用 gradle.parent 可以比使用 parent 更清晰地表达您的意图。此属性还允许您从属性可能被隐藏的作用域（例如，从方法或闭包）访问 Gradle 属性。

Gradle 主目录（如果有）。此目录是包含执行此构建的 Gradle 发行版的目录。

当使用“Gradle Daemon”时，这可能与启动构建时使用的 Gradle 发行版不同。如果正在运行的现有守护程序进程被认为是兼容的（例如，具有所需的 JVM 特性），则可以使用此守护程序而不是启动新进程，并且它可能从不同的“gradle home”启动。但是，保证是相同版本的 Gradle。有关 Gradle Daemon 的更多信息，请参阅 用户手册。

Gradle 用户主目录。此目录用于缓存下载的资源、编译的构建脚本等。

当前的 Gradle 版本。

此构建的包含构建。

此构建的父构建（如果有）。

此插件感知对象的插件管理器。

已应用于此对象的插件容器。

虽然未弃用，但建议使用此接口或 PluginAware.getPluginManager() 的方法，而不是使用插件容器。

使用此接口或 PluginAware.getPluginManager() 上的 'apply' 方法之一来应用插件，而不是通过插件容器应用。

使用 PluginManager.hasPlugin(java.lang.String) 或类似方法来查询插件的应用，而不是通过插件容器进行查询。

此构建的根项目。

用于启动此构建的 StartParameter。

此构建的 TaskExecutionGraph。

向此 Build 实例添加 BuildListener。侦听器会在构建执行期间发生事件时收到通知。

向此构建添加给定的侦听器。侦听器可以实现任何给定的侦听器接口

以下侦听器类型可以使用，但在启用配置缓存时不受支持。它们的使用已弃用，并且在未来的 Gradle 版本中添加这些类型的侦听器将成为错误

向此构建添加一个侦听器，以接收项目评估的通知。

添加一个闭包，在项目评估后立即调用。项目作为第一个参数传递给闭包。项目评估失败（如果有）作为第二个参数传递。两个参数都是可选的。

添加一个动作，在项目评估后立即调用。

添加一个动作，以针对此构建的所有项目执行。该动作会立即针对所有已可用的项目执行。它也会在后续项目添加到此构建时执行。

应用零个或多个插件或脚本。

给定的闭包用于配置 ObjectConfigurationAction，它“构建”插件应用程序。

此方法与 PluginAware.apply(java.util.Map) 的不同之处在于，它允许多次调用配置动作的方法。

使用以 Map 形式提供的给定选项，应用插件或脚本。如果插件已应用，则不执行任何操作。

给定的 Map 作为一系列方法调用应用于新创建的 ObjectConfigurationAction。也就是说，Map 中的每个键都应是 ObjectConfigurationAction 的方法名称，并且值应是与该方法兼容的参数。

以下选项可用

应用零个或多个插件或脚本。

给定的闭包用于配置 ObjectConfigurationAction，它“构建”插件应用程序。

此方法与 PluginAware.apply(java.util.Map) 的不同之处在于，它允许多次调用配置动作的方法。

添加一个闭包，在项目评估之前立即调用。项目作为参数传递给闭包。

添加一个动作，在项目评估之前立即调用。

添加一个动作，在构建设置加载和评估之前调用。

添加一个动作，在构建设置加载和评估之前调用。

添加一个闭包，在构建完成时调用。所有选定的任务都已执行。BuildResult 实例作为参数传递给闭包。

添加一个动作，在构建完成时调用。所有选定的任务都已执行。

返回此构建中具有指定名称的包含构建。

添加一个闭包，在构建的所有项目都已评估后调用。项目对象已完全配置，可以用于填充任务图。此 Gradle 实例作为参数传递给闭包。

添加一个动作，在构建的所有项目都已评估后调用。项目对象已完全配置，可以用于填充任务图。

添加一个闭包，在从设置中创建构建的项目后调用。没有任何项目被评估。此 Gradle 实例作为参数传递给闭包。

一个将 projectsLoaded 挂钩以从初始化脚本配置 buildscript 类路径的示例。

//init.gradle
gradle.projectsLoaded {
  rootProject.buildscript {
    repositories {
      //...
    }
    dependencies {
      //...
    }
  }
}

添加一个动作，在从设置中创建构建的项目后调用。没有任何项目被评估。

从此构建中移除给定的侦听器。

从此构建中移除给定的侦听器。

添加一个动作，以针对此构建的根项目执行。如果根项目已可用，则该动作会立即执行。否则，该动作会在根项目变为可用时执行。

添加一个闭包，在构建设置加载和评估后调用。设置对象已完全配置，可以用于加载构建项目。Settings 对象作为参数传递给闭包。

添加一个动作，在构建设置加载和评估后调用。设置对象已完全配置，可以用于加载构建项目。

使用给定的对象作为记录器。记录器对象可以实现 Gradle.addListener(java.lang.Object) 支持的任何侦听器接口。

每个侦听器接口都只有一个关联的记录器。当您使用给定侦听器类型的记录器调用此方法时，新的记录器将替换当前与该侦听器类型关联的任何记录器。这允许您有选择地将 Gradle 提供的标准日志记录替换为您自己的实现，用于某些类型的事件。