ResolvableConfiguration

API Documentation:ResolvableConfiguration

Note: This class is incubating and may change in a future version of Gradle.

A Configuration which performs dependency resolution to build dependency graphs and resolve artifacts.

Properties

PropertyDescription
allArtifacts

The artifacts of this configuration including the artifacts of extended configurations.

allDependencies

Gets the complete set of declared dependencies including those contributed by superconfigurations.

artifacts

The artifacts of this configuration excluding the artifacts of extended configurations.

buildDependencies

Returns a TaskDependency object containing all required dependencies to build the local dependencies (e.g. project dependencies) belonging to this configuration or to one of its super configurations.

dependencies

Gets the set of declared dependencies directly contained in this configuration (ignoring superconfigurations).

description

The description for this configuration.

excludeRules

The exclude rules applied for resolving any dependency of this configuration.

extendsFrom

The names of the configurations which this configuration extends from. The artifacts of the super configurations are also available in this configuration.

hierarchy

Gets an ordered set including this configuration and all superconfigurations recursively.

incoming

Returns a ResolvableDependencies instance, exposing the results of dependency resolution. This method is the primary way to consume dependency resolution outputs.

resolutionStrategy

The resolution strategy used by this configuration. The resolution strategy provides extra details on how to resolve this configuration. See docs for ResolutionStrategy for more info and examples.

resolvedConfiguration

Returns a ResolvedConfiguration, a legacy view of the results of dependency resolution. Avoid this method for new code. Prefer accessing resolution outputs via Configuration.getIncoming(). This API will be deprecated and removed in future Gradle versions.

state

The state of the configuration.

transitive

The transitivity of this configuration. A transitive configuration contains the transitive closure of its direct dependencies, and all their dependencies. An intransitive configuration contains only the direct dependencies. The default value is true.

visible

Returns true if this is a visible configuration. A visible configuration is usable outside the project it belongs to. The default value is true.

Methods

MethodDescription
copy()

Creates a copy of this configuration that only contains the dependencies directly in this configuration (without contributions from superconfigurations). The new configuration will be in the UNRESOLVED state, but will retain all other attributes of this configuration except superconfigurations. Configuration.getHierarchy() for the copy will not include any superconfigurations.

copy(dependencySpec)

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.copy(org.gradle.api.specs.Spec)

copy(dependencySpec)

Creates a copy of this configuration ignoring superconfigurations (see Configuration.copy() but filtering the dependencies using the specified dependency spec.

copyRecursive()

Creates a copy of this configuration that contains the dependencies directly in this configuration and those derived from superconfigurations. The new configuration will be in the UNRESOLVED state, but will retain all other attributes of this configuration except superconfigurations. Configuration.getHierarchy() for the copy will not include any superconfigurations.

copyRecursive(dependencySpec)

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.copyRecursive(org.gradle.api.specs.Spec)

copyRecursive(dependencySpec)

Creates a copy of this configuration with dependencies from superconfigurations (see Configuration.copyRecursive()) but filtering the dependencies using the dependencySpec.

defaultDependencies(action)

Execute the given action if the configuration has no defined dependencies when it first participates in dependency resolution. A Configuration will participate in dependency resolution when:

exclude(excludeProperties)

Adds an exclude rule to exclude transitive dependencies for all dependencies of this configuration. You can also add exclude rules per-dependency. See ModuleDependency.exclude(java.util.Map).

extendsFrom(superConfigs)

Adds the given configurations to the set of configuration which this configuration extends from.

fileCollection(dependencySpecClosure)
Deprecated

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.fileCollection(org.gradle.api.specs.Spec).

fileCollection(dependencies)
Deprecated

Resolves this configuration lazily. The resolve happens when the elements of the returned FileCollection get accessed the first time. This locates and downloads the files which make up this configuration. Only the resulting set of files belonging to specified dependencies is contained in the FileCollection.

fileCollection(dependencySpec)
Deprecated

Resolves this configuration lazily. The resolve happens when the elements of the returned FileCollection get accessed the first time. This locates and downloads the files which make up this configuration. Only the resulting set of files belonging to the subset of dependencies specified by the dependencySpec is contained in the FileCollection.

files(dependencySpecClosure)
Deprecated

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.files(org.gradle.api.specs.Spec).

files(dependencies)
Deprecated

Resolves this configuration. This locates and downloads the files which make up this configuration. But only the resulting set of files belonging to the specified dependencies is returned.

files(dependencySpec)
Deprecated

Resolves this configuration. This locates and downloads the files which make up this configuration. But only the resulting set of files belonging to the subset of dependencies specified by the dependencySpec is returned.

getTaskDependencyFromProjectDependency(useDependedOn, taskName)

Returns a TaskDependency object containing dependencies on all tasks with the specified name from project dependencies related to this configuration or one of its super configurations. These other projects may be projects this configuration depends on or projects with a similarly named configuration that depend on this one based on the useDependOn argument.

Script blocks

No script blocks

Property details

PublishArtifactSet allArtifacts (read-only)

The artifacts of this configuration including the artifacts of extended configurations.

DependencySet allDependencies (read-only)

Gets the complete set of declared dependencies including those contributed by superconfigurations.

This method does not resolve the configuration. Therefore, the return value does not include transitive dependencies.

PublishArtifactSet artifacts (read-only)

The artifacts of this configuration excluding the artifacts of extended configurations.

TaskDependency buildDependencies (read-only)

Returns a TaskDependency object containing all required dependencies to build the local dependencies (e.g. project dependencies) belonging to this configuration or to one of its super configurations.

DependencySet dependencies (read-only)

Gets the set of declared dependencies directly contained in this configuration (ignoring superconfigurations).

This method does not resolve the configuration. Therefore, the return value does not include transitive dependencies.

String description

The description for this configuration.

Set<ExcludeRule> excludeRules (read-only)

The exclude rules applied for resolving any dependency of this configuration.

Set<Configuration> extendsFrom

The names of the configurations which this configuration extends from. The artifacts of the super configurations are also available in this configuration.

Set<Configuration> hierarchy (read-only)

Gets an ordered set including this configuration and all superconfigurations recursively.

ResolvableDependencies incoming (read-only)

Returns a ResolvableDependencies instance, exposing the results of dependency resolution. This method is the primary way to consume dependency resolution outputs.

ResolutionStrategy resolutionStrategy (read-only)

The resolution strategy used by this configuration. The resolution strategy provides extra details on how to resolve this configuration. See docs for ResolutionStrategy for more info and examples.

ResolvedConfiguration resolvedConfiguration (read-only)

Returns a ResolvedConfiguration, a legacy view of the results of dependency resolution. Avoid this method for new code. Prefer accessing resolution outputs via Configuration.getIncoming(). This API will be deprecated and removed in future Gradle versions.

See ResolvedConfiguration for details on why this API should not be used.

State state (read-only)

The state of the configuration.

boolean transitive

The transitivity of this configuration. A transitive configuration contains the transitive closure of its direct dependencies, and all their dependencies. An intransitive configuration contains only the direct dependencies. The default value is true.

boolean visible

Returns true if this is a visible configuration. A visible configuration is usable outside the project it belongs to. The default value is true.

Method details

Creates a copy of this configuration that only contains the dependencies directly in this configuration (without contributions from superconfigurations). The new configuration will be in the UNRESOLVED state, but will retain all other attributes of this configuration except superconfigurations. Configuration.getHierarchy() for the copy will not include any superconfigurations.

This method is only intended for use for specific situations involving resolvable configuration, it is NOT intended as a general-purpose copying mechanism.

Configuration copy(Closure dependencySpec)

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.copy(org.gradle.api.specs.Spec)

This method is only intended for use for specific situations involving resolvable configuration, it is NOT intended as a general-purpose copying mechanism.

Configuration copy(Spec<? super Dependency> dependencySpec)

Creates a copy of this configuration ignoring superconfigurations (see Configuration.copy() but filtering the dependencies using the specified dependency spec.

This method is only intended for use for specific situations involving resolvable configuration, it is NOT intended as a general-purpose copying mechanism.

Configuration copyRecursive()

Creates a copy of this configuration that contains the dependencies directly in this configuration and those derived from superconfigurations. The new configuration will be in the UNRESOLVED state, but will retain all other attributes of this configuration except superconfigurations. Configuration.getHierarchy() for the copy will not include any superconfigurations.

This method is only intended for use for specific situations involving resolvable configuration, it is NOT intended as a general-purpose copying mechanism.

Configuration copyRecursive(Closure dependencySpec)

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.copyRecursive(org.gradle.api.specs.Spec)

This method is only intended for use for specific situations involving resolvable configuration, it is NOT intended as a general-purpose copying mechanism.

Configuration copyRecursive(Spec<? super Dependency> dependencySpec)

Creates a copy of this configuration with dependencies from superconfigurations (see Configuration.copyRecursive()) but filtering the dependencies using the dependencySpec.

This method is only intended for use for specific situations involving resolvable configuration, it is NOT intended as a general-purpose copying mechanism.

Configuration defaultDependencies(Action<? super DependencySet> action)

Execute the given action if the configuration has no defined dependencies when it first participates in dependency resolution. A Configuration will participate in dependency resolution when:

This method is useful for specifying default dependencies for a configuration:

configurations { conf }
configurations['conf'].defaultDependencies { dependencies ->
     dependencies.add(owner.project.dependencies.create("org.gradle:my-util:1.0"))
}

A Configuration is considered empty even if it extends another, non-empty Configuration.

If multiple actions are supplied, each action will be executed until the set of dependencies is no longer empty. Remaining actions will be ignored.

Configuration exclude(Map<String, String> excludeProperties)

Adds an exclude rule to exclude transitive dependencies for all dependencies of this configuration. You can also add exclude rules per-dependency. See ModuleDependency.exclude(java.util.Map).

Configuration extendsFrom(Configuration... superConfigs)

Adds the given configurations to the set of configuration which this configuration extends from.

Configurations are only allowed to extend from other configurations in the same project.

FileCollection fileCollection(Closure dependencySpecClosure)

Note: This method is deprecated and will be removed in the next major version of Gradle.

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.fileCollection(org.gradle.api.specs.Spec).

FileCollection fileCollection(Dependency... dependencies)

Note: This method is deprecated and will be removed in the next major version of Gradle.

Resolves this configuration lazily. The resolve happens when the elements of the returned FileCollection get accessed the first time. This locates and downloads the files which make up this configuration. Only the resulting set of files belonging to specified dependencies is contained in the FileCollection.

FileCollection fileCollection(Spec<? super Dependency> dependencySpec)

Note: This method is deprecated and will be removed in the next major version of Gradle.

Resolves this configuration lazily. The resolve happens when the elements of the returned FileCollection get accessed the first time. This locates and downloads the files which make up this configuration. Only the resulting set of files belonging to the subset of dependencies specified by the dependencySpec is contained in the FileCollection.

Set<File> files(Closure dependencySpecClosure)

Note: This method is deprecated and will be removed in the next major version of Gradle.

Takes a closure which gets coerced into a Spec. Behaves otherwise in the same way as Configuration.files(org.gradle.api.specs.Spec).

Set<File> files(Dependency... dependencies)

Note: This method is deprecated and will be removed in the next major version of Gradle.

Resolves this configuration. This locates and downloads the files which make up this configuration. But only the resulting set of files belonging to the specified dependencies is returned.

Set<File> files(Spec<? super Dependency> dependencySpec)

Note: This method is deprecated and will be removed in the next major version of Gradle.

Resolves this configuration. This locates and downloads the files which make up this configuration. But only the resulting set of files belonging to the subset of dependencies specified by the dependencySpec is returned.

TaskDependency getTaskDependencyFromProjectDependency(boolean useDependedOn, String taskName)

Returns a TaskDependency object containing dependencies on all tasks with the specified name from project dependencies related to this configuration or one of its super configurations. These other projects may be projects this configuration depends on or projects with a similarly named configuration that depend on this one based on the useDependOn argument.