Стабильность компонентов Kotlin

Объяснение уровней стабильности

Краткое описание уровней стабильности и их значения:

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

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

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

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

Бета означает «вы можете использовать эту функцию, а мы постараемся свести к минимуму трудности при переходе на неё»:

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

• Однако функция ещё не полностью готова, поэтому возможны изменения (в том числе на основе ваших отзывов).

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

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

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

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

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

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

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

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

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

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

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

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

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

• Статус поддержки. Он показывает, насколько мы готовы поддерживать проект и помогать пользователям решать их проблемы. Уровень поддержки един для всех продуктов JetBrains.
  Подробности см. в документе JetBrains об открытом исходном коде.

Стабильность подкомпонентов

У стабильного компонента может быть экспериментальный подкомпонент. Например:

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

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

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

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

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

Языковые возможности и предложения по проектированию

Сведения о языковых возможностях и новых предложениях по проектированию см. в разделе Языковые возможности и предложения Kotlin.