dart install

El comando dart install instala herramientas de CLI de Dart para uso global. Es una alternativa más reciente a dart pub global activate.

Hay algunas formas de instalar un paquete. Para saber más, consulta las siguientes secciones.

El siguiente comando instala en el PATH todos los ejecutables especificados en la sección executables del archivo pubspec.yaml de un paquete.

$ dart install [arguments] <package> [version-constraint]

Por ejemplo:

$ dart install markdown

El siguiente comando especifica un paquete en el sitio pub.dev para su instalación.

$ dart install <pub.dev package>

Por ejemplo:

$ dart install markdown

Los siguientes comandos se pueden utilizar para instalar un paquete en un repositorio de Git.

$ dart install <Git URL>

El siguiente ejemplo instala el paquete async_await desde GitHub:

$ dart install https://github.com/dart-lang/async_await.git

Pub espera encontrar el paquete en la raíz del repositorio de Git. Para especificar una ubicación diferente, usa la opción --git-path con una ruta relativa a la raíz del repositorio:

$ dart install \
  https://github.com/dart-lang/http.git \
  --git-path pkgs/http/

Pub utiliza la rama por defecto del repositorio de Git. Para especificar una rama o commit diferente, usa la opción --git-ref:

$ dart install \
  https://github.com/dart-lang/http.git \
  --git-ref 36f98e900347335af2338a0e087538009b7de2f9

Los siguientes comandos son útiles para instalar, desinstalar y comprobar el estado de instalación de una herramienta de CLI de Dart.

Instala un paquete para Dart.

$ dart install [arguments] <package> [version-constraint]

En el siguiente ejemplo, el paquete markdown se instala sin argumentos ni restricciones de versión:

$ dart install markdown

Desinstala un paquete para Dart.

$ dart uninstall <package>

Por ejemplo:

$ dart uninstall markdown

Comprueba qué paquetes están instalados

$ dart installed

Estas opciones se pueden usar para el comando dart install. Para opciones que se aplican a todos los comandos de pub, consulta Opciones globales.

Usa la opción -h o --help para obtener ayuda para un comando específico. Por ejemplo, los siguientes comandos producen una descripción general y una lista de argumentos disponibles para dart install:

$ dart install --help

$ dart install -h

Usa la opción --git-path para especificar la ruta del paquete en el repositorio de Git.

$ dart install --git-path <path>

Por ejemplo:

$ dart install --git-path https://github.com/dart-lang/async_await.git

Usa la opción --git-ref para especificar la rama o commit de Git que se va a recuperar.

$ dart install --git-ref <ref>

Por ejemplo:

$ dart install --git-ref tmpfixes

Usa la opción --overwrite para sobrescribir cualquier ejecutable global instalado previamente con el mismo nombre. Si no especificas esta bandera, el ejecutable preexistente no será reemplazado.

$ dart install <package> --overwrite

Por ejemplo:

$ dart install markdown --overwrite

Usa la opción --hosted-url para especificar una URL de servidor pub personalizada para el paquete. Esto solo se aplica al usar un nombre de paquete para <package>.

$ dart install --hosted-url <url>

Por ejemplo:

$ dart install --hosted-url https://dart-packages.example.com/

Usa la opción version-constraint para especificar una versión específica del paquete.

$ dart install <package> [version-constraint]

Por ejemplo, el siguiente comando obtiene la versión 0.6.0 del paquete markdown:

$ dart install markdown 0.6.0

Si especificas un rango, pub elige la mejor versión que cumpla con esa restricción. Por ejemplo:

$ dart install foo <3.0.0