dart pub global

Global é um dos comandos da ferramenta pub.

A opção global do pub permite que você execute scripts Dart a partir da linha de comando quando não estiver dentro de um pacote. Depois de ativar um pacote, você pode executar scripts do diretório bin desse pacote. Desativar um pacote o remove da sua lista de pacotes disponíveis globalmente.

Por exemplo, digamos que você queira usar o webdev para servir sua aplicação web Dart a partir da linha de comando.

$ dart pub global activate webdev
$ webdev serve

Se isso não funcionar, talvez seja necessário configurar seu PATH.

Para executar um script Dart dentro de um pacote, ou de um pacote do qual o seu pacote depende, consulte dart run.

dart pub global activate [--noexecutables] [--executable=<name>] [--overwrite] <package> [version-constraint]

Ative um pacote quando quiser poder executar um ou mais de seus arquivos executáveis a partir da linha de comando. Você pode ativar pacotes que estão no site pub.dev, em um repositório Git ou na sua máquina local. Depois de ativar um pacote, veja Executar um script para executar scripts do diretório bin do pacote.

Ao ativar um pacote, você pode especificar uma restrição de versão opcional. Veja a flag constraint para exemplos de uso.

$ dart pub global activate <pub.dev package>

Especifique um pacote do site pub.dev para ativá-lo. Por exemplo:

$ dart pub global activate markdown

$ dart pub global activate --source git <Git URL>
$ dart pub global activate -sgit <Git URL>

Use --source git (ou -sgit, para abreviar) para ativar um pacote em um repositório Git. Os exemplos a seguir, que ativam o pacote async_await no GitHub, são equivalentes:

$ dart pub global activate --source git https://github.com/dart-lang/async_await.git
$ dart pub global activate -sgit https://github.com/dart-lang/async_await.git

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

$ dart pub global activate -sgit https://github.com/dart-lang/http.git --git-path pkgs/http/

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

$ dart pub global activate -sgit https://github.com/dart-lang/http.git --git-ref 36f98e900347335af2338a0e087538009b7de2f9

$ dart pub global activate --source path <path>

Use activate --source path <path> para ativar um pacote na sua máquina local. O exemplo a seguir ativa o pacote stopwatch do diretório ~/dart:

$ dart pub global activate --source path ~/dart/stopwatch

Depois que um pacote for ativado, você pode atualizá-lo ativando o pacote novamente.

Você pode executar diretamente um script de um pacote ativado a partir da linha de comando. Se não conseguir executar o script diretamente, também pode usar dart pub global run.

Para executar um script diretamente pela linha de comando, adicione o diretório bin do cache do sistemaPub system cacheUm diretório onde o pub armazena os pacotes remotos baixados. Saiba mais à sua variável de ambiente PATH.

Por exemplo, digamos que você ativou o pacote webdev, mas ainda não consegue executar o comando:

$ dart pub global activate webdev
$ webdev serve
-bash: webdev: command not found

Verifique se o diretório bin do cache do sistema está no seu PATH. A seguinte variável PATH, no macOS, inclui o cache do sistema:

$ echo $PATH
/Users/<user>/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/Users/<user>/.pub-cache/bin

Se esse diretório estiver faltando no seu PATH, localize o arquivo da sua plataforma e adicione-o.

^* A localização exata do cache do sistema pode variar em diferentes versões do Windows.

Agora você pode invocar o comando diretamente:

$ cd web_project
$ webdev serve

Se o script ainda falhar ao ser executado pela linha de comando, o pacote pode não estar configurado para este recurso. Você ainda pode executar o script usando dart pub global run.

$ dart pub global run <package>:<executable> [args...]

Mesmo que um script não esteja configurado para ser executado pela linha de comando, você ainda pode usar dart pub global run. O comando a seguir executa o script bin/bar.dart do pacote foo, passando dois argumentos.

$ dart pub global run foo:bar arg1 arg2

Se você não for um desenvolvedor de pacotes, pode pular esta seção.

Um pacote pode expor alguns de seus scripts como executáveis que podem ser executados diretamente pela linha de comando. O script ou os scripts devem estar listados na entrada executables do arquivo pubspec. Por exemplo, o seguinte arquivo pubspec identifica bin/helloworld.dart como um executável do pacote helloworld:

name: helloworld
​
executables:
  helloworld:

Não listar um script na tag executables reduz a usabilidade do script: scripts não listados podem ser executados com dart pub global run, mas não diretamente pela linha de comando.

$ dart pub global deactivate <package>

Use deactivate para remover um pacote da lista de pacotes globais disponíveis. Por exemplo:

$ dart pub global deactivate markdown

Você não pode mais invocar os scripts do pacote com dart pub global run nem pela linha de comando.

$ dart pub global list

Use list para listar todos os pacotes atualmente ativos.

Para opções que se aplicam a todos os comandos do pub, veja Opções globais.

Use dart pub global activate <package> [version-constraint] para especificar uma versão específica do pacote. Por exemplo, o comando a seguir baixa a versão 0.6.0 do pacote markdown:

$ dart pub global activate markdown 0.6.0

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

$ dart pub global activate foo <3.0.0

Use dart pub global activate <package> --no-executables para ativar globalmente o pacote especificado, mas sem colocar nenhum executável em bin. Você precisa usar dart pub global run para executar qualquer executável.

Use com dart pub global activate para adicionar o executável especificado ao seu PATH. Você pode passar mais de uma dessas flags.

Por exemplo, o comando a seguir adiciona bar e baz (mas nenhum outro executável que foo possa definir) ao seu PATH.

$ dart pub global activate foo -x bar -x baz

Use dart pub global activate <package> --overwrite para sobrescrever quaisquer executáveis globais previamente ativados com o mesmo nome. Se você não especificar esta flag, o executável já existente não será substituído.

ia-translate: true