org.gradle.api.artifacts

インタフェース ComponentSelectionRules

@Incubating
public interface ComponentSelectionRules

Represents a container for component selection rules. Rules can be applied as part of the resolutionStrategy of a configuration and individual components can be explicitly accepted or rejected by rule. Components that are neither accepted or rejected will be subject to the default version matching strategies.

     configurations {
         conf {
             resolutionStrategy {
                 componentSelection {
                     all { ComponentSelection selection ->
                         if (selection.candidate.name == 'someModule' && selection.candidate.version == '1.1') {
                             selection.reject("bad version '1.1' for 'someModule'")
                         }
                     }
                     all { ComponentSelection selection, IvyModuleDescriptor descriptor, ComponentMetadata metadata ->
                         if (selection.candidate.name == 'someModule' && descriptor.branch == 'testing') {
                             if (metadata.status != 'milestone') {
                                 selection.reject("only use milestones for someModule:testing")
                             }
                         }
                     }
                     module("org.sample:api") { ComponentSelection selection ->
                         if (selection.candidate.version == "1.1") {
                             selection.reject("known bad version")
                         }
                     }
                 }
             }
         }
     }
 

メソッドの概要

修飾子とタイプ	メソッドと説明
ComponentSelectionRules	all(Action<? super ComponentSelection> selectionAction) Adds a simple component selection rule that will apply to all resolved components.
ComponentSelectionRules	all(Closure<?> closure) Adds a component selection rule that will apply to all resolved components.
ComponentSelectionRules	module(Object id, Action<? super ComponentSelection> selectionAction) Adds a component selection rule that will apply to the specified module.
ComponentSelectionRules	module(Object id, Closure<?> closure) Adds a component selection rule that will apply to the specified module.

メソッドの詳細

all

ComponentSelectionRules all(Action<? super ComponentSelection> selectionAction)

Adds a simple component selection rule that will apply to all resolved components. Each rule will receive a ComponentSelection object as an argument.

パラメータ:

selectionAction - the Action that implements a rule to be applied

戻り値:

this

all

ComponentSelectionRules all(Closure<?> closure)

Adds a component selection rule that will apply to all resolved components. Each rule will receive a ComponentSelection object as an argument as well as any other arguments specified for the closure. Allowable closure arguments are ComponentSelection (required), ComponentMetadata and/or IvyModuleDescriptor.

パラメータ:

closure - the Closure that implements a rule to be applied

戻り値:

this

module

ComponentSelectionRules module(Object id,
                               Action<? super ComponentSelection> selectionAction)

Adds a component selection rule that will apply to the specified module. Each rule will receive a ComponentSelection object as an argument.

パラメータ:

id - the module to apply this rule to in "group:module" format or as a ModuleIdentifier

selectionAction - the Action that implements a rule to be applied

戻り値:

this

module

ComponentSelectionRules module(Object id,
                               Closure<?> closure)

Adds a component selection rule that will apply to the specified module. Each rule will receive a ComponentSelection object as an argument as well as any other arguments specified for the closure. Allowable closure arguments are ComponentSelection (required), ComponentMetadata and/or IvyModuleDescriptor.

パラメータ:

id - the module to apply this rule to in "group:module" format or as a ModuleIdentifier

closure - the Closure that implements a rule to be applied

戻り値:

this