Устойчивость компонентов Kotlin

Подробное описание уровней стабильности

Вот краткое руководство по этим уровням стабильности и их значению:

Экспериментальный означает «пробовать только в учебных проектах»:

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

Альфа означает «использовать на свой страх и риск, ожидайте проблем с миграцией»:

• Мы решили внедрить эту идею в продукт, но она еще не достигла окончательной формы.

Бета означает «вы можете использовать его, мы сделаем все возможное, чтобы свести к минимуму проблемы с миграцией для вас»:

• Он почти готов, отзывы пользователей сейчас особенно важны.

• Тем не менее, он не закончен на 100%, поэтому возможны изменения (включая те, которые основаны на ваших отзывах).

• Следите за предупреждениями об устаревании заранее, чтобы получить наилучший опыт обновления.

Мы собирательно называем Экспериментальный, Альфа и Бета уровнями до-стабильности.

Стабильный означает «используйте его даже в самых консервативных сценариях»:

• Это завершено. Мы будем развивать его в соответствии с нашими строгими правилами обратной совместимости.

Обратите внимание, что уровни стабильности ничего не говорят о том, как скоро компонент будет выпущен как Стабильный. Аналогично, они не указывают, насколько компонент будет изменен перед выпуском. Они только говорят, насколько быстро изменяется компонент и какой риск проблем с обновлениями несут пользователи.

Значки GitHub для компонентов Kotlin

Организация Kotlin на GitHub размещает различные проекты, относящиеся к Kotlin. Некоторые из них мы разрабатываем постоянно, другие являются побочными проектами.

Каждый проект Kotlin имеет два значка GitHub, описывающие его стабильность и статус поддержки:

• Статус стабильности. Это показывает, насколько быстро развивается каждый проект и какой риск несут пользователи при его использовании. Статус стабильности полностью совпадает с уровнем стабильности функций языка Kotlin и его компонентов:

  • означает Экспериментальный

  • означает Альфа

  • означает Бета

  • означает Стабильный

• Статус поддержки. Это показывает нашу приверженность поддержанию проекта и оказанию помощи пользователям в решении их проблем. Уровень поддержки унифицирован для всех продуктов JetBrains.
  Подробнее см. в документе JetBrains Confluence.

Устойчивость подкомпонентов

Стабильный компонент может иметь экспериментальный подкомпонент, например:

• стабильный компилятор может иметь экспериментальную функцию;

• стабильный API может включать экспериментальные классы или функции;

• стабильный инструмент командной строки может иметь экспериментальные параметры.

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

Текущая стабильность компонентов Kotlin

Предыдущая версия страницы (до 1.4) доступна здесь.