Аннотация @deprecated
Аннотация @deprecated помечает элемент кода как устаревший.
Она сообщает другим разработчикам, что данный код больше не
рекомендуется к использованию и в будущем может быть удалён.
Аннотация принимает один необязательный параметр - строку
с причиной устаревания или рекомендацией по замене.
В первый параметр мы передаём текст сообщения, который
увидит разработчик при использовании устаревшего кода.
При обращении к помеченному элементу анализатор Dart выдаёт предупреждение. Это помогает вовремя заметить устаревший код и перейти на актуальную замену.
Синтаксис
@deprecated
@deprecated('message')
Пример
Давайте пометим функцию как устаревшую и вызовем её:
@deprecated
void oldFunction()
{
print('old');
}
void main()
{
oldFunction();
}
Результат выполнения кода:
"old"
Пример
Давайте укажем причину устаревания в сообщении:
@deprecated('Use newFunction instead')
void oldFunction()
{
print('old');
}
void newFunction()
{
print('new');
}
void main()
{
oldFunction();
newFunction();
}
Результат выполнения кода:
"old"
"new"
Пример
Давайте пометим поле класса как устаревшее:
class User
{
@deprecated('Use name instead')
String login = 'abcde';
String name = 'abcde';
}
void main()
{
User user = User();
print(user.login);
print(user.name);
}
Результат выполнения кода:
"abcde"
"abcde"
