Deprecated class

注释@Deprecated('migration')将功能标记为已弃用.

不推荐使用的注释是不推荐使用的简写,直到未指定"下一个发行版本"而没有迁移说明.

@Deprecated批注的目的是通知某个功能用户,即使当前仍在正常工作,也应该更改其代码.

已计划不推荐使用的功能将在以后删除,可能在message中指定. 不应使用已弃用的功能,使用该功能的代码将来会在某个时候中断. 如果现有代码正在使用该功能,则应将其重写为不使用不推荐使用的功能.

不推荐使用的功能应记录如何在message中实现相同的效果,以便程序员知道如何重写代码.

@Deprecated批注适用于@Deprecated库,顶级声明(变量,getter,setter,函数,类和typedef),类声明(变量,getter,setter,方法,运算符或构造函数,无论是否为静态)可选参数和尾随可选位置参数.

弃用是可传递的:

  • 如果不赞成使用某个库,那么它的每个成员也都不要使用.
  • 如果不推荐使用某个类,则该类的每个成员也都将被弃用.
  • 如果不推荐使用变量,则其隐式getter和setter也不适用.

处理Dart源代码的工具可能会在以下情况下报告:

  • 该代码将导入已弃用的库.
  • 该代码将导出已弃用的库,或未弃用的库中任何已弃用的成员.
  • 该代码静态引用了已弃用的声明.
  • 代码动态地使用具有静态已知类型的对象的成员,而该成员在对象的静态类型上已弃用.
  • 该代码动态地调用带有参数的方法,其中对象的静态类型不赞成使用相应的可选参数.

如果已弃用的使用位于本身已弃用的库,类或方法中,则该工具不应使用户感到烦恼. 不推荐使用的功能应使用其他不推荐使用的功能.

Constructors

Deprecated(String message)
创建一个弃用注释,该注释指定注释功能的迁移路径和到期时间. [...]
const

Properties

expires String
@ 不推荐使用 ("改用`message`.将在Dart 3.0.0中删除"),只读
hashCode int
此对象的哈希码. [...]
只读,继承
message String
当用户使用不推荐使用的功能时提供给用户的消息. [...]
最后
runtimeType Type
对象的运行时类型的表示形式.
只读,继承

Methods

noSuchMethod(Invocation invocation) → dynamic
当访问不存在的方法或属性时调用. [...]
遗传
toString() String
返回此对象的字符串表示形式.
覆写

Operators

operator ==(Object other) bool
等于运算符. [...]
遗传