DependencyConstraintHandler

目录

依赖约束标记法
属性
方法
脚本块
方法详情
API 文档DependencyConstraintHandler

DependencyConstraintHandler 用于声明依赖约束。

依赖约束标记法

有几种受支持的依赖约束标记法。这些在下面描述。对于以此方式声明的每个依赖约束，都会创建一个 DependencyConstraint 对象。您可以使用此对象来查询或进一步配置依赖约束。

您也可以始终直接添加 DependencyConstraint 的实例

configurationName(<instance>)

依赖约束也可以使用 Provider 声明，该 Provider 提供任何其他受支持的依赖约束标记法。

外部依赖

有两种标记法支持声明外部模块的依赖约束。一种是字符串标记法，格式如下

configurationName("group:name:version")

另一种是 map 标记法

configurationName(group: group, name: name, version: version)

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

plugins {
    id("java-library") // so that we can use 'implementation', 'testImplementation' for dependency constraints
}

dependencies {
  constraints {
    //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"))

属性

无属性

方法

方法描述
add(configurationName, dependencyNotation)

向给定配置添加依赖约束。

add(configurationName, dependencyNotation, configureAction)

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

create(dependencyConstraintNotation)

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

create(dependencyConstraintNotation, configureAction)

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

enforcedPlatform(notation)

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

enforcedPlatform(notation, configureAction)

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

脚本块

无脚本块

方法详情

DependencyConstraint add(String configurationName, Object dependencyNotation)

向给定配置添加依赖约束。

DependencyConstraint add(String configurationName, Object dependencyNotation, Action<? super DependencyConstraint> configureAction)

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

DependencyConstraint create(Object dependencyConstraintNotation)

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

DependencyConstraint create(Object dependencyConstraintNotation, Action<? super DependencyConstraint> configureAction)

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

DependencyConstraint enforcedPlatform(Object notation)

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

DependencyConstraint enforcedPlatform(Object notation, Action<? super DependencyConstraint> configureAction)

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