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 项目中配置项目A时使用的语法。

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

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 执行给定的动作。

配置此项目的依赖约束。

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

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

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

创建 Artifact 解析查询。

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

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

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

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

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

创建一个依赖于当前 Gradle 版本 API 的依赖项。

创建一个依赖于 Gradle test-kit API 的依赖项。

创建一个依赖于当前 Gradle 版本附带的 Groovy 的依赖项。

创建一个依赖于客户端模块的依赖项。

创建一个依赖于客户端模块的依赖项。在返回该依赖项之前，会使用给定的闭包对其进行配置。

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

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

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

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

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

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

创建一个依赖于项目的依赖项。

注册一个 artifact transform。

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