DependencySubstitutions

添加一个依赖项替换规则，该规则在解析配置时，将为每个依赖项（包括传递依赖项）触发。该操作接收一个 DependencySubstitution 实例，该实例可用于查明正在解析的依赖项并影响解析过程。

示例

configurations { main }
// add dependency substitution rules
configurations.main.resolutionStrategy.dependencySubstitution {
  // Use a rule to change the dependency module while leaving group + version intact
  all { DependencySubstitution dependency ->
    if (dependency.requested instanceof ModuleComponentSelector && dependency.requested.module == 'groovy-all') {
      dependency.useTarget dependency.requested.group + ':groovy:' + dependency.requested.version
    }
  }
  // Use a rule to replace all missing projects with module dependencies
  all { DependencySubstitution dependency ->
   if (dependency.requested instanceof ProjectComponentSelector) {
      def targetProject = findProject(":${dependency.requested.path}")
      if (targetProject == null) {
        dependency.useTarget "org.myorg:" + dependency.requested.path + ":+"
      }
    }
  }
}

规则按照声明的顺序进行评估。规则在强制模块应用后进行评估（请参阅 ResolutionStrategy.force(java.lang.Object[])

从提供的输入字符串创建一个 ModuleComponentSelector。字符串的格式必须为“{group}:{module}:{version}”。

从提供的输入字符串创建一个 ProjectComponentSelector。字符串的格式必须为“:path”。

用于为与提供的选择器匹配的依赖项构建依赖项替换的 DSL 友好机制。

示例

configurations { main }
configurations.main.resolutionStrategy.dependencySubstitution {
  // Substitute project and module dependencies
  substitute module('org.gradle:api') using project(':api')
  substitute project(':util') using module('org.gradle:util:3.0')

  // Substitute one module dependency for another
  substitute module('org.gradle:api:2.0') using module('org.gradle:api:2.1')
}