Cambios disruptivos y guías de migración

Como se describe en la política de cambios importantes, en ocasiones publicamos guías para migrar código a través de un cambio importante.

Para recibir notificaciones sobre futuros cambios importantes, únete a los grupos Flutter announce y Dart announce.

Cuando te enfrentes a errores de Dart después de actualizar Flutter, considera usar el comando dart fix para migrar automáticamente tu código. No todos los cambios importantes son compatibles de esta manera, pero muchos sí.

Para evitar que futuras versiones de Flutter rompan tu código, considera enviar tus pruebas al registro de pruebas del framework.

Las siguientes guías están disponibles. Están ordenadas por versión y enumeradas en orden alfabético:

• Se agregó la propiedad enabled y se hizo onChanged opcional para DropdownButton
• El contenido de render-to-texture de OpenGL ES se almacena de arriba a abajo
• Actualización de la cabecera de semántica y del comportamiento de headingLevel en iOS y Android

• Cambio en el orden de cierre de RawMenuAnchor
• Desaprobar el callback onReorder
• Desaprobar TextInputConnection.setStyle
• Desaprobados cacheExtent y cacheExtentStyle
• La clase IconData marcada como final
• Restricciones de orientación de pantalla grande y redimensionamiento ignoradas en Android 17
• ListTile reporta un error en debug cuando está envuelto en un widget coloreado
• Migración de proyectos Flutter de Android a Kotlin integrado
• Reorganización de los builders de transición de página

• Hilos fusionados en Linux
• FontWeight también controla el atributo de peso de las fuentes variables
• Desaprobar containsSemantics en favor de isSemantics
• Desaprobar findChildIndexCallback en favor de findItemIndexCallback en los constructores separados de ListView y SliverList
• Actualización de tokens de Material 3

• Soporte de amplia gama de colores para CupertinoDynamicColor
• Desaprobar OverlayPortal.targetsRootOverlay
• Desaprobar SemanticsProperties.focusable y SemanticsConfiguration.isFocusable
• SnackBar con acción ya no se descarta automáticamente
• La transición de página predeterminada en Android ahora es PredictiveBackPageTransitionBuilder
• Adopción de UISceneDelegate

• Actualizaciones de normalización de temas de componentes
• Desaprobar el parámetro value de DropdownButtonFormField en favor de initialValue
• Desaprobar el color de la app bar
• Rediseño del widget Radio
• Eliminadas la elevación y el grosor de semántica
• El widget Form ya no admite ser un sliver
• Flutter ahora establece abiFilters predeterminados en las compilaciones de Android
• Hilos fusionados en macOS y Windows
• El widget Visibility ya no es enfocable de forma predeterminada cuando maintainState está habilitado
• $FLUTTER_ROOT/version reemplazado por $FLUTTER_ROOT/bin/cache/flutter.version.json

• Desaprobar SystemContextMenuController.show
• Desaprobar ExpansionTileController en favor de ExpansibleController
• Desaprobar RouteTransitionRecord.markForRemove en favor de RouteTransitionRecord.markForComplete
• Desaprobar ThemeData.indicatorColor en favor de TabBarThemeData.indicatorColor
• Actualizaciones del sistema de temas de Material
• .flutter-plugins-dependencies reemplaza a .flutter-plugins
• Los mensajes localizados se generan en el código fuente, no en un paquete sintético
• Cambiando el goldenFileComparator predeterminado para las pruebas de integration_test
• Desaprobar InputDecoration.maintainHintHeight en favor de InputDecoration.maintainHintSize
• Cambió la fórmula de resorte subamortiguado

• Eliminación de las API Java de Android embedding v1
• Desaprobar WebGoldenComparator
• Desaprobar ThemeData.dialogBackgroundColor en favor de DialogThemeData.backgroundColor
• Selección automática del modo de mosaico (tile mode) predeterminado de ImageFilter.blur
• Slider de Material 3 actualizado
• Indicadores de progreso de Material 3 actualizados

• Soporte de amplia gama de colores para Color
• Normalización de temas de componentes
• Cambio en la bandera de enlaces profundos
• Actualización de tokens de Material 3 en Flutter
• Eliminar parámetros no válidos para InputDecoration.collapsed
• Establecer el valor predeterminado para SystemUiMode a Edge-to-Edge

• Cambio importante en las API de página de Navigator
• Tipos genéricos en PopScope
• Desaprobar ButtonBar en favor de OverflowBar
• Nuevas API para plugins de Android que renderizan en una Surface

• API desaprobada eliminada después de la v3.19
• Renombrar MaterialState a WidgetState
• Introducción de nuevos roles de ColorScheme
• Dejando de admitir Android KitKat
• PageView.controller ahora admite nulos
• Renombrar MemoryAllocations a FlutterMemoryAllocations

• API desaprobada eliminada después de la v3.16
• Migrar el sistema RawKeyEvent/RawKeyboard al sistema KeyEvent/HardwareKeyboard
• Desaprobar la aplicación imperativa de los plugins de Gradle de Flutter
• Desplazamiento multitáctil predeterminado
• Cambio en el orden de recorrido de accesibilidad del tooltip
• Dejar de generar AssetManifest.json

• Migrando a Material 3
• Migrar ShortcutActivator y ShortcutManager al sistema KeyEvent
• La propiedad ThemeData.useMaterial3 ahora está establecida en true de forma predeterminada
• API desaprobada eliminada después de la v3.13
• Personalizar la alineación de las pestañas usando la nueva propiedad TabBar.tabAlignment
• Desaprobar textScaleFactor en favor de TextScaler
• Escalado de fuente no lineal de Android 14 habilitado
• Desaprobar describeEnum y actualizar EnumProperty para que sea estricto con los tipos
• API de pop de navegación just-in-time desaprobadas para Android Predictive Back
• Desaprobado Paint.enableDithering
• Estilos de texto predeterminados actualizados para los menús
• Windows: Las ventanas externas deben notificar al motor de Flutter los cambios en el ciclo de vida
• Cambio en la ruta de compilación de Windows para agregar la arquitectura de destino

• Se agregó el método dispose() faltante para algunos objetos desechables en Flutter
• API desaprobada eliminada después de la v3.10
• Se agregó el valor de enum AppLifecycleState.hidden
• Se movieron las cadenas localizadas de ReorderableListView de las localizaciones de material a las de widgets
• Se eliminaron las propiedades ignoringSemantics
• Desaprobado RouteInformation.location y sus API relacionadas
• Comportamiento de desplazamiento para hacer visible de EditableText actualizado
• Migrar un proyecto de Windows para asegurar que se muestre la ventana
• Comportamiento de Checkbox.fillColor actualizado

• Cambios de Dart 3 en Flutter v3.10 y versiones posteriores
• API desaprobada eliminada después de la v3.7
• Cliente de entrada de texto para insertar contenido
• Desaprobar el singleton window
• Resolver el error de Android Java Gradle
• Requerir una variante de datos para el constructor de ClipboardData
• "Mensaje de "Zone mismatch""

• API desaprobada eliminada después de la v3.3
• Reemplazados los parámetros para personalizar menús contextuales con un builder de widgets genérico
• splashScreenView de iOS FlutterViewController ahora admite nulos
• Migrar of a valores de retorno que no admitan nulos y agregar maybeOf
• Eliminado RouteSettings.copyWith
• La propiedad toggleableActiveColor de ThemeData ha sido desaprobada
• Migrar un proyecto de Windows para admitir barras de título oscuras

• Agregando ImageProvider.loadBuffer
• PrimaryScrollController predeterminado en escritorio
• Los gestos del trackpad pueden activar GestureRecognizer
• Migrar un proyecto de Windows para establecer la información de versión

• API desaprobada eliminada después de la v2.10
• Migrar useDeleteButtonTooltip a deleteButtonTooltipMessage de Chips
• Transiciones de página reemplazadas por ZoomPageTransitionsBuilder

• API desaprobada eliminada después de la v2.5
• Las imágenes RAW en la Web usan el origen y los colores correctos
• Versión requerida de Kotlin
• Cliente de entrada de texto Scribble

• Dispositivos de desplazamiento por arrastre predeterminados
• API desaprobada eliminada después de la v2.2
• Cambiar el método enterText para mover el cursor al final del texto de entrada
• Limpieza de GestureRecognizer
• Presentamos el paquete:flutter_lints
• Reemplazar AnimationSheetBuilder.display con collate
• Las propiedades accent de ThemeData han sido desaprobadas
• Transición de las interfaces de prueba de canales de plataforma al paquete flutter_test
• Uso de slots HTML para renderizar vistas de plataforma en la web
• Migrar un proyecto de Windows al bucle de eventos idiomático

El siguiente cambio importante fue revertido en la versión 2.2:

Política de red en iOS y Android

Introducido en la versión: 2.0.0
Revertido en la versión: 2.2.0

• Barras de desplazamiento predeterminadas en Desktop

• Se agregó el parámetro BuildContext a TextEditingController.buildTextSpan
• Cambio de firma de Android ActivityControlSurface attachToActivity
• Se eliminó la API de pruebas Android FlutterMain.setIsRunningInRobolectricTest
• Comportamiento de Clip
• API desaprobada eliminada después de la v1.22
• Soporte de dry layout para RenderBox
• Eliminación de parámetros nullOk
• Semántica del botón Material Chip
• SnackBars administrados por el ScaffoldMessenger
• Migración de TextSelectionTheme
• Transición de las interfaces de prueba de canales de plataforma al paquete flutter_test
• Usar maxLengthEnforcement en lugar de maxLengthEnforced

• Desaprobación de la creación de aplicaciones y plugins con Android v1 embedding
• Iconos de Cupertino 1.0.0
• La nueva API de autovalidación de Form y FormField

• Revisión de la API de Actions
• Adición de la propiedad TextInputClient.currentAutofillScope
• Nuevos botones y temas de botones
• BorderRadius predeterminado de los diálogos
• Aserciones más estrictas en el alcance de Navigator y Hero Controller
• Actualizaciones del registro Route Transition y Transition delegate
• RenderEditable necesita pasar por el layout antes del hit testing
• Revertir la dependencia entre la capa del scheduler y la de servicios
• Orden de semántica de las entradas de Overlay en rutas modales
• Método showAutocorrectionPromptRect agregado a TextInputClient
• TestWidgetsFlutterBinding.clock
• TextField requiere MaterialLocalizations

• Adición de 'linux' y 'windows' al enum TargetPlatform
• Las anotaciones devuelven la posición local relativa al objeto
• Optimización del color de Container
• CupertinoTabBar requiere un padre Localizations
• El tipo genérico de ParentDataWidget cambió a ParentData
• Cambios en ImageCache e ImageProvider
• Grandes imágenes de ImageCache
• MouseTracker movido a renderizado
• MouseTracker ya no adjunta anotaciones
• Brightness de CupertinoTheme ahora admite nulos
• Optimización de reconstrucción para OverlayEntries y Routes
• AlertDialog con desplazamiento
• Restablecimiento del estado de TestTextInput
• currentTextEditingValue de TextInputClient
• El método forgetChild() debe llamar a super
• Refactorización de Route y Navigator
• FloatingActionButton y propiedades accent de ThemeData