Depreciación del parámetro color en el tema de AppBar

El parámetro color en los constructores de AppBarTheme y AppBarThemeData y sus métodos copyWith se ha puesto en desuso. Utiliza backgroundColor en su lugar. Este cambio afecta a cómo se configuran los temas de AppBar y podría causar advertencias de depreciación en el código existente.

El sistema de temas de AppBar tenía dos parámetros que controlaban la misma propiedad: color y backgroundColor. Esta duplicidad generaba confusión e inconsistencia en la API. Para mejorar la claridad y consistencia, el parámetro color se ha puesto en desuso en favor de backgroundColor.

La depreciación afecta a las siguientes clases y métodos:

• Constructor de AppBarTheme
• Método AppBarTheme.copyWith
• Constructor de AppBarThemeData
• Método AppBarThemeData.copyWith

Al utilizar el parámetro color en desuso, verás advertencias como:

'color' is deprecated and shouldn't be used. Use backgroundColor instead.
This feature was deprecated after v3.33.0-0.2.pre.

Las clases también incluyen comprobaciones de aserción para evitar el uso de ambos parámetros simultáneamente:

The color and backgroundColor parameters mean the same thing. Only specify one.

Reemplaza todos los usos del parámetro color por backgroundColor en los constructores de AppBarTheme y AppBarThemeData y sus métodos copyWith.

Código antes de la migración:

// AppBarTheme constructor
AppBarTheme(
  color: Colors.blue,
  elevation: 4.0,
)
​
// AppBarTheme copyWith
theme.copyWith(
  color: Colors.red,
  elevation: 2.0,
)
​
// AppBarThemeData constructor
AppBarThemeData(
  color: Colors.green,
  elevation: 4.0,
)
​
// AppBarThemeData copyWith
themeData.copyWith(
  color: Colors.purple,
  elevation: 2.0,
)

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

// AppBarTheme constructor
AppBarTheme(
  backgroundColor: Colors.blue,
  elevation: 4.0,
)
​
// AppBarTheme copyWith
theme.copyWith(
  backgroundColor: Colors.red,
  elevation: 2.0,
)
​
// AppBarThemeData constructor
AppBarThemeData(
  backgroundColor: Colors.green,
  elevation: 4.0,
)
​
// AppBarThemeData copyWith
themeData.copyWith(
  backgroundColor: Colors.purple,
  elevation: 2.0,
)

Llegó en la versión: 3.33.0-0.2.pre
En la versión estable: 3.35.4

Documentación de la API:

• AppBarTheme
• AppBarThemeData

PRs relevantes:

• Depreciación del parámetro color en el tema de AppBar #170624