Package org.gradle.api.artifacts

# Interface ArtifactCollection

All Superinterfaces:
  `Iterable<ResolvedArtifactResult>`

public interface ArtifactCollection extends Iterable<ResolvedArtifactResult>
A collection of artifacts resolved for a configuration. The configuration is resolved on demand when the collection is queried.

Since:
  3.4

- ## Method Summary

  Modifier and Type
  Method
  Description
  `FileCollection`
  `getArtifactFiles()`
  A file collection containing the files for all artifacts in this collection.
  `Set<ResolvedArtifactResult>`
  `getArtifacts()`
  Returns the resolved artifacts, performing the resolution if required.
  `Collection<Throwable>`
  `getFailures()`
  Returns any failures to resolve the artifacts for this collection.
  `Provider<Set<ResolvedArtifactResult>>`
  `getResolvedArtifacts()`
  Returns the resolved artifacts as a `Provider` of `ResolvedArtifactResult` instances.

  ### Methods inherited from interface java.lang.Iterable

  `forEach, iterator, spliterator`

- ## Method Details

  - ### getArtifactFiles

    FileCollection getArtifactFiles()
    A file collection containing the files for all artifacts in this collection. This is primarily useful to wire this artifact collection as a task input.

  - ### getArtifacts

    Set<ResolvedArtifactResult> getArtifacts()
    Returns the resolved artifacts, performing the resolution if required. This will resolve the artifact metadata and download the artifact files as required.
    Throws:
      `ResolveException` - On failure to resolve or download any artifact.

  - ### getResolvedArtifacts

    Provider<Set<ResolvedArtifactResult>> getResolvedArtifacts()
    Returns the resolved artifacts as a `Provider` of `ResolvedArtifactResult` instances. The returned `Provider` is live, and tracks the producer tasks of this artifact collection. The provider will resolve the artifact metadata and download the artifact files as required.
    Since:
      7.4

  - ### getFailures

    Collection<Throwable> getFailures()
    Returns any failures to resolve the artifacts for this collection.
    Returns:
      A collection of exceptions, one for each failure in resolution.
    Since:
      4.0