DependencyHandler

支持两种声明外部模块依赖项的表示法。一种是按此格式的字符串表示法

configurationName "group:name:version:classifier@extension"

另一种是映射表示法

configurationName group: group, name: name, version: version, classifier: classifier, ext: extension

在这两种表示法中，除了名称之外，所有属性都是可选的。

外部依赖项由 ExternalModuleDependency 表示。

plugins {
    id 'java' // so that we can use 'implementation', 'testImplementation' for dependencies
}

dependencies {
  //for dependencies found in artifact repositories you can use
  //the string notation, e.g. group:name:version
  implementation 'commons-lang:commons-lang:2.6'
  testImplementation 'org.mockito:mockito:1.9.0-rc1'

  //map notation:
  implementation group: 'com.google.code.guice', name: 'guice', version: '1.0'
}

要添加项目依赖项，您可以使用以下表示法

configurationName project(':some-project')

表示法 project(':project-a') 类似于您在多模块 Gradle 项目中配置 projectA 时使用的语法。

项目依赖项通过将目标项目中的每个可消费配置视为一个变体，并对其执行变体感知属性匹配来解析。但是，为了覆盖此过程，可以指定显式目标配置。

configurationName project(path: ':project-a', configuration: 'someOtherConfiguration')

项目依赖项使用 ProjectDependency 表示。

您还可以使用 FileCollection 添加依赖项。

configurationName files('a file')

plugins {
    id 'java' // so that we can use 'implementation', 'testImplementation' for dependencies
}

dependencies {
  //declaring arbitrary files as dependencies
  implementation files('hibernate.jar', 'libs/spring.jar')

  //putting all jars from 'libs' onto compile classpath
  implementation fileTree('libs')
}

文件依赖项使用 FileCollectionDependency 表示。

您可以使用 Configuration 添加依赖项。

当配置与目标配置来自同一项目时，目标配置将更改为从提供的配置扩展。

当配置来自不同的项目时，将添加项目依赖项。

可以依赖某些 Gradle API 或 Gradle 附带的库。这对于 Gradle 插件开发特别有用。示例

//Our Gradle plugin is written in groovy
plugins {
    id 'groovy'
}
// now we can use the 'implementation' configuration for declaring dependencies

dependencies {
  //we will use the Groovy version that ships with Gradle:
  implementation localGroovy()

  //our plugin requires Gradle API interfaces and classes to compile:
  implementation gradleApi()

  //we will use the Gradle test-kit to test build logic:
  testImplementation gradleTestKit()
}

此项目的组件元数据处理器。返回的处理器可用于添加修改依赖软件组件元数据的规则。

此项目的依赖约束处理器。

扩展容器。

此项目的组件模块元数据处理器。返回的处理器可用于添加修改依赖软件组件元数据的规则。

将依赖项添加到给定配置。

将依赖项添加到给定配置，并使用给定闭包配置依赖项。

为此项目配置组件元数据。

此方法对项目的 ComponentMetadataHandler 执行给定操作。

为此项目配置依赖约束。

此方法对项目的 DependencyConstraintHandler 执行给定操作。

创建依赖项而不将其添加到配置中。

创建依赖项而不将其添加到配置中，并使用给定闭包配置依赖项。

创建构件解析查询。

这是一个遗留 API，处于维护模式。在未来的 Gradle 版本中，此 API 将被弃用并删除。新代码不应使用此 API。优先使用 <UNHANDLED-LINK>ArtifactView.ViewConfiguration#withVariantReselection()</UNHANDLED-LINK> 来解析源和 javadoc。

声明对强制平台的依赖。如果目标坐标表示多个潜在组件，则将选择平台组件，而不是库。强制平台是其直接依赖项被强制的平台，这意味着它们将覆盖图中找到的任何其他版本。

声明对强制平台的依赖。如果目标坐标表示多个潜在组件，则将选择平台组件，而不是库。强制平台是其直接依赖项被强制的平台，这意味着它们将覆盖图中找到的任何其他版本。

配置此依赖提供者以选择目标组件的强制平台变体

配置此依赖提供者以选择目标组件的强制平台变体

创建对当前 Gradle 版本的 API 的依赖项。

创建对 Gradle test-kit API 的依赖项。

创建对当前 Gradle 版本附带的 Groovy 的依赖。

为此项目配置模块元数据。

此方法对项目的 ComponentModuleMetadataHandler 执行给定操作。

声明对平台的依赖。如果目标坐标表示多个潜在组件，则将选择平台组件，而不是库。

声明对平台的依赖。如果目标坐标表示多个潜在组件，则将选择平台组件，而不是库。

配置此依赖提供者以选择目标组件的平台变体

配置此依赖提供者以选择目标组件的平台变体

创建对项目的依赖。

注册 构件转换。

注册操作需要指定 from 和 to 属性。它还可以通过使用 TransformSpec.parameters(org.gradle.api.Action) 为转换操作提供参数。

例如：

// You have a transform action like this:
abstract class MyTransform implements TransformAction<Parameters> {
    interface Parameters extends TransformParameters {
        @Input
        Property<String> getStringParameter();
        @InputFiles
        ConfigurableFileCollection getInputFiles();
    }

    void transform(TransformOutputs outputs) {
        // ...
    }
}

// Then you can register the action like this:

def artifactType = Attribute.of('artifactType', String)

dependencies.registerTransform(MyTransform) {
    from.attribute(artifactType, "jar")
    to.attribute(artifactType, "java-classes-directory")

    parameters {
        stringParameter.set("Some string")
        inputFiles.from("my-input-file")
    }
}