KiteConfig/io.github.yuroyami.kiteconfig/CleanupLegacyAppLogoArtifactsTask

CleanupLegacyAppLogoArtifactsTask

@DisableCachingByDefault(because = "One-shot source migration with backups and provenance side effects.")

abstract class CleanupLegacyAppLogoArtifactsTask : DefaultTask

One-shot migration helper: removes app-logo files that would otherwise sit as orphans or actively break the resource merge after adopting the FG+BG pipeline.

Files migrated (only when present):

${androidResDir}/drawable/ic_launcher.xml: pre-FG/BG generated artifact.
${androidResDir}/values/ic_launcher_background.xml: pre-FG/BG artifact.
template launcher icons under each mipmap-<density> dir (typically ic_launcher.webp from the Android Studio wizard) that collide with the generated .png of the same stem and fail AAPT2's merge.
on first contact only, any existing file at a path the current installer will claim, including Android Studio's adaptive-icon XML wrappers and same-name PNGs. Once an ownership manifest exists, current managed outputs are preserved and only the sync task may validate or replace them.

This task never assumes a familiar filename implies plugin ownership. Every candidate is copied to a checksummed durable .kiteconfig/recovery backup and recorded in a provenance manifest before the original is removed. Honors dryRun (lists what it would migrate, writes/removes nothing).

Safety rails on every source-writing task

Rail	Behaviour
Explicit only	never runs as part of an ordinary build; you invoke it by name
Authorized	the matching DSL block must be configured, or the task is skipped
`-Pkiteconfig.dryRun=true`	reports what it would write and remove, changes nothing
`-Pkiteconfig.backups=true`	keeps a recovery copy before replacing anything (default)
Ownership	refuses to overwrite or delete a file it does not own
Atomic	staged then swapped, so an interrupted run leaves the tree intact

Both -P switches accept exactly true or false; anything else fails the build rather than being read as false.

Constructors

CleanupLegacyAppLogoArtifactsTask

constructor()

Properties

@get:Internal

abstract val androidResDir: DirectoryProperty

@get:Internal

abstract val backupDir: DirectoryProperty

var description: @Nullable String

@get:Internal

abstract val dryRun: Property<Boolean>

@get:Internal

var enabled: Boolean

var group: @Nullable String

hasCustomActions

val hasCustomActions: Boolean

impliesSubProjects

var impliesSubProjects: Boolean

outputSinkApproved

@get:Internal

abstract val outputSinkApproved: Property<Boolean>

False when no Android application module was selected or detected.

@get:Internal

abstract val projectRootDir: DirectoryProperty

val state: TaskStateInternal

val timeout: Property<Duration>

Functions

acceptServiceReferences

open override fun acceptServiceReferences(serviceReferences: MutableSet<ServiceReferenceSpec>)

appendParallelSafeAction

open override fun appendParallelSafeAction(action: Action<in Task>)

open operator override fun compareTo(other: Task): Int

open override fun configure(closure: Closure<Any>): Task

open override fun dependsOn(vararg paths: Any): Task

open override fun doFirst(action: Closure<Any>): Task

open override fun doFirst(action: Action<in Task>): Task

open override fun doFirst(actionName: String, action: Action<in Task>): Task

open override fun doLast(action: Closure<Any>): Task

open override fun doLast(action: Action<in Task>): Task

open override fun doLast(actionName: String, action: Action<in Task>): Task

doNotTrackState

open override fun doNotTrackState(reasonNotToTrackState: String)

doNotTrackStateIf

open override fun doNotTrackStateIf(reason: String, spec: Spec<in TaskInternal>)

open override fun finalizedBy(vararg paths: Any): Task

open override fun getActions(): MutableList<Action<in Task>>

open override fun getAnt(): AntBuilder

getAsDynamicObject

@Internal

open override fun getAsDynamicObject(): DynamicObject

open override fun getDependsOn(): MutableSet<Any>

getDestroyables

open override fun getDestroyables(): TaskDestroyables

open override fun getDidWork(): Boolean

open override fun getExtensions(): ExtensionContainer

open override fun getFinalizedBy(): TaskDependency

getIdentityPath

open override fun getIdentityPath(): Path

open override fun getInputs(): TaskInputsInternal

getLifecycleDependencies

@Internal

open override fun getLifecycleDependencies(): TaskDependencyInternal

open override fun getLocalState(): TaskLocalState

open override fun getLogger(): Logger

open override fun getLogging(): LoggingManager

getMustRunAfter

open override fun getMustRunAfter(): TaskDependency

open override fun getName(): String

open override fun getOnlyIf(): Spec<in TaskInternal>

open override fun getOutputs(): TaskOutputsInternal

open override fun getPath(): String

open override fun getProject(): Project

getReasonNotToTrackState

open override fun getReasonNotToTrackState(): Optional<String>

getReasonsNotToTrackState

open override fun getReasonsNotToTrackState(): MutableSet<String>

getReasonTaskIsIncompatibleWithConfigurationCache

open override fun getReasonTaskIsIncompatibleWithConfigurationCache(): Optional<String>

getRequiredServices

open override fun getRequiredServices(): TaskRequiredServices

getSharedResources

open override fun getSharedResources(): MutableList<ResourceLock>

getShouldRunAfter

open override fun getShouldRunAfter(): TaskDependency

getStandardOutputCapture

open override fun getStandardOutputCapture(): StandardOutputCapture

open override fun getTaskActions(): MutableList<InputChangesAwareTaskAction>

getTaskDependencies

open override fun getTaskDependencies(): TaskDependencyInternal

getTaskIdentity

open override fun getTaskIdentity(): TaskIdentity<*>

getTemporaryDir

open override fun getTemporaryDir(): File

getTemporaryDirFactory

open override fun getTemporaryDirFactory(): Factory<File>

open override fun hasProperty(propertyName: String): Boolean

open override fun hasTaskActions(): Boolean

isCompatibleWithConfigurationCache

open override fun isCompatibleWithConfigurationCache(): Boolean

open override fun mustRunAfter(vararg paths: Any): Task

notCompatibleWithConfigurationCache

open override fun notCompatibleWithConfigurationCache(reason: String)

open override fun onlyIf(onlyIfClosure: Closure<Any>)

open override fun onlyIf(spec: Spec<in Task>)

open override fun onlyIf(onlyIfReason: String, spec: Spec<in Task>)

prependParallelSafeAction

open override fun prependParallelSafeAction(action: Action<in Task>)

open override fun property(propertyName: String): Any

open override fun restoreOnlyIf(onlyIf: Spec<in TaskInternal>)

restoreTaskActions

open override fun restoreTaskActions(taskActions: MutableList<InputChangesAwareTaskAction>)

open override fun setActions(replacements: MutableList<Action<in Task>>)

open override fun setDependsOn(dependsOn: MutableIterable<*>)

open override fun setDidWork(didWork: Boolean)

open override fun setFinalizedBy(finalizedByTasks: MutableIterable<*>)

setMustRunAfter

open override fun setMustRunAfter(mustRunAfterTasks: MutableIterable<*>)

open override fun setOnlyIf(onlyIfClosure: Closure<Any>)

open override fun setOnlyIf(spec: Spec<in Task>)

open override fun setOnlyIf(onlyIfReason: String, spec: Spec<in Task>)

open override fun setProperty(name: String, value: Any)

setShouldRunAfter

open override fun setShouldRunAfter(shouldRunAfterTasks: MutableIterable<*>)

open override fun shouldRunAfter(vararg paths: Any): TaskDependency

open override fun usesService(service: Provider<out BuildService<*>>)