# ArtifactTransformationRequest

# ArtifactTransformationRequest

<br />

```
public interface ArtifactTransformationRequest<TaskT extends Task>
```

<br />

*** ** * ** ***

When a[Directory](https://docs.gradle.org/current/javadoc/org/gradle/api/file/Directory.html)contains more than one artifact (for example, consider[SingleArtifact.APK](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/SingleArtifact.APK)with multiple APKs for different screen densities), this object will abstract away having to deal with[BuiltArtifacts](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifacts)and manually load and write the metadata files.

Instead, users can focus on writing transformation code that transform one file at at time into a newer version. It will also provide the ability to use Gradle's[WorkQueue](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkQueue.html)to multi-thread the transformations.

Here is an example of a[Task](https://docs.gradle.org/current/javadoc/org/gradle/api/Task.html)copying (unchanged) the APK files from one location to another.  

```scalate-server-page
// parameter interface to pass to work items.
interface WorkItemParameters: WorkParameters, Serializable {
   val inputApkFile: RegularFileProperty
   val outputApkFile: RegularFileProperty
}
```  

```scalate-server-page
// work item that copies one file at a time.
abstract class WorkItem @Inject constructor(
     private val workItemParameters: WorkItemParameters
): WorkAction<WorkItemParameters> {

   override fun execute() {
     workItemParameters.inputApkFile.asFile.get().copyTo(
     workItemParameters.outputApkFile.get().asFile)
   }
}
```

And the task that wires things together:  

```scalate-server-page
abstract class CopyApksTask @Inject constructor(private val workers: WorkerExecutor): DefaultTask() {

@get:InputFiles
abstract val apkFolder: DirectoryProperty

@get:OutputDirectory
abstract val outFolder: DirectoryProperty

@get:Internal
abstract val transformationRequest: Property<ArtifactTransformationRequest<CopyApksTask>>

@TaskAction
fun taskAction() {
 transformationRequest.get().submit(
    this,
    workers.noIsolation(),
    WorkItem::class.java) {
    builtArtifact: BuiltArtifact,
    outputLocation: Directory,
    param: WorkItemParameters ->
      val inputFile = File(builtArtifact.outputFile)
      param.inputApkFile.set(inputFile)
      param.outputApkFile.set(File(outputLocation.asFile, inputFile.name))
      param.outputApkFile.get().asFile
    }
  }
}
```

## Summary

|                                                                                                                                                                                                                                 ### Public methods                                                                                                                                                                                                                                 |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `abstract void`                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | [submit](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/ArtifactTransformationRequest#submit(org.gradle.api.Task,kotlin.Function1))`(` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` TaskT task,` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function1<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact)`, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[File](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html)`> transformer` `)` Submit a lambda to process each input[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact)object synchronously.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `abstract @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Supplier](https://developer.android.com/reference/tools/gradle-api/8.3/null/java/util/function/Supplier)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[BuiltArtifacts](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifacts)`>` | `<ParamT extends `[WorkParameters](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkParameters.html)`> `[submit](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/artifact/ArtifactTransformationRequest#submit(org.gradle.api.Task,org.gradle.workers.WorkQueue,java.lang.Class,kotlin.Function3))`(` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` TaskT task,` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[WorkQueue](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkQueue.html)` workQueue,` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Class](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Class.html)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[WorkAction](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkAction.html)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` ParamT>> actionType,` ` @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function3<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact)`, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Directory](https://docs.gradle.org/current/javadoc/org/gradle/api/file/Directory.html)`, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` parameters, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[File](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html)`> parameterConfigurator` `)` Submit a`org.gradle.workers`style of[WorkAction](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkAction.html)to process each input[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact). |

## Public methods

### submit

```
abstract void submit(
    @NonNull TaskT task,
    @NonNull Function1<@NonNull BuiltArtifact, @NonNull File> transformer
)
```

Submit a lambda to process each input[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact)object synchronously.  

### submit

```
abstract @NonNull Supplier<@NonNull BuiltArtifacts> <ParamT extends WorkParameters> submit(
    @NonNull TaskT task,
    @NonNull WorkQueue workQueue,
    @NonNull Class<@NonNull WorkAction<@NonNull ParamT>> actionType,
    @NonNull Function3<@NonNull BuiltArtifact, @NonNull Directory, @NonNull parameters, @NonNull File> parameterConfigurator
)
```

Submit a`org.gradle.workers`style of[WorkAction](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkAction.html)to process each input[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact).  

|                                                                                                                                                                                                                                                                                                                                                                                                                                                            Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` TaskT task`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The Task initiating the[WorkQueue](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkQueue.html)requests.                                                                                                                                                 |
| `@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[WorkQueue](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkQueue.html)` workQueue`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | The Gradle[WorkQueue](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkQueue.html)instance to use to spawn worker items with.                                                                                                                            |
| `@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Class](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Class.html)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[WorkAction](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkAction.html)`<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` ParamT>> actionType`                                                                                                                                                                                                                                                                                                                                                                                | The type of the[WorkAction](https://docs.gradle.org/current/javadoc/org/gradle/workers/WorkAction.html)subclass that process that input[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact). |
| `@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` Function3<@`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact)`, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[Directory](https://docs.gradle.org/current/javadoc/org/gradle/api/file/Directory.html)`, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` parameters, @`[NonNull](https://developer.android.com/reference/tools/gradle-api/8.3/null/androidx/annotation/NonNull)` `[File](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html)`> parameterConfigurator` | The lambda to configure instances of parameterType for each[BuiltArtifact](https://developer.android.com/reference/tools/gradle-api/8.3/null/com/android/build/api/variant/BuiltArtifact).                                                                             |