KiteConfig/io.github.yuroyami.kiteconfig/SyncAndroidLogoTask

SyncAndroidLogoTask

@DisableCachingByDefault(because = "Installs and validates files in a user-owned Android resource tree.")

abstract class SyncAndroidLogoTask : DefaultTask

Propagates the FG/BG layer PNGs to a complete Android launcher-icon resource tree. Source PNGs are treated as the icon as designed (fills the canvas like an iOS marketing icon). Non-square sources are aspect-fit, never stretched: the FG is contained (letterboxed) inside the safe zone, the BG covers the canvas (center-cropped).

Adaptive FG: source FG fit inside safeZoneRatio of the canvas.
Adaptive BG: source BG covers the 108dp canvas (parallax bleed).
Legacy fallback: BG cover + FG contain, at the legacy launcher size.

This is an installer into a user-owned Android source tree, so it is deliberately non-cacheable and always performs its validation. A checksum ownership manifest prevents overwriting or deleting user-authored files at generated paths.

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

SyncAndroidLogoTask

constructor()

Types

object Companion

Properties

@get:Internal

abstract val androidResDir: DirectoryProperty

backgroundColorHex

@get:Input

@get:Optional

abstract val backgroundColorHex: Property<String>

@get:Internal

abstract val backgroundPng: RegularFileProperty

@get:Internal

abstract val backupDir: DirectoryProperty

cleanupLegacyArtifacts

@get:Input

abstract val cleanupLegacyArtifacts: Property<Boolean>

var description: @Nullable String

@get:Internal

abstract val dryRun: Property<Boolean>

@get:Input

abstract val emitMonochrome: Property<Boolean>

@get:Internal

var enabled: Boolean

@get:Internal

abstract val foregroundPng: RegularFileProperty

Validated explicitly so configured-but-missing files receive actionable plugin diagnostics.

var group: @Nullable String

hasCustomActions

val hasCustomActions: Boolean

impliesSubProjects

var impliesSubProjects: Boolean

@get:Internal

abstract val outputFiles: ConfigurableFileCollection

Compatibility surface for diagnostics/wiring; source-tree files are not Gradle task outputs.

outputSinkApproved

@get:Internal

abstract val outputSinkApproved: Property<Boolean>

False when no Android application module was selected or detected.

@get:Internal

abstract val projectRootDir: DirectoryProperty

@get:Input

abstract val safeZoneRatio: Property<Double>

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

fun sync()

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