UntrackedTask (Gradle API 8.11)

Package org.gradle.api.tasks

## Annotation Type UntrackedTask

-     @Documented
      @Retention(RUNTIME)
      @Target(TYPE)
      public @interface UntrackedTask

  Attached to a task to declare that the task should be untracked.

  If a task is untracked, then Gradle will not try to capture its state. That also means that Gradle does not do any optimizations for running the task. For example, such a task will always be out of date and never stored in or loaded from the build cache.

  There can be different reasons for declaring a task as untracked, for example:

  - Some input or output locations contain unreadable files like pipes where Gradle cannot track the content.
  - The input or output is stored remotely, for example in a database, and its state cannot be tracked.
  - Another tool like Git already takes care of keeping the state, so it doesn't make sense for Gradle to do additional bookkeeping.
  - Prevent Gradle from trying to snapshot a potentially large amount of content if an output location is not exclusively owned by the build.

  `InputChanges` cannot be used for untracked tasks, since incremental tasks need to track the state of their inputs and outputs for them to be correct.

  Since:
    7.3

- - ### Required Element Summary

    Required Elements
    Modifier and Type | Required Element | Description
    --- | --- | ---
    `java.lang.String` | `because` | Mandatory reason why the task is untracked.

- - ### Element Detail

    - #### because

          java.lang.String because

      Mandatory reason why the task is untracked.