DependencyHandler

有两种表示法支持声明对外部模块的依赖项。一种是字符串表示法，格式如下

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

另一种是 Map 表示法

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

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

外部依赖项由 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 附带的某些 Gradle API 或库。这对于 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()
}

客户端模块依赖项已弃用，将在 Gradle 9.0 中删除。请改用组件元数据规则。

要将客户端模块添加到配置，可以使用以下表示法

configurationName module(moduleNotation) {
    module dependencies
}

模块表示法与上面描述的依赖表示法相同，只是 classifier 属性不可用。客户端模块使用 ClientModule 表示。

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

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

扩展的容器。

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

向给定配置添加依赖项。

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

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

此方法针对此项目的 ComponentMetadataHandler 执行给定的 Action。

为此项目配置依赖约束。

此方法针对此项目的 DependencyConstraintHandler 执行给定的 Action。

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

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

创建 Artifact 解析查询。

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

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

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

配置此依赖项 Provider 以选择目标组件的 enforced-platform 变体

配置此依赖项 Provider 以选择目标组件的 enforced-platform 变体

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

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

创建对与当前 Gradle 版本一起分发的 Groovy 的依赖项。

创建对客户端模块的依赖项。

创建对客户端模块的依赖项。依赖项在使用给定的闭包配置后返回。

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

此方法针对此项目的 ComponentModuleMetadataHandler 执行给定的 Action。

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

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

配置此依赖项 Provider 以选择目标组件的平台变体

配置此依赖项 Provider 以选择目标组件的平台变体

创建对项目的依赖项。

注册 Artifact 转换。

注册 action 需要指定 from 和 to 属性。它还可以通过使用 TransformSpec.parameters(org.gradle.api.Action) 为转换 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")
    }
}