Поддерживаемые целевые платформы и хосты Kotlin/Native

Уровень 1

• Целевая платформа регулярно тестируется в CI на возможность компиляции и запуска.

• Мы обеспечиваем совместимость исходного кода и двоичных файлов между выпусками компилятора.

Уровень 2

• Целевая платформа регулярно тестируется в CI на возможность компиляции, однако возможность запуска может не проверяться автоматически.

• Мы прилагаем все усилия, чтобы обеспечить совместимость исходного кода и двоичных файлов между выпусками компилятора.

Уровень 3

• Не гарантируется, что целевая платформа будет тестироваться в CI.

• Мы не можем гарантировать совместимость исходного кода и двоичных файлов между различными выпусками компилятора, хотя такие изменения для этих целевых платформ встречаются довольно редко.

Устаревшие целевые платформы

Следующие целевые платформы устарели и запланированы к удалению:

Поддержка более ранних версий целевых платформ Apple

В настоящее время минимальные версии целевых платформ Apple, поддерживаемые по умолчанию, следующие:

• Для iOS и tvOS — 15.0.

• Для macOS — 12.0.

• Для watchOS — 8.0.

Если вашему проекту необходимо поддерживать версию ниже указанной по умолчанию, используйте параметр freeCompilerArgs в файле сборки:

kotlin {
    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget>().configureEach {
        binaries.configureEach {
            freeCompilerArgs += "-Xoverride-konan-properties=minVersion.ios=14.0"
            freeCompilerArgs += "-Xoverride-konan-properties=minVersion.macos=11.0"
            freeCompilerArgs += "-Xoverride-konan-properties=minVersion.tvos=14.0"
            freeCompilerArgs += "-Xoverride-konan-properties=minVersion.watchos=7.0"
        }
    }
}

Для авторов библиотек

Мы не рекомендуем авторам библиотек тестировать больше целевых платформ или предоставлять более строгие гарантии, чем компилятор Kotlin/Native. При рассмотрении поддержки нативных целевых платформ можно придерживаться следующего подхода:

• Поддерживайте все целевые платформы уровней 1, 2 и 3.

• Регулярно тестируйте целевые платформы уровней 1 и 2, на которых тесты запускаются без дополнительной настройки.

Команда Kotlin придерживается этого подхода в официальных библиотеках Kotlin, например, в kotlinx.coroutines и kotlinx.serialization.

Сборка готовых двоичных файлов

Для создания готовых двоичных файлов компилировать можно только для поддерживаемых целевых платформ и только на поддерживаемых хостах. Например, это невозможно сделать во FreeBSD или на компьютере с Linux и архитектурой ARM64.

Собирать готовые двоичные файлы для целевых платформ Apple в Linux и Windows также невозможно.

Создание артефактов .klib

В целом Kotlin/Native позволяет создавать артефакты .klib для поддерживаемых целевых платформ на любом поддерживаемом хосте.

Однако создание артефактов для целевых платформ Apple в Linux и Windows по-прежнему имеет некоторые ограничения. Если в проекте используются зависимости cinterop (в том числе CocoaPods), необходимо использовать хост macOS.

Например, создать .klib для целевой платформы macosArm64 на компьютере с Windows и архитектурой x86_64 можно только при отсутствии зависимостей cinterop.