dart install

O comando dart install instala ferramentas CLI Dart para uso global. É uma alternativa mais recente ao dart pub global activate.

Existem algumas maneiras de instalar um pacote. Para saber mais, consulte as seções a seguir.

O seguinte comando instala todos os executáveis especificados na seção executables do pubspec.yaml de um pacote no PATH.

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

Por exemplo:

$ dart install markdown

O seguinte comando especifica um pacote no site pub.dev para instalar.

$ dart install <pub.dev package>

Por exemplo:

$ dart install markdown

Os seguintes comandos podem ser usados para instalar um pacote em um repositório Git.

$ dart install <Git URL>

O seguinte exemplo instala o pacote async_await do GitHub:

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

Pub espera encontrar o pacote na raiz do repositório Git. Para especificar um local diferente, use a opção --git-path com um caminho relativo à raiz do repositório:

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

Pub usa o branch padrão do repositório Git. Para especificar um branch ou commit diferente, use a opção --git-ref:

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

Os seguintes comandos são úteis para instalar, desinstalar e verificar o estado de instalação de uma ferramenta CLI Dart.

Instala um pacote para Dart.

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

No exemplo a seguir, o pacote markdown é instalado sem argumentos ou restrições de versão:

$ dart install markdown

Desinstalar um pacote para Dart.

$ dart uninstall <package>

Por exemplo:

$ dart uninstall markdown

Verificar quais pacotes estão instalados

$ dart installed

Essas opções podem ser usadas para o comando dart install. Para opções que se aplicam a todos os comandos pub, consulte Global options.

Use a opção -h ou --help para obter ajuda para um comando específico. Por exemplo, os seguintes comandos produzem uma visão geral e lista de argumentos disponíveis para dart install:

$ dart install --help

$ dart install -h

Use a opção --git-path para especificar o caminho do pacote no repositório Git.

$ dart install --git-path <path>

Por exemplo:

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

Use a opção --git-ref para especificar o branch ou commit Git a ser recuperado.

$ dart install --git-ref <ref>

Por exemplo:

$ dart install --git-ref tmpfixes

Use a opção --overwrite para sobrescrever quaisquer executáveis globais previamente instalados com o mesmo nome. Se você não especificar esta flag, o executável preexistente não será substituído.

$ dart install <package> --overwrite

Por exemplo:

$ dart install markdown --overwrite

Use a opção --hosted-url para especificar uma URL de servidor pub personalizada para o pacote. Isso se aplica apenas ao usar um nome de pacote para <package>.

$ dart install --hosted-url <url>

Por exemplo:

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

Use a opção version-constraint para especificar uma versão específica do pacote.

$ dart install <package> [version-constraint]

Por exemplo, o seguinte comando puxa a versão 0.6.0 do pacote markdown:

$ dart install markdown 0.6.0

Se você especificar um intervalo, pub escolhe a melhor versão que atende essa restrição. Por exemplo:

$ dart install foo <3.0.0