目录

provide_deprecation_message

通过 @Deprecated("message") 提供弃用消息。

此规则在 Dart 2.2 及更高版本中可用。

规则集:核心推荐flutter

详情

#

应该Deprecated 构造函数中指定弃用消息(带有迁移说明和/或删除时间表)。

错误

dart
@deprecated
void oldFunction(arg1, arg2) {}

正确

dart
@Deprecated("""
[oldFunction] is being deprecated in favor of [newFunction] (with slightly
different parameters; see [newFunction] for more information). [oldFunction]
will be removed on or after the 4.0.0 release.
""")
void oldFunction(arg1, arg2) {}

用法

#

要启用 provide_deprecation_message 规则,请在 analysis_options.yaml 文件中的 linter > rules 下添加 provide_deprecation_message

analysis_options.yaml
yaml
linter:
  rules:
    - provide_deprecation_message