Actualizar Flutter

No importa cuál de los canales de lanzamiento de Flutter sigas, puedes usar el comando flutter para actualizar tu SDK de Flutter o los paquetes de los que depende tu app.

Para actualizar el Flutter SDK, usa el comando flutter upgrade:

$ flutter upgrade

Este comando obtiene la versión más reciente del Flutter SDK que esté disponible en tu canal actual de Flutter.

Si estás usando el canal estable y quieres una versión aún más reciente del Flutter SDK, cambia al canal beta usando flutter channel beta, y luego ejecuta flutter upgrade.

Publicamos guías de migración para cambios importantes conocidos.

Enviamos anuncios sobre estos cambios a la lista de correo de anuncios de Flutter.

Para evitar que futuras versiones de Flutter rompan tu código, considera enviar tus pruebas a nuestro registro de pruebas.

Flutter tiene dos canales de lanzamiento: estable y beta.

Recomendamos el canal estable para nuevos usuarios y para lanzamientos de aplicaciones en producción. El equipo actualiza este canal aproximadamente cada tres meses. El canal podría recibir hot fixes ocasionales para problemas de alta gravedad o gran impacto.

La integración continua para los complementos y paquetes del equipo de Flutter incluye pruebas con la última versión del canal estable.

La documentación más reciente para la rama estable está en: https://api.flutter.dev

El canal beta tiene el último lanzamiento estable. Esta es la versión más reciente de Flutter que hemos probado exhaustivamente. Este canal ha superado todas nuestras pruebas públicas, ha sido verificado con conjuntos de pruebas para productos de Google que usan Flutter y ha sido evaluado con conjuntos de pruebas privados aportados por colaboradores. El canal beta recibe hot fixes periódicos para abordar problemas importantes recién descubiertos.

El canal beta es esencialmente el mismo que el canal estable pero se actualiza mensualmente en lugar de trimestralmente. De hecho, cuando se actualiza el canal estable, se actualiza a la última versión del canal beta.

Actualmente tenemos otro canal, main (anteriormente conocido como master). Quienes contribuyen a Flutter usan este canal.

Este canal no está tan exhaustivamente probado como los canales beta y estable.

No recomendamos usar este canal, ya que es más probable que contenga regresiones graves.

La documentación más reciente para la rama main está en: https://main-api.flutter.dev

Para ver tu canal actual, usa el siguiente comando:

$ flutter channel

Para cambiar a otro canal, usa flutter channel <channel-name>. Una vez que hayas cambiado de canal, usa flutter upgrade para descargar el Flutter SDK más reciente y los paquetes dependientes para ese canal. Por ejemplo:

$ flutter channel beta
$ flutter upgrade

Para cambiar a una versión específica de Flutter:

1. Busca la versión de Flutter que deseas en el archivo del SDK de Flutter.

2. Navega al Flutter SDK:

   $ cd /path/to/flutter
   

   content_copy

3. Usa git checkout para cambiar a la versión de Flutter que desees:

   $ git checkout <Flutter version>
   

   content_copy

Si has modificado tu archivo pubspec.yaml, o quieres actualizar solo los paquetes de los que depende tu aplicación (en lugar de actualizar tanto los paquetes como Flutter), utiliza uno de los comandos de flutter pub.

Para actualizar a las versiones compatibles más recientes de todas las dependencias enumeradas en el archivo pubspec.yaml, usa el comando upgrade:

$ flutter pub upgrade

Para actualizar a la versión más reciente posible de todas las dependencias enumeradas en el archivo pubspec.yaml, usa el comando upgrade --major-versions:

$ flutter pub upgrade --major-versions

Esto también actualiza automáticamente las restricciones en el archivo pubspec.yaml.

Para identificar dependencias de paquetes desactualizadas y obtener consejos sobre cómo actualizarlas, usa el comando outdated. Para más detalles, consulta la documentación de pub outdated de Dart.

$ flutter pub outdated

Al ejecutar flutter upgrade en Windows, es posible que encuentres un error como el siguiente:

error: unable to create file ...: Filename too long

Esto ocurre porque la ruta de un archivo en el Flutter SDK supera el límite máximo predeterminado de longitud de ruta en Windows.

Para resolver este problema, considera instalar el Flutter SDK en una ruta más corta. Por ejemplo, instala Flutter en C:\Flutter en lugar de algo más largo como C:\Users\<nombre de usuario>\Documents\flutter.

De lo contrario, haz lo siguiente:

1. Habilita el soporte para rutas largas en Git:

   $ git config --system core.longpaths true
   

   content_copy

   Si el comando falla con un error de permisos, intenta ejecutar tu terminal como administrador.

2. Habilita rutas largas en Windows:

   New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force
   

   content_copy

   Este comando requiere privilegios de administrador.