dart pub add

Add é um dos comandos da ferramenta pub.

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

Este comando adiciona os pacotes especificados ao pubspec.yaml como dependências e depois recupera as dependências para resolver o pubspec.yaml.

O comando de exemplo a seguir é equivalente a editar o pubspec.yaml para adicionar o pacote http e depois chamar dart pub get:

$ dart pub add http

Por padrão, dart pub add usa a versão estável mais recente do pacote no site pub.dev que é compatível com as restrições do seu SDK e com as suas dependências. Por exemplo, se 0.13.3 é a versão estável mais recente do pacote http, então dart pub add http adiciona http: ^0.13.3 em dependencies no seu pubspec.yaml.

Você também pode especificar uma restrição ou um intervalo de restrições:

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

Se o pacote especificado já for uma dependência no seu pubspec.yaml, dart pub add atualiza a restrição da dependência para a que foi especificada no comando.

O prefixo dev: adiciona o pacote como uma dependência de desenvolvimento, em vez de como uma dependência regular.

$ 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

Anteriormente, a opção -d, --dev:

$ dart pub add --dev foo

Para especificar uma sobreposição de dependência, adicione o prefixo override: e inclua uma restrição de versão ou outro descritor de pacote.

Por exemplo: para sobrepor todas as referências a package:foo e usar a versão 1.0.0 do pacote, execute o seguinte comando:

$ dart pub add override:foo:1.0.0

Isso adiciona a sobreposição ao seu arquivo pubspec.yaml:

dependency_overrides:
  foo: 1.0.0

Para especificar a versão ou a fonte da dependência ao adicionar uma dependência, use a sintaxe de descritor de pacote depois do nome do pacote e de dois-pontos. Por exemplo, o comando a seguir adiciona package:foo como uma dependência de desenvolvimento usando um repositório git como fonte da dependência:

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

A sintaxe de descritor permite que você adicione vários pacotes de diferentes fontes como dependências e aplique opções e restrições diferentes a cada um.

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

ia-translate: true

Por padrão, o pub se conecta à rede para recuperar pacotes hospedados (--no-offline). Para usar pacotes em cache, use --offline. Para detalhes, veja Obtendo enquanto offline.

Informa quais dependências mudariam, mas não altera nenhuma delas.

Por padrão, o pub pré-compila os executáveis das dependências imediatas (--precompile). Para evitar a pré-compilação, use --no-precompile.

Por padrão, depois de adicionar as dependências especificadas, o pub também recupera as dependências do diretório example/ do pacote (--example). Para pular a recuperação das dependências de exemplo, use --no-example.

Em um workspace do pub, dart pub add adiciona dependências somente ao pacote no diretório atual.

ia-translate: true