<init>

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.3)

<init>(
    message: String, 
    replaceWith: ReplaceWith = ReplaceWith(""), 
    level: DeprecationLevel = DeprecationLevel.WARNING)

Помечает аннотированное объявление как устаревшее.

Устаревший элемент API не рекомендуется использовать, обычно потому, что он уходит на пенсию или существует лучшая альтернатива.

Для постепенного удаления устаревшего API можно использовать свойство level. Обычно постепенное прекращение использования происходит в стадии «предупреждение», затем «ошибка», а затем «скрыто» или «удалено»:

• В первую очередь, и по умолчанию, используется DeprecationLevel.WARNING, чтобы оповестить потребителей API, но не прервать их компиляцию или использование во время выполнения.
• Затем, через некоторое время, уровень устаревания повышается до DeprecationLevel.ERROR, так что новый код Kotlin не может быть скомпилирован с использованием устаревшего API.
• Наконец, API полностью удаляется или скрывается (DeprecationLevel.HIDDEN) из кода, поэтому его использование выглядит как неразрешенные ссылки, в то время как API остается в скомпилированном коде, сохраняя двоичную совместимость с ранее скомпилированным кодом.