Стабильность компонентов Kotlin (до 1.4)
Существуют различные режимы стабильности в зависимости от скорости развития компонента:
-
Быстрое развитие (MF): не следует ожидать совместимости даже между инкрементными релизами, любая функциональность может быть добавлена, удалена или изменена без предупреждения.
-
Добавления в инкрементных релизах (AIR): в инкрементном релизе могут быть добавлены новые элементы, удаления и изменения поведения следует избегать и объявлять в предыдущих инкрементных релизах при необходимости.
-
Стабильные инкрементные релизы (SIR): инкрементные релизы полностью совместимы, происходят только оптимизации и исправления ошибок. Любые изменения могут быть внесены в релизе с новыми функциями.
- Полная стабильность (FS): инкрементные релизы полностью совместимы, происходят только оптимизации и исправления ошибок. Релизы с новыми функциями совместимы с предыдущими версиями.
Совместимость исходного кода и бинарных файлов может иметь разные режимы для одного и того же компонента, например, язык исходного кода может достичь полной стабильности до стабилизации бинарного формата или наоборот.
Положения политики развития Kotlin полностью применяются только к компонентам, достигшим полной стабильности (FS). С этого момента несовместимые изменения должны быть одобрены Комитетом по языку.
| Компонент | Статус, введён в версии | Режим для исходных кодов | Режим для бинарников |
|---|---|---|---|
| Kotlin/JVM | 1.0 | FS | FS |
| kotlin-stdlib (JVM) | 1.0 | FS | FS |
| Синтаксис KDoc | 1.0 | FS | N/A |
| Coroutine | 1.3 | FS | FS |
| kotlin-reflect (JVM) | 1.0 | SIR | SIR |
| Kotlin/JS | 1.1 | AIR | MF |
| Kotlin/Native | 1.3 | AIR | MF |
| Kotlin-скрипты (*.kts) | 1.2 | AIR | MF |
| dokka | 0.1 | MF | N/A |
| API-интерфейсы Kotlin-скриптов | 1.2 | MF | MF |
| API плагинов компилятора | 1.0 | MF | MF |
| Сериализация | 1.3 | MF | MF |
| Многоплатформенные проекты | 1.2 | MF | MF |
| Встроенные классы | 1.3 | MF | MF |
| Бесзнаковые арифметические операции | 1.3 | MF | MF |
| Все остальные экспериментальные функции по умолчанию | N/A | MF | MF |
© 2010–2020 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/reference/evolution/components-stability-pre-1.4.html