内容

deprecated_member_use_from_same_package

内容

避免在声明弃用元素的包中使用这些弃用元素。

此规则自 Dart 3.0 起可用。

此规则提供了一个 快速修复。

详情

#

使用@Deprecated注释的元素不应在声明它们的包中被引用。

**避免**使用弃用元素。

...

错误示例

dart
// Declared in one library:
class Foo {
  @Deprecated("Use 'm2' instead")
  void m1() {}

  void m2({
      @Deprecated('This is an old parameter') int? p,
  })
}

@Deprecated('Do not use')
int x = 0;

// In the same or another library, but within the same package:
void m(Foo foo) {
  foo.m1();
  foo.m2(p: 7);
  x = 1;
}

为了允许将一组 API 作为一个单元一起弃用，可以在其他弃用元素中使用弃用元素。

正确示例

dart
// Declared in one library:
class Foo {
  @Deprecated("Use 'm2' instead")
  void m1() {}

  void m2({
      @Deprecated('This is an old parameter') int? p,
  })
}

@Deprecated('Do not use')
int x = 0;

// In the same or another library, but within the same package:
@Deprecated('Do not use')
void m(Foo foo) {
  foo.m1();
  foo.m2(p: 7);
  x = 1;
}

用法

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - deprecated_member_use_from_same_package

除非另有说明，否则本网站上的文档反映了 Dart 3.5.3。页面上次更新于 2024-07-03。 查看源代码 或 报告问题。