KiteConfig/io.github.yuroyami.kiteconfig/SyncIosLogoTask

SyncIosLogoTask

@DisableCachingByDefault(because = "Installs and validates files in a user-owned Xcode asset catalog.")

abstract class SyncIosLogoTask : DefaultTask

Composites the FG/BG layers into the iOS AppIcon.appiconset:

BG covers the 1024² canvas, FG contains (aspect-preserving) on top.
Flattened to opaque RGB: App Store marketing icons MUST NOT have alpha, so any FG/BG transparency is composited against white.
Writes AppIcon-1024.png + a single-image universal Contents.json.

Requires Xcode 14+ and an iOS deployment target of at least 12.0 (validated by the root model). This is deliberately non-cacheable because it installs into a user-owned Xcode asset catalog and must execute configured recovery, ownership, orphan, and path-safety checks on every invocation.

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

SyncIosLogoTask

constructor()

Types

object Companion

Properties

@get:Internal

abstract val appiconsetDir: DirectoryProperty

backgroundColorHex

@get:Input

@get:Optional

abstract val backgroundColorHex: Property<String>

@get:Internal

abstract val backgroundPng: RegularFileProperty

@get:Internal

abstract val backup: Property<Boolean>

@get:Internal

abstract val backupDir: DirectoryProperty

var description: @Nullable String

@get:Internal

abstract val dryRun: 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.

@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

fun sync()

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