dart pub add

Add es uno de los comandos de la herramienta pub (pub tool).

$ dart pub add [{dev|override}:]<package>[:<descriptor>] [[{dev|override}:]<package>[:<descriptor>] ...] [options]

Este comando añade los paquetes especificados a pubspec.yaml como dependencias, y luego recupera las dependencias para resolver pubspec.yaml.

El siguiente comando de ejemplo equivale a editar pubspec.yaml para añadir el paquete http, y luego llamar a dart pub get:

$ dart pub add http

Por defecto, dart pub add utiliza la última versión estable del paquete del sitio pub.dev que sea compatible con tus restricciones y dependencias del SDK. Por ejemplo, si 0.13.3 es la última versión estable del paquete http, entonces dart pub add http añade http: ^0.13.3 bajo dependencies en tu pubspec.yaml.

También puedes especificar una restricción o un rango de restricciones:

$ dart pub add foo:2.0.0
$ dart pub add foo:'^2.0.0'
$ dart pub add foo:'>=2.0.0 <3.0.1'

Si el paquete especificado es una dependencia existente en tu pubspec.yaml, dart pub add actualiza la restricción de la dependencia a la especificada en el comando.

El prefijo dev: añade el paquete como una dependencia de desarrollo (dev dependency), en lugar de como una dependencia normal.

$ dart pub add dev:foo           # adds newest compatible stable version of foo
$ dart pub add dev:foo:^2.0.0    # adds specified constraint of foo
$ dart pub add foo dev:bar       # adds regular dependency foo and dev dependency bar simultaneously

Previously the -d, --dev option:

$ dart pub add --dev foo

Para especificar una sobreescritura de dependencia (dependency override), añade el prefijo override: e incluye una restricción de versión u otro descriptor de paquete.

Por ejemplo: Para sobreescribir todas las referencias a package:foo para usar la versión 1.0.0 del paquete, ejecuta el siguiente comando:

$ dart pub add override:foo:1.0.0

Esto añade la sobreescritura a tu archivo pubspec.yaml:

dependency_overrides:
  foo: 1.0.0

Para especificar la versión o el origen de la dependencia (dependency source) al añadir una dependencia, utiliza la sintaxis del descriptor de paquete después del nombre del paquete y dos puntos. Por ejemplo, el siguiente comando añade package:foo como una dependencia de desarrollo utilizando un repositorio de git como origen de la dependencia:

$ dart pub add dev:foo:"{git: https://github.com/foo/foo}"

La sintaxis del descriptor te permite añadir múltiples paquetes de diferentes orígenes como dependencias y aplicar diferentes opciones y restricciones a cada uno.

Para conocer las opciones que se aplican a todos los comandos de pub, consulta Opciones globales.

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).

Informa qué dependencias cambiarían, pero no cambia ninguna.

Por defecto, pub precompila los ejecutables en las dependencias inmediatas (--precompile). Para evitar la precompilación, utiliza --no-precompile.

Por defecto, después de añadir las dependencias especificadas, pub también recupera las dependencias del directorio example/ del paquete (--example). Para omitir la recuperación de dependencias de ejemplo, utiliza --no-example.

En un espacio de trabajo de Pub (Pub workspace), dart pub add añadirá dependencias solo al paquete en el directorio actual.