dart pub

El gestor de paquetes pub (pub package manager) tiene una interfaz de línea de comandos que funciona tanto con la herramienta flutter como con la herramienta dart. Con cualquiera de las herramientas, añade el comando pub seguido de un subcomando como get:

$ dart pub get    # Gets dependencies for a non-Flutter package
$ flutter pub get # Gets dependencies for a Flutter package

Este sitio utiliza dart pub <subcomando> para sus ejemplos, pero si tu directorio actual contiene una aplicación Flutter u otro código específico de Flutter, usa flutter pub <subcomando> en su lugar. Para obtener más información, consulta Uso de paquetes en el sitio web de Flutter.

Si encuentras problemas al usar la herramienta pub, consulta Solución de problemas de Pub.

Existe documentación detallada para cada uno de los siguientes subcomandos de pub:

• add
• cache
• deps
• downgrade
• get
• global
• outdated
• publish
• remove
• token
• unpack
• upgrade

Los subcomandos de pub se dividen en las siguientes categorías:

• Gestionar dependencias de paquetes
• Ejecutar aplicaciones de línea de comandos
• Desplegar paquetes y aplicaciones

Pub proporciona una serie de subcomandos para gestionar los paquetes de los que depende tu código.

En este grupo, los subcomandos más utilizados son get y upgrade, que obtienen o actualizan las dependencias utilizadas por un paquete. Cada vez que modifiques un archivo pubspec, ejecuta dart pub get o flutter pub get para asegurarte de que las dependencias estén actualizadas. Algunos IDEs realizan este paso automáticamente al crear un proyecto, o al modificar el pubspec.

cache

Gestiona la caché local de paquetes de pub. Utiliza este subcomando para añadir paquetes a tu caché, o para realizar una reinstalación limpia de todos los paquetes de tu caché.

deps

Enumera todas las dependencias utilizadas por el paquete actual.

downgrade

Obtiene las versiones más bajas de todos los paquetes que están listados como dependencias utilizadas por el paquete actual. Se utiliza para probar el rango inferior de las dependencias de tu paquete.

get

Obtiene los paquetes que están listados como dependencias para el paquete actual. Si ya existe un archivo pubspec.lock, recupera la versión de cada dependencia (si es posible) tal como se indica en el archivo de bloqueo. Crea o actualiza el archivo de bloqueo, según sea necesario.

outdated

Analiza cada paquete del que depende el paquete actual, determina qué dependencias de paquetes están desactualizadas, y te aconseja sobre cómo actualizarlas. Utiliza este subcomando cuando quieras actualizar las dependencias de los paquetes.

upgrade

Obtiene la última versión de cada paquete listado como dependencia utilizada por el paquete actual. Si existe un archivo pubspec.lock, ignora las versiones enumeradas en el archivo de bloqueo y recupera las versiones más nuevas que respeten las restricciones del pubspec. Crea o actualiza el archivo de bloqueo, según sea necesario.

El subcomando global te permite hacer que un paquete esté disponible globalmente, para que puedas ejecutar scripts desde el directorio bin de ese paquete. Para ejecutar scripts disponibles globalmente, debes añadir el directorio bin de la caché del sistema a tu path (ruta).

Con pub puedes publicar paquetes y aplicaciones de línea de comandos.

Para compartir tus paquetes Dart con el mundo, puedes usar el subcomando publish para subir el paquete al sitio de pub.dev. Para obtener información sobre cómo permitir a otros usuarios modificar y subir nuevas versiones de tu paquete, consulta Uploaders (Cargadores).

Para cualquier paquete que contenga scripts (cualquier cosa bajo el directorio bin/), considera añadir la etiqueta executables al archivo pubspec. Cuando un script se incluye bajo executables, los usuarios pueden ejecutar dart pub global activate para que esté disponible directamente desde la línea de comandos.

Varias opciones de línea de comandos funcionan con todos los subcomandos de pub. Estas incluyen:

Imprime información de uso.

Imprime información de depuración cuando ocurre un error.

Equivalente a --verbosity=all.

Ejecuta el comando en el directorio especificado.

Añade color a la salida para dar énfasis (--color). El valor predeterminado depende de si estás usando este comando en un terminal. En un terminal, --color es el valor predeterminado, de lo contrario, --no-color es el valor predeterminado. Utiliza --no-color para desactivar el color en todos los entornos.