API desaprobada eliminada después de la v3.16

De acuerdo con la política de deprecación de Flutter, se han eliminado las APIs deprecadas que llegaron al final de su vida útil después del lanzamiento estable 3.16.

Todas las APIs afectadas se han compilado en esta fuente principal para ayudar en la migración. Para ayudar aún más con tu migración, consulta esta hoja de referencia rápida.

Esta sección enumera las deprecaciones por paquete y clase afectada.

Paquete: flutter Compatible con Flutter Fix: sí

Los widgets TextButton, ElevatedButton y OutlinedButton tienen un método estático styleFrom para generar el ButtonStyle. Las siguientes propiedades de color de este método para cada clase fueron deprecadas en v3.1:

• TextButton.styleFrom
  • primary
  • onSurface
• ElevatedButton.styleFrom
  • primary
  • onPrimary
  • onSurface
• OutlinedButton.styleFrom
  • primary
  • onSurface

Estos cambios alinearon mejor la API con las especificaciones actualizadas de Material Design. Los cambios también proporcionaron más claridad sobre cómo se aplicarían los colores a los botones, al reemplazar estas propiedades con backgroundColor, foregroundColor y disabledForegroundColor.

Migration guide

Código antes de la migración:

TextButton.styleFrom(
  primary: Colors.red,
  onSurface: Colors.black,
);
ElevatedButton.styleFrom(
  primary: Colors.red,
  onPrimary: Colors.blue,
  onSurface: Colors.black,
);
OutlinedButton.styleFrom(
  primary: Colors.red,
  onSurface: Colors.black,
);

Código después de la migración:

TextButton.styleFrom(
  foregroundColor: Colors.red,
  disabledForegroundColor: Colors.black,
);
ElevatedButton.styleFrom(
  backgroundColor: Colors.red,
  foregroundColor: Colors.blue,
  disabledForegroundColor: Colors.black,
);
OutlinedButton.styleFrom(
  foregroundColor: Colors.red,
  disabledForegroundColor: Colors.black,
);

References

Documentación de la API:

• TextButton
• ElevatedButton
• OutlinedButton
• ButtonStyle

PRs relevantes:

• Deprecado en #105291
• Eliminado en #139267

Paquete: flutter Compatible con Flutter Fix: sí

La propiedad selectedRowColor de ThemeData fue deprecada en v3.1.

La propiedad ya no era utilizada por el framework, ya que los widgets que la usaban migraron a otros temas de componentes o ya no la requerían en la especificación actualizada para Material Design.

Migration guide

Código antes de la migración:

ThemeData(
  // ...
  selectedRowColor: Colors.pink, // Would have no effect.
);

Código después de la migración:

ThemeData(
  // ...
  // Remove uses.
);

References

Documentación de la API:

• ThemeData

PRs relevantes:

• Deprecado en #109070
• Eliminado en #139080

Paquete: flutter Compatible con Flutter Fix: sí

La propiedad focusScopeNode de NavigatorState fue deprecada en v3.1.

Este cambio se realizó para resolver varios problemas relacionados con el FocusScopeNode introducido por el Navigator. En su lugar, el FocusScope se movió para envolver al Navigator de nivel superior en un WidgetsApp. NavigatorState se modificó para contener su propio FocusNode, desde donde puede hacer referencia a su FocusNode.enclosingScope para acceder al FocusScopeNode correcto.

Migration guide

Código antes de la migración:

Navigator.of(context).focusScopeNode;

Código después de la migración:

Navigator.of(context).focusNode.enclosingScope!;

References

Documentación de la API:

• Navigator
• NavigatorState
• FocusScope
• FocusScopeNode
• FocusNode

PRs relevantes:

• Deprecado en #109702
• Eliminado en #139260

Paquete: flutter Compatible con Flutter Fix: sí

La propiedad body de PlatformMenuBar fue deprecada en v3.1.

Este cambio se realizó para alinear PlatformMenuBar con otros widgets en el framework, renombrándola a child.

Migration guide

Código antes de la migración:

PlatformMenuBar(
  body: myWidget,
);

Código después de la migración:

PlatformMenuBar(
  child: myWidget,
);

References

Documentación de la API:

• PlatformMenuBar

PRs relevantes:

• Deprecado en #104565
• Eliminado en #138509

Las deprecaciones anunciadas anteriormente para TextTheme, WidgetInspectorService y WidgetInspectorServiceExtensions no se eliminaron durante este ciclo. La deprecación de WidgetInspectorService y WidgetInspectorServiceExtensions en setPubRootDirectories se ha extendido otro año para permitir que los IDEs y otros clientes migren. Se espera que las deprecaciones de TextTheme se eliminen en el próximo ciclo, el cual se anunciará nuevamente cuando llegue.

En versión estable: 3.19.0