dart pub downgrade
Usa dart pub downgrade para obtener las versiones más bajas de todas las dependencias utilizadas por tu aplicación Dart.
Downgrade es uno de los comandos de la herramienta pub (pub tool).
$ dart pub downgrade [--[no-]offline] [-n|--dry-run] [dependencies...]
Sin ningún argumento adicional, dart pub downgrade obtiene las versiones más bajas de
todas las dependencias listadas en el archivo pubspec.yaml
en el directorio de trabajo actual, así como sus dependencias
transitivasDependencia transitivaUna dependencia que un paquete utiliza indirectamente porque
una de sus dependencias la requiere. Obtén más información.
Por ejemplo:
dart pub downgrade
Resolving dependencies... (1.2s)
+ barback 0.13.0
+ collection 0.9.1
+ path 1.2.0
+ source_maps 0.9.0
+ source_span 1.0.0
+ stack_trace 0.9.1
Changed 6 dependencies!
El comando dart pub downgrade crea un archivo de bloqueo (lockfile). Si ya existe uno,
pub ignora ese archivo y genera uno nuevo desde cero, utilizando las versiones más bajas
de todas las dependencias.
Consulta la documentación de dart pub get para obtener más información
sobre la resolución de paquetes y la caché de paquetes del sistema.
Degradación (downgrade) de dependencias específicas
#Es posible indicarle a dart pub downgrade que degrade dependencias específicas a la
versión más baja, dejando el resto de las dependencias sin cambios en la medida de lo
posible. Por ejemplo:
dart pub downgrade test
Resolving dependencies...
barback 0.15.2+2
bot 0.27.0+2
browser 0.10.0+2
chrome 0.6.5
collection 1.1.0
path 1.3.0
pool 1.0.1
source_span 1.0.2
< stack_trace 0.9.2 (was 1.1.1)
stagexl 0.10.2
< test 0.10.0 (was 0.11.4)
These packages are no longer being depended on:
- matcher 0.11.3
Changed 3 dependencies!
Si estás degradando una dependencia específica, pub intenta encontrar las versiones más altas de cualquier dependencia transitiva que se ajuste a las nuevas restricciones de dependencia. Como resultado, las dependencias transitivas también se suelen degradar.
Obtener una nueva dependencia
#Si se añade una dependencia al pubspec antes de ejecutar dart pub downgrade,
esta obtiene la nueva dependencia y cualquiera de sus dependencias transitivas.
Esto comparte el mismo comportamiento que dart pub get.
Eliminar una dependencia
#Si se elimina una dependencia del pubspec antes de ejecutar dart pub downgrade,
la dependencia ya no estará disponible para su importación.
Cualquier dependencia transitiva de la dependencia eliminada también se elimina,
siempre y cuando ninguna de las dependencias inmediatas restantes dependa también de ellas.
Este es el mismo comportamiento que dart pub get.
Degradación (downgrade) estando sin conexión (offline)
#Si no tienes acceso a la red, aún puedes ejecutar dart pub downgrade.
Debido a que pub descarga paquetes en una caché central compartida por todos los paquetes
de tu sistema, a menudo puede encontrar paquetes descargados previamente
sin necesidad de utilizar la red.
Sin embargo, por defecto, dart pub downgrade intenta conectarse si tienes
alguna dependencia alojada.
Si no deseas que pub haga eso, pásale la flag --offline.
En modo sin conexión (offline), pub busca únicamente en la caché local de paquetes,
intentando encontrar un conjunto de versiones que funcionen con tu paquete a partir de lo que ya
está disponible.
Opciones
#Para conocer las opciones que se aplican a todos los comandos de pub, consulta Opciones globales.
--[no-]offline
#
Por defecto, pub se conecta a la red
para recuperar paquetes alojados (--no-offline).
Para usar paquetes almacenados en caché en su lugar, utiliza --offline.
Para más detalles,
consulta Obtener paquetes estando sin conexión (offline).
--dry-run o -n
#
Informa qué dependencias cambiarían pero no cambia ninguna.
--[no-]example
#
Por defecto, pub también degrada las dependencias del
directorio example/ del paquete (--example).
Para omitir la degradación de las dependencias de ejemplo, utiliza --no-example.
--tighten
#
Actualiza los límites inferiores (lower bounds) de las dependencias en pubspec.yaml para que coincidan con las
versiones resueltas, y devuelve una lista de las restricciones modificadas.
Se puede aplicar a dependencias específicas.
En un espacio de trabajo (workspace)
#En un espacio de trabajo de Pub (Pub workspace), dart pub downgrade
degradará todas las dependencias en todo el espacio de trabajo.
A menos que se indique lo contrario, la documentación en este sitio refleja Dart 3.12.2. Página actualizada por última vez el 31-03-2026. Ver fuente oreportar un problema.