<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 остается в скомпилированном коде, сохраняя двоичную совместимость с ранее скомпилированным кодом.