Package org.gradle.api.artifacts

Interface ResolvedConfiguration

public interface ResolvedConfiguration
A ResolvedConfiguration represents the result of resolving a Configuration, and provides access to both the graph and artifacts of the result.

This is a legacy API. Avoid this class for new code. Prefer accessing resolution outputs via Configuration.getIncoming(). This API will be deprecated and removed in future Gradle versions.

  • This class is not configuration-cache compatible.
  • Returned file sets do not track task dependencies.
  • The returned types do not reflect the variant-aware nature of the dependency resolution engine.

  • Method Details

    • hasError

      boolean hasError()
      Returns whether all dependencies were successfully retrieved or not.

    • getLenientConfiguration

      LenientConfiguration getLenientConfiguration()
      Provides configuration that does not fail eagerly when some dependencies are not resolved.

    • rethrowFailure

      void rethrowFailure() throws ResolveException
      A resolve of a configuration that is not successful does not automatically throws an exception. Such a exception is only thrown if the result of a resolve is accessed. You can force the throwing of such an exception by calling this method.

      This method does nothing when resolution was successful.

      Throws:
      ResolveException - when the resolve was not successful.

    • getFiles

      @Deprecated Set<File> getFiles() throws ResolveException
      Deprecated.
      Use ResolvableDependencies.getFiles() instead.
      Returns the files for the configuration dependencies.
      Returns:
      The artifact files of the specified dependencies.
      Throws:
      ResolveException - when the resolve was not successful.
      Since:
      3.3

    • getFiles

      @Deprecated Set<File> getFiles(Spec<? super Dependency> dependencySpec) throws ResolveException
      Deprecated.
      Use an ArtifactView with a componentFilter instead.
      Returns the files for the specified subset of configuration dependencies.
      Parameters:
      dependencySpec - The filter for the configuration dependencies.
      Returns:
      The artifact files of the specified dependencies.
      Throws:
      ResolveException - when the resolve was not successful.

    • getFirstLevelModuleDependencies

      Set<ResolvedDependency> getFirstLevelModuleDependencies() throws ResolveException
      Returns the ResolvedDependency instances for each direct dependency of the configuration. Via those you have access to all ResolvedDependency instances, including the transitive dependencies of the configuration.

      Prefer ResolutionResult for traversing the resolved graph or ResolvableDependencies.getArtifacts() for accessing the resolved artifacts.

      Returns:
      A ResolvedDependency instance for each direct dependency.
      Throws:
      ResolveException - when the resolve was not successful.

    • getFirstLevelModuleDependencies

      @Deprecated Set<ResolvedDependency> getFirstLevelModuleDependencies(Spec<? super Dependency> dependencySpec) throws ResolveException
      Deprecated.
      Use getFirstLevelModuleDependencies().
      Returns the ResolvedDependency instances for each direct dependency of the configuration that matches the given spec. Via those you have access to all ResolvedDependency instances, including the transitive dependencies of the configuration.
      Parameters:
      dependencySpec - A filter for the dependencies to be resolved.
      Returns:
      A ResolvedDependency instance for each direct dependency.
      Throws:
      ResolveException - when the resolve was not successful.

    • getResolvedArtifacts

      Set<ResolvedArtifact> getResolvedArtifacts() throws ResolveException
      Returns the set of artifact meta-data for this configuration.

      Prefer ResolvableDependencies.getArtifacts().

      Returns:
      The set of artifacts.
      Throws:
      ResolveException - when the resolve was not successful.