provide_deprecation_message

Forneça uma mensagem de depreciação, via @Deprecated("message").

FAÇA especificar uma mensagem de depreciação (com instruções de migração e/ou um cronograma de remoção) no construtor Deprecated.

RUIM:

@deprecated
void oldFunction(arg1, arg2) {}

BOM:

@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) {}

Para ativar a regra provide_deprecation_message, adicione provide_deprecation_message em linter > rules no seu arquivo analysis_options.yaml:

linter:
  rules:
    - provide_deprecation_message

Se você usa a sintaxe de mapa YAML para configurar as regras de lint, adicione provide_deprecation_message: true em linter > rules:

linter:
  rules:
    provide_deprecation_message: true