Иерархическая структура проекта

Настройка вашего проекта

Для настройки иерархии вызовите targetHierarchy.default() в блоке kotlin вашего файла build.gradle(.kts) и перечислите все необходимые целевые платформы. Например:

@OptIn(ExperimentalKotlinGradlePluginApi::class)
kotlin {
    // Enable the default target hierarchy:
    targetHierarchy.default()

    android()
    iosArm64()
    iosSimulatorArm64()
}

Когда вы объявляете конечные целевые платформы android, iosArm64, и iosSimulatorArm64 в вашем коде, плагин Kotlin Gradle находит подходящие общие наборы исходных кодов из шаблона и создает их для вас. Результирующая иерархия выглядит следующим образом:

Зеленые наборы исходных кодов фактически создаются и присутствуют в проекте, в то время как серые наборы из стандартного шаблона игнорируются. Плагин Kotlin Gradle не создал, например, набор watchos, потому что в проекте нет целевых платформ watchOS.

Если вы добавите целевую платформу watchOS, например watchosArm64, набор watchos будет создан, а код из наборов apple, native, и common будет скомпилирован для watchosArm64.

Настройка результирующей иерархии

Вы можете дополнительно настроить результирующую иерархию вручную с помощью отношения dependsOn. Для этого примените конструкцию by getting для наборов исходных кодов, созданных с помощью targetHierarchy.default().

Рассмотрим этот пример проекта с набором исходных кодов, используемым только для целевых платформ jvm и native.

@OptIn(ExperimentalKotlinGradlePluginApi::class)
kotlin {
    // Enable the default target hierarchy:
    targetHierarchy.default()

    jvm()
    iosArm64()
    // the rest of the necessary targets...

    sourceSets {
        val commonMain by getting

        val jvmAndNativeMain by creating {
            dependsOn(commonMain)
        }

        val nativeMain by getting {
            dependsOn(jvmAndNativeMain)
        }

        val jvmMain by getting {
            dependsOn(jvmAndNativeMain)
        }
    }
}

Удаление dependsOn отношений, которые автоматически создаются вызовом targetHierarchy.default(), может быть неудобным. В этом случае используйте вместо этого полностью ручную настройку.

Полный шаблон иерархии

При объявлении целевых платформ, для которых компилируется проект, плагин подбирает общие наборы исходных кодов, основанные на указанных целевых платформах из шаблона и создаёт их в вашем проекте.

Сокращения целевых платформ и симуляторы ARM64 (Apple Silicon)

Сокращения целевых платформ ios, watchos, и tvos не включают целевые платформы симуляторов ARM64 (Apple Silicon): iosSimulatorArm64, watchosSimulatorArm64, и tvosSimulatorArm64. Если вы используете сокращения целевых платформ и хотите скомпилировать проект для симулятора Apple Silicon, внесите следующие изменения в скрипт сборки:

1. Добавьте необходимую целевую платформу симулятора *SimulatorArm64.

2. Подключите целевую платформу симулятора к сокращению с помощью отношения dependsOn между наборами исходных кодов.

kotlin {
    ios()
    // Add the ARM64 simulator target
    iosSimulatorArm64()

    val iosMain by sourceSets.getting
    val iosTest by sourceSets.getting
    val iosSimulatorArm64Main by sourceSets.getting
    val iosSimulatorArm64Test by sourceSets.getting

    // Set up dependencies between the source sets
    iosSimulatorArm64Main.dependsOn(iosMain)
    iosSimulatorArm64Test.dependsOn(iosTest)
}

kotlin {
    ios()
    // Add the ARM64 simulator target
    iosSimulatorArm64()

    // Set up dependencies between the source sets
    sourceSets {
        // ...
        iosSimulatorArm64Main {
            dependsOn(iosMain)
        }
        iosSimulatorArm64Test {
            dependsOn(iosTest)
        }
    }
}