settings.gradle.kts

@file:Suppress("SpellCheckingInspection")

// @Hint by SuperMonster003 on May 3, 2023.
//  ! To download archives of Android Studio,
//  ! visit https://developer.android.com/studio/archive?hl=en.
//  ! zh-CN:
//  ! 下载 Android Studio 档案,
//  ! 可访问 https://developer.android.com/studio/archive?hl=en.
//  !
//  ! To check the releases for AGP (Android Gradle Plugin),
//  ! visit https://developer.android.com/reference/tools/gradle-api.
//  ! zh-CN:
//  ! 查看 AGP (Android Gradle Plugin) 发行版本,
//  ! 可访问 https://developer.android.com/reference/tools/gradle-api.
//  !
//  ! To check the compatibility and released date of kotlin plugins,
//  ! visit https://plugins.jetbrains.com/plugin/6954-kotlin/versions/eap.
//  ! zh-CN:
//  ! 查看 kotlin 插件的兼容性及其发行版本,
//  ! 可访问 https://plugins.jetbrains.com/plugin/6954-kotlin/versions/eap.
//  !
//  ! To check the releases for KSP (Kotlin Symbol Processing) plugin,
//  ! visit https://github.com/google/ksp/releases.
//  ! zh-CN:
//  ! 查看 KSP (Kotlin Symbol Processing) 插件的发行版本,
//  ! 可访问 https://github.com/google/ksp/releases.

private val modules = listOf(
    "jieba-analysis",
    "apk-signer",
    "color-picker",
)

private val libs = listOf(
    "android-job-simplified-1.4.3",
    "androidx.appcompat-1.0.2",
    "apk-parser-1.0.2",
    "com.tencent.bugly.crashreport-4.0.4",
    "org.opencv-4.8.0",
    "paddleocr",
    "rapidocr",

    "jackpal.androidterm-1.0.70",
    "jackpal.androidterm.emulatorview-1.0.42",
    "jackpal.androidterm.libtermexec-1.0",

    "android-spackle-9.0.0",
    "android-assertion-9.0.0",
    "android-plugin-client-sdk-for-locale-9.0.0",

    "markwon-core-4.6.2",
    "markwon-syntax-highlight-4.6.2",
)

include(
    ":app",
    *modules.map { ":modules:$it" }.toTypedArray(),
    *libs.map { ":libs:$it" }.toTypedArray(),
)

modules.forEach {
    project(":modules:$it").projectDir = File("modules", it)
}

pluginManagement {

    val consts = object {
        val IDENTIFIER_FALLBACK = "fallback"
        val IDENTIFIER_UNKNOWN = "unknown"
        val DEFAULT_VERSION = "0"
    }

    val systemProperties = object {
        val version: String? = System.getProperty("idea.version")
        val platform: String? = System.getProperty("idea.paths.selector")
            ?: System.getProperty("idea.platform.prefix")
            ?: System.getProperty("java.vendor.version")
        val vendorName: String? = System.getProperty("idea.vendor.name")
            ?: System.getProperty("java.vendor")
            ?: System.getProperty("java.vm.vendor")
        val concerns: List<String> by lazy {
            val concernedKeyWords = setOf("name", "vendor", "version", "platform", "paths", "os")
            val unconcernedKeyWords = setOf("url", "user", "runtime", "specification", "date")
            val unconcernedKeys = setOf(
                "java.class.version",
                "java.vm.name",
                "java.vm.version",
                "java.version",
                "platform.random.idempotence.check.rate",
                "sun.os.patch.level",
            )
            System.getProperties().filterKeys { key ->
                return@filterKeys key is String
                        && key !in unconcernedKeys
                        && key.split(Regex("\\W")).any { it in concernedKeyWords }
                        && key.split(Regex("\\W")).none { it in unconcernedKeyWords }
            }.map { (key, value) -> "[ $key: $value ]" }
        }
        var isConcernsAlreadyPrinted = false
    }

    data class Classpath(val id: String, val version: String)

    data class Plugin(val id: String, val version: String, val isApply: Boolean = false)

    class Formatted(title: String, private val contents: Collection<String> = emptyList(), subtitle: String? = null) {
        private val formattedOutput = run {
            val elements = mutableListOf<String>()
            subtitle?.let { elements.add(it) }
            elements.addAll(contents)
            val maxLength = elements.plus(title).maxOf { it.length }

            listOfNotNull(
                "=".repeat(maxLength),
                title,
                subtitle,
                "-".repeat(maxLength).takeUnless { contents.isEmpty() },
                *contents.toTypedArray(),
                "=".repeat(maxLength),
                "",
            )
        }

        fun print(contentsMatters: Boolean = false) = formattedOutput.forEach { if (!contentsMatters || contents.isNotEmpty()) println(it) }

        fun throwException(): Unit = throw Exception(formattedOutput.joinToString("\n"))
    }

    val config = object {

        /* Print concerned info by `System.getProperties()`. */
        val isShowConcernedSystemProperties = true

        /* https://docs.gradle.org/current/userguide/compatibility.html . */
        val isJavaVersionCoercedByGradleVersion = true

        val isCleanupPaddleOcr = false
        val isCleanupRapidOcr = false

        val fallbackGradleVersion = "8.0.2"
        val fallbackKotlinVersion = "1.9.22"
        val recommendedMinGradleVersion = "8.5.2"
        val recommendedMinKotlinVersion = "1.9.24"

        @Suppress("unused")
        val platforms = object {

            val androidStudio = object : Platform(
                name = "AndroidStudio", vendor = "Google",
                androidVersionMap = mapOf(
                    "2025.1" to "8.10.0-rc02", /* Apr 11, 2025. */
                    "2024.3" to "8.9.1", /* Apr 11, 2025. */
                    "2024.2" to "8.8.0", /* Jan 13, 2025. */
                    "2024.1" to "8.6.0", /* Aug 30, 2024. */
                    "2023.3" to "8.5.0-alpha02", /* Mar 28, 2024. */
                    "2023.2" to "8.3.0-rc02", /* Feb 14, 2024. */
                    "2023.1" to "8.2.2", /* Feb 6, 2024. */
                    "2022.3" to "8.1.4", /* Mar 31, 2024. */
                    "2022.2" to "8.0.2", /* May 26, 2023. */
                    "2022.1" to "7.4.2", /* Mar 25, 2023. */
                    consts.IDENTIFIER_FALLBACK to fallbackGradleVersion,
                ),
                kotlinVersionMap = mapOf(
                    "2025.1" to "2.1.20", /* Apr 11, 2025. */
                    "2024.3" to "2.1.20", /* Apr 11, 2024. */
                    "2024.2" to "2.1.0", /* Nov 29, 2024. */
                    "2024.1" to "2.0.0", /* Aug 13, 2024. */
                    consts.IDENTIFIER_FALLBACK to fallbackKotlinVersion,
                ),
                codenameVersionMap = mapOf(
                    "2025.1" to "N", /* Apr 11, 2025. */
                    "2024.3" to "M", /* Nov 29, 2024. */
                    "2024.2" to "L", /* Aug 13, 2024. */
                    "2024.1" to "K|L", /* May 14, 2024. */
                    "2023.3" to "J|K", /* Jan 21, 2024. */
                    "2023.2" to "I", /* Aug 25, 2023. */
                    "2023.1" to "H", /* May 13, 2023. */
                    "2022.3" to "G", /* May 3, 2023. */
                    "2022.2" to "F", /* May 3, 2023. */
                    "2022.1" to "E", /* May 3, 2023. */
                ),
                codenameMap = mapOf(
                    "N" to "Narwhal", /* Born on Mar 19, 2025. */
                    "M" to "Meerkat", /* Born on Nov 12, 2024. */
                    "L" to "Ladybug", /* Born on Jul 15, 2024. */
                    "K" to "Koala", /* Born on Mar 19, 2024. */
                    "J" to "Jellyfish", /* Born on Dec 28, 2023. */
                    "I" to "Iguana", /* Born on Aug 25, 2023. */
                    "H" to "Hedgehog", /* Born on Apr 25, 2023. */
                    "G" to "Giraffe", /* Born on Jan 17, 2023. */
                    "F" to "Flamingo", /* Born on Sep 20, 2022. */
                    "E" to "Electric Eel", /* Born on May 11, 2022. */
                    "D" to "Dolphin", /* Born on Jan 31, 2022. */
                    "C" to "Chipmunk", /* Born on Oct 13, 2021. */
                    "B" to "Bumblebee", /* Born on May 18, 2021. */
                    "A" to "Arctic Fox", /* Born on Jan 26, 2021. */

                    /* Codenames below were predicted on Oct 18, 2023. */

                    "O" to "Ostrich", "P" to "Penguin", "Q" to "Quail",
                    "R" to "Rhino", "S" to "Snail", "T" to "Tiger",
                    "U" to "Unicorn", "V" to "Vicuna", "W" to "Walrus",
                    "X" to "Xiphias", "Y" to "Yeti", "Z" to "Zebra",
                ),
            ) {
                override val weight = Int.MAX_VALUE
                override val gradleSettingsName = "Gradle JDK"
                override val fullName by lazy {
                    val suffix = codenameVersionMap?.get(version)
                        ?.split("|")
                        ?.joinToString(" / ", prefix = " ") { key ->
                            codenameMap?.get(key.trim()) ?: key
                        } ?: ""
                    return@lazy "Android Studio$suffix"
                }
            }

            val intelliJIdea = object : Platform(
                name = "IntelliJIdea", vendor = "Jetbrains",
                androidVersionMap = mapOf(
                    "2025.1" to "8.9.1", /* Apr 12, 2025. */
                    "2024.3.1" to "8.7.3", /* Dec 10, 2024. */
                    "2024.3" to "8.7.0-rc01", /* Nov 15, 2024. */
                    "2024.2" to "8.5.2", /* Aug 13, 2024. */
                    "2024.1" to "8.2.2", /* Apr 6, 2024. */
                    "2023.3" to "8.2.2", /* Jan 19, 2024. */
                    "2023.1" to "7.4.2", /* May 26, 2023. */
                    "2022.3" to "7.4.0-beta02", /* Mar 25, 2023. */
                    consts.IDENTIFIER_FALLBACK to fallbackGradleVersion,
                ),
                kotlinVersionMap = mapOf(
                    "2025.1" to "2.1.20", /* Apr 12, 2025. */
                    "2024.3.4" to "2.1.10", /* Feb 28, 2025. */
                    "2024.2.3" to "2.0.21", /* Oct 17, 2024. */
                    "2024.2" to "2.0.21-RC", /* Sep 27, 2024. */
                    "2024.1" to "1.9.24", /* Dec 3, 2024. */
                    "2023.3" to "1.9.23", /* Mar 29, 2024. */
                    consts.IDENTIFIER_FALLBACK to fallbackKotlinVersion,
                ),
            ) {
                override val weight = 10
                override val gradleSettingsName = "Gradle JVM"
                override val fullName = "IntelliJ IDEA"
            }

            val temurin = object : Platform(
                name = "Temurin", vendor = "temurin",  /* More common as "Eclipse Adoptium". */
                androidVersionMap = mapOf(
                    "21.0.6+7" to "8.7.3", /* Apr 16, 2025. */
                    "20.0.2+9" to "8.2.2", /* Dec 2, 2024. */
                    consts.IDENTIFIER_FALLBACK to recommendedMinGradleVersion,
                ),
                kotlinVersionMap = mapOf(
                    "21.0.6+7" to "2.1.10", /* Apr 16, 2025. */
                    "20.0.2+9" to "1.9.24", /* Dec 2, 2024. */
                    consts.IDENTIFIER_FALLBACK to recommendedMinKotlinVersion,
                ),
            ) {
                override val weight = 5
                override val shouldPrintProgress = false
            }

            val unknown = object : Platform(
                name = "Unknown", vendor = consts.IDENTIFIER_UNKNOWN,
                androidVersionMap = mapOf(
                    consts.IDENTIFIER_FALLBACK to recommendedMinGradleVersion,
                ),
                kotlinVersionMap = mapOf(
                    consts.IDENTIFIER_FALLBACK to recommendedMinKotlinVersion,
                ),
            ) {
                fun declare() = systemProperties.platform?.let {
                    println("Unexpected platform: $it")
                } ?: Formatted(
                    "Current platform is unknown",
                    systemProperties.concerns,
                    "However, here are some props may be useful for determining platform info",
                ).print().also { systemProperties.isConcernsAlreadyPrinted = true }
            }

            fun determine(): Platform {
                val candidates = this::class.java.declaredFields.mapNotNull { field ->
                    field.get(this)?.let { tmpPlatform ->
                        tmpPlatform::class.java.methods.find { method ->
                            method.name == Platform::matchEnvironment.name && method.invoke(tmpPlatform) == true
                        }?.let { tmpPlatform as? Platform }
                    }
                }
                return when {
                    candidates.isEmpty() -> when (val osName = System.getProperty("os.name")) {
                        is String -> unknown.also { it.name = osName }
                        else -> unknown.also { it.declare() }
                    }
                    candidates.size > 1 -> candidates.maxBy { it.weight }
                    else -> candidates.first()
                }.also {
                    it.version = systemProperties.version ?: when {
                        it != unknown && systemProperties.platform != null -> {
                            systemProperties.platform.substring(it.name.length)
                                .replace(Regex("^\\W*"), "")
                                .replace(Regex("^Preview", RegexOption.IGNORE_CASE), "")
                        }
                        else -> consts.DEFAULT_VERSION
                    }
                }
            }

        }

        /* Change "version" argument to specify a version, e.g. "8.3.0-beta02". */
        val libs = listOf(
            Classpath(id = "com.android.tools.build:gradle", version = "auto:android"),
            Classpath(id = "org.jetbrains.kotlin:kotlin-gradle-plugin", version = "auto:kotlin"),
            Plugin(id = "com.google.devtools.ksp", version = "auto:ksp"),
        )

        val kspVersionMap = mapOf(
            "2.1.20" to "2.0.0", /* Apr 9, 2025. */
            "2.1.20-RC3" to "1.0.31", /* Mar 15, 2025. */
            "2.1.20-RC2" to "1.0.31", /* Mar 7, 2025. */
            "2.1.20-RC" to "1.0.31", /* Feb 28, 2025. */
            "2.1.20-Beta2" to "1.0.30", /* Feb 15, 2025. */
            "2.1.20-Beta1" to "1.0.29", /* Dec 25, 2024. */
            "2.1.10" to "1.0.31", /* Feb 28, 2025. */
            "2.1.10-RC" to "1.0.29", /* Jan 10, 2025. */
            "2.1.0" to "1.0.29", /* Nov 28, 2024. */
            "2.1.0-RC2" to "1.0.29", /* Jan 22, 2025. */
            "2.1.0-RC" to "1.0.27", /* Nov 8, 2024. */
            "2.1.0-Beta2" to "1.0.26", /* Oct 26, 2024. */
            "2.1.0-Beta1" to "1.0.25", /* Sep 25, 2024. */
            "2.0.21" to "1.0.28", /* Nov 16, 2024. */
            "2.0.21-RC" to "1.0.25", /* Oct 4, 2024. */
            "2.0.20" to "1.0.25", /* Sep 7, 2024. */
            "2.0.20-RC2" to "1.0.24", /* Aug 24, 2024. */
            "2.0.20-RC" to "1.0.24", /* Aug 8, 2024. */
            "2.0.20-Beta2" to "1.0.23", /* Aug 8, 2024. */
            "2.0.20-Beta1" to "1.0.22", /* Aug 8, 2024. */
            "2.0.10" to "1.0.24", /* Aug 8, 2024. */
            "2.0.10-RC2" to "1.0.24", /* Aug 8, 2024. */
            "2.0.10-RC" to "1.0.23", /* Aug 8, 2024. */
            "2.0.0" to "1.0.24", /* Aug 8, 2024. */
            "2.0.0-RC3" to "1.0.20", /* May 24, 2024. */
            "2.0.0-RC2" to "1.0.20", /* May 24, 2024. */
            "2.0.0-RC1" to "1.0.20", /* May 24, 2024. */
            "2.0.0-Beta5" to "1.0.20", /* May 24, 2024. */
            "2.0.0-Beta4" to "1.0.19", /* May 24, 2024. */
            "2.0.0-Beta3" to "1.0.17", /* May 24, 2024. */
            "2.0.0-Beta2" to "1.0.16", /* May 24, 2024. */
            "2.0.0-Beta1" to "1.0.15", /* May 24, 2024. */
            "1.9.25" to "1.0.20", /* Aug 8, 2024. */
            "1.9.24" to "1.0.20", /* May 14, 2024. */
            "1.9.23" to "1.0.20", /* Apr 6, 2024. */
            "1.9.22" to "1.0.17", /* Jan 20, 2024. */
            "1.9.21" to "1.0.15", /* Dec 2, 2023. */
            "1.9.20" to "1.0.14", /* Nov 9, 2023. */
            "1.9.20-RC2" to "1.0.13", /* Oct 26, 2023. */
            "1.9.20-RC" to "1.0.13", /* Oct 12, 2023. */
            "1.9.20-Beta2" to "1.0.13", /* Sep 29, 2023. */
            "1.9.20-Beta" to "1.0.13", /* Sep 12, 2023. */
            "1.9.10" to "1.0.13", /* Sep 11, 2023. */
            "1.9.0" to "1.0.13", /* Aug 16, 2023. */
            "1.9.0-RC" to "1.0.11", /* Aug 16, 2023. */
            "1.8.21" to "1.0.11", /* Aug 16, 2023. */
            "1.8.20-RC2" to "1.0.9", /* Aug 16, 2023. */
            "1.8.0" to "1.0.9", /* Aug 16, 2023. */
            "1.8.0-RC2" to "1.0.8", /* Aug 16, 2023. */
            consts.IDENTIFIER_FALLBACK to "1.9.24-1.0.20", /* Dec 3, 2024. */
        )

        abstract inner class Platform(
            var name: String,
            val vendor: String,
            val androidVersionMap: Map<String, String>,
            val kotlinVersionMap: Map<String, String>,
            val codenameVersionMap: Map<String, String>? = null,
            val codenameMap: Map<String, String>? = null,
        ) {

            open val gradleSettingsName: String? = null
            open val weight: Int = -Int.MAX_VALUE
            open var version: String = consts.DEFAULT_VERSION

            @Suppress("unused")
            open val shouldPrintProgress: Boolean = true

            open val fullName
                get() = uppercaseFirstChar(name)

            open fun matchEnvironment() = systemProperties.platform?.startsWith(name) == true
                    || systemProperties.vendorName?.contains(vendor, true) == true

            fun ensureMinimalGradleJdkVersion() {
                val minVer = java.util.Properties().apply {
                    load(java.io.FileInputStream("$rootDir/version.properties"))
                }["JAVA_VERSION_MIN_SUPPORTED"].let { it as String }.toInt()

                if (JavaVersion.current().majorVersion.toInt() < minVer) {
                    Formatted(
                        "Current Gradle JDK version ${JavaVersion.current()} does not meet " +
                                "the minimum requirement which $minVer is needed",
                        mutableListOf<String>().apply {
                            gradleSettingsName?.let { add("Settings path: File | Settings | Build, Execution, Deployment | Build Tools | Gradle") }
                            add("Change \"${gradleSettingsName ?: "Gradle JDK"}\" to $minVer at the least")
                        }
                    ).throwException()
                }
            }

            fun prependConsoleInformation(consoleInfo: MutableList<String>) {
                val versionSuffix = when (this.version.isNotEmpty() && this.version != consts.DEFAULT_VERSION) {
                    true -> " | ${this.version}"
                    else -> ""
                }
                consoleInfo.add(0, "Platform: ${this.fullName}$versionSuffix")
            }

            private fun uppercaseFirstChar(s: String) = when (s.isEmpty()) {
                true -> ""
                else -> s[0].uppercase() + s.substring(1)
            }

        }

    }

    val identifier = object {

        // @Hint by SuperMonster003 on Oct 18, 2024.
        //  ! Fallback is a temporary or alternative solution
        //  ! used to handle some specific situations where functionality is unavailable.
        //  ! Compatibility is a broader design principle which ensures new versions
        //  ! remain compatible and continue to support the operations and data of older versions.
        //  ! zh-CN:
        //  ! Fallback (回退) 是一种临时或替代的解决方法, 用于应对功能不可用的特定情况.
        //  ! Compatibility (兼容) 是一种更广泛的设计原则, 确保新版本能兼容并继续支持旧版本的操作和数据.
        val fallback = consts.IDENTIFIER_FALLBACK
        val compatible = "compatible"

        val specified = "specified"
        val auto = "auto"

        val fallbackSuffix = " [$fallback]"
        val compatibleSuffix = " [$compatible]"
        val specifiedSuffix = " [$specified]"
        val autoSpecifiedSuffix = " [$auto-$specified]"

    }

    val platform = config.platforms.determine()

    val console = object {

        val versionInfo = mutableListOf<String>()

        fun printConcernedSystemPropertiesIfNeeded() {
            if (config.isShowConcernedSystemProperties && !systemProperties.isConcernsAlreadyPrinted) {
                Formatted("Information for concerned system properties", systemProperties.concerns).print(true)
            }
        }

        fun printVersionsOfIdeAndGradlePlugins() {
            Formatted("Version information for IDE platform and Gradle plugins", versionInfo).print()
        }

    }

    platform.ensureMinimalGradleJdkVersion()
    platform.prependConsoleInformation(console.versionInfo)

    val notations = object {

        private val kotlinVersionMap = platform.kotlinVersionMap

        private val pluginVersionAutomatorMap: Map<String, (Map<String, String>) -> Map<String, String?>> = mapOf(
            "ksp" to { versionMap: Map<String, String> ->
                var suffix = ""

                val kotlinVersion = config.libs.filterIsInstance<Classpath>()
                    .find { it.id.contains("kotlin-gradle-plugin", true) }
                    ?.takeIf { !it.version.startsWith("${identifier.auto}:") }
                    ?.version?.let { kt ->
                        suffix += identifier.autoSpecifiedSuffix
                        versionMap[kt]?.let { kt }
                    }
                    ?: Version(kotlinVersionMap, platform.version).bestMatchingValue
                    ?: kotlinVersionMap[identifier.fallback]?.let { kt ->
                        suffix += identifier.fallbackSuffix
                        versionMap[kt]?.let { kt }
                    }

                val kspVersion = kotlinVersion?.let { kt ->
                    val ver = Version(config.kspVersionMap, kt)
                    ver.bestMatchingKey?.let { key ->
                        if (ver.isBestMatchingOperated) suffix += identifier.compatibleSuffix
                        "$key-${ver.bestMatchingValue}"
                    }
                }

                mapOf("version" to kspVersion, "suffix" to suffix)
            },
        )

        val classpath = config.libs.filterIsInstance<Classpath>().map {
            var suffix = ""
            val version: String = when {
                it.version.startsWith("${identifier.auto}:") -> {
                    val mapType = it.version.substring("${identifier.auto}:".length)
                    val map = when (mapType) {
                        "android" -> platform.androidVersionMap
                        "kotlin" -> platform.kotlinVersionMap
                        else -> throw Exception("Unknown version ${it.version} for classpath ${it.id}")
                    }
                    val ver = Version(map, platform.version)
                    ver.bestMatchingKey?.let {
                        if (ver.isBestMatchingOperated) suffix += identifier.compatibleSuffix
                        ver.bestMatchingValue
                    } ?: map[identifier.fallback]?.also {
                        suffix += identifier.fallbackSuffix
                    } ?: consts.DEFAULT_VERSION
                }
                else -> it.version.also {
                    suffix += identifier.specifiedSuffix
                }
            }
            if (config.isJavaVersionCoercedByGradleVersion && it.id == "com.android.tools.build:gradle") {
                gradle.extra.set("gradleVersionToCoerceJavaVersion", version)
            }
            "${it.id}:$version".also { notation ->
                console.versionInfo += "Classpath: \"$notation\"$suffix"
            }
        }

        val plugins = config.libs.filterIsInstance<Plugin>().map {
            var suffix = ""
            val version: String = when {
                it.version.startsWith("${identifier.auto}:") -> {
                    val automator = pluginVersionAutomatorMap[it.version.substring("${identifier.auto}:".length)]!!
                    val result = automator.invoke(config.kspVersionMap)
                    result["suffix"]?.let { s -> suffix += s }
                    result["version"] ?: throw Exception("Unknown version for plugin ${it.id}")
                }
                else -> {
                    suffix += identifier.specifiedSuffix
                    it.version
                }
            }
            console.versionInfo += "Plugin: \"${it.id}:$version\"$suffix"
            mapOf("id" to it.id, "version" to version, "isApply" to it.isApply)
        }

        private inner class Version(private val map: Map<String, String>, platformVersion: String) {

            val bestMatchingKey: String?
            val bestMatchingValue: String?
            val isBestMatchingOperated: Boolean

            init {
                bestMatchingKey = findBestMatchingMapKey(platformVersion)
                bestMatchingValue = bestMatchingKey?.let { map[it] }
                isBestMatchingOperated = bestMatchingKey != null && bestMatchingKey != platformVersion
            }

            private fun findBestMatchingMapKey(platformVersion: String): String? {
                val (platformVersionNumbers, platformVersionSuffix) = toVersionParts(platformVersion)
                val sortedVersions = map.keys.filter { it != identifier.fallback }.sortedWith { v1, v2 ->
                    val (ver1Numbers, ver1Suffix) = toVersionParts(v1)
                    val (ver2Numbers, ver2Suffix) = toVersionParts(v2)
                    compareVersionParts(ver2Numbers, ver1Numbers).takeIf { it != 0 } ?: compareSuffix(ver2Suffix, ver1Suffix)
                }
                for (version in sortedVersions) {
                    val (versionNumbers, versionSuffix) = toVersionParts(version)
                    val versionComparisonScore = compareVersionParts(versionNumbers, platformVersionNumbers)
                    if (versionComparisonScore < 0) {
                        return version
                    }
                    if (versionComparisonScore == 0 && compareSuffix(versionSuffix, platformVersionSuffix) <= 0) {
                        return version
                    }
                }
                return null
            }

            private fun compareVersionParts(parts1: List<Int>, parts2: List<Int>): Int {
                for (i in 0 until maxOf(parts1.size, parts2.size)) {
                    val part1 = parts1.getOrElse(i) { 0 }
                    val part2 = parts2.getOrElse(i) { 0 }
                    if (part1 != part2) return part1.compareTo(part2)
                }
                return 0
            }

            private fun compareSuffix(suffix1: Pair<String, Int>, suffix2: Pair<String, Int>): Int {
                val suffixPriority = mapOf("" to 10, "Alpha" to 1, "Beta" to 2, "RC" to 5)
                val (suffixName1, suffixNumber1) = suffix1
                val (suffixName2, suffixNumber2) = suffix2
                val priority1 = suffixPriority[suffixName1] ?: Int.MAX_VALUE
                val priority2 = suffixPriority[suffixName2] ?: Int.MAX_VALUE
                return priority1.compareTo(priority2).takeIf { it != 0 } ?: suffixNumber1.compareTo(suffixNumber2)
            }

            private fun toVersionParts(version: String): Pair<List<Int>, Pair<String, Int>> {
                val parts = version.split(Regex("[+-]"))
                val numberParts = parts[0].split('.').map {
                    it.toIntOrNull() ?: throw IllegalArgumentException("Invalid version part: '$it' in version: '$version'")
                }

                val suffixPattern = Regex("([A-Za-z]+)(\\d*)|([A-Za-z]*)(\\d+)")
                val suffixMatch = suffixPattern.matchEntire(parts.getOrElse(1) { "" }) ?: return numberParts to ("" to 0)

                val suffixName = suffixMatch.groupValues[1] // "Alpha", "Beta", "RC" or empty string
                val suffixNumber = suffixMatch.groupValues[2].toIntOrNull() ?: 1 // Default to 1 for suffixes like "Alpha", "Beta", "RC"

                return numberParts to (suffixName to suffixNumber)
            }

        }

    }

    buildscript {
        repositories {
            mavenCentral()
            google()
        }
        dependencies /* Android/Kotlin Gradle Plugin. */  {
            notations.classpath.forEach { classpath(it) }
        }
        dependencies /* Apache Compress for utils.build.gradle module. */ {
            classpath("org.apache.commons:commons-compress:1.27.1")
            classpath("org.tukaani:xz:1.9")
        }
    }

    plugins {
        notations.plugins.forEach {
            id(it["id"] as String) version it["version"] as String apply it["isApply"] as Boolean
        }
    }

    gradle.taskGraph.whenReady {
        if (allTasks.none { it.name == "clean" }) {
            console.printConcernedSystemPropertiesIfNeeded()
            console.printVersionsOfIdeAndGradlePlugins()
        }
    }

    gradle.extra.apply {
        set("isCleanupPaddleOcr", config.isCleanupPaddleOcr)
        set("isCleanupRapidOcr", config.isCleanupRapidOcr)
    }

    gradle.beforeProject {
        extensions.extraProperties["kotlinVersion"] = notations.classpath.find {
            it.contains("kotlin-gradle-plugin")
        }?.substringAfterLast(":") ?: config.fallbackKotlinVersion
        extensions.extraProperties["platform"] = platform
    }

}