dart pub upgrade

Upgrade é um dos comandos da ferramenta pub.

$ dart pub upgrade [options] [dependencies]

Assim como o dart pub get, o dart pub upgrade obtém dependências. A diferença é que o dart pub upgrade ignora qualquer arquivo de bloqueioLockfileUm arquivo chamado pubspec.lock que especifica as versões de cada dependência. Saiba mais existente, para que o pub possa obter as versões mais recentes de todas as dependências. Um comando relacionado é o dart pub outdated, que você pode executar para descobrir dependências desatualizadas.

Sem argumentos adicionais, dart pub upgrade obtém as versões mais recentes de todas as dependências listadas no arquivo pubspec.yaml no diretório de trabalho atual, além de suas dependências transitivasTransitive dependencyUma dependência que um pacote usa indiretamente, porque uma das suas dependências a exige. Saiba mais. Por exemplo:

$ dart pub upgrade
Dependencies upgraded!

Quando dart pub upgrade atualiza as versões das dependências, ele escreve um arquivo de bloqueio para garantir que dart pub get use as mesmas versões dessas dependências. Para pacotes de aplicaçãoApplication packageUm pacote Dart que contém uma aplicação executável. Saiba mais, faça check-in do arquivo de bloqueio no controle de versão; isso garante que o aplicativo tenha exatamente as mesmas versões de todas as dependências para todos os desenvolvedores e quando implantado em produção. Para pacotes comuns, não faça check-in do arquivo de bloqueio, porque espera-se que os pacotes funcionem com uma faixa de versões de dependências.

Se um arquivo de bloqueio já existir, dart pub upgrade o ignora e gera um novo do zero, usando as versões mais recentes de todas as dependências.

Veja a documentação de dart pub get para mais informações sobre resolução de pacotes e o cache de pacotes do sistema.

Você pode dizer ao dart pub upgrade para fazer upgrade de dependências específicas para a versão mais recente, mantendo as demais dependências o mais inalteradas possível. Por exemplo:

$ dart pub upgrade test args
Dependencies upgraded!

Normalmente, nenhuma outra dependência é atualizada; elas permanecem nas versões bloqueadas no arquivo de bloqueio. No entanto, se os upgrades solicitados causarem incompatibilidades com essas versões bloqueadas, elas são desbloqueadas seletivamente até que um conjunto compatível de versões seja encontrado.

Isso significa que fazer upgrade de uma dependência específica não faz upgrade das suas dependências transitivas por padrão.

Para fazer upgrade de uma dependência específica e de todas as suas dependências transitivas para as versões mais recentes, use a flag --unlock-transitive.

$ dart pub upgrade --unlock-transitive test args

Se uma dependência for adicionada ao pubspec antes de dart pub upgrade ser executado, ela obtém a nova dependência e quaisquer das suas dependências transitivas. Isso tem o mesmo comportamento de dart pub get.

Se uma dependência for removida do pubspec antes de dart pub upgrade ser executado, a dependência deixa de estar disponível para importação. Quaisquer dependências transitivas da dependência removida também são removidas, desde que nenhuma dependência imediata restante também dependa delas. Este é o mesmo comportamento de dart pub get.

Se você não tiver acesso à rede, ainda pode executar dart pub upgrade. Como o pub baixa pacotes para um cache central compartilhado por todos os pacotes do seu sistema, ele muitas vezes consegue encontrar pacotes baixados anteriormente sem precisar usar a rede.

No entanto, por padrão, dart pub upgrade tenta acessar a internet se você tiver qualquer dependência hospedada, para que o pub possa detectar versões mais recentes das dependências. Se você não quiser que o pub faça isso, passe a flag --offline. No modo offline, o pub procura apenas no cache de pacotes local, tentando encontrar um conjunto de versões que funcione com o seu pacote a partir do que já está disponível.

Lembre-se de que o pub gera um arquivo de bloqueio. Se a única versão de alguma dependência no seu cache for antiga, o dart pub upgrade offline prende seu aplicativo a essa versão antiga. Na próxima vez que você estiver online, provavelmente vai querer executar dart pub upgrade novamente para atualizar para uma versão mais recente.

O comando dart pub upgrade oferece suporte às opções de dart pub get, e a outras mais. 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 as dependências que seriam alteradas, mas não faz as alterações. Isso é útil se você quiser analisar as atualizações antes de fazê-las.

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, o pub também faz upgrade das dependências do diretório example/ do pacote (--example). Para pular o upgrade das dependências de exemplo, use --no-example.

Obtém os pacotes que o dart pub outdated lista como resolvable, ignorando qualquer restrição de limite superior no arquivo pubspec.yaml. Também atualiza o pubspec.yaml com as novas restrições.

Para verificar quais dependências serão atualizadas, você pode usar dart pub upgrade --major-versions --dry-run.

Atualiza os limites inferiores das dependências em pubspec.yaml para corresponder às versões resolvidas e retorna uma lista das restrições alteradas. Pode ser aplicada a dependências específicas.

Quando usado com uma lista de pacotes para desbloquear, primeiro é calculado o fechamento transitivo das dependências desses pacotes (na resolução atual), e então todos esses pacotes são desbloqueados.

Em um workspace do pub, dart pub upgrade faz upgrade de todas as dependências na resolução compartilhada entre todos os pacotes do workspace.

dart pub upgrade --major-versions e dart pub upgrade --tighten atualizam as restrições em todos os arquivos pubspec.yaml do workspace.

ia-translate: true