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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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