Restrições de Versão e o Arquivo de Bloqueio

Uma version constraint informa ao pub quais versões de um pacote seu projeto aceita. Ela equilibra a obtenção de correções com a prevenção de alterações incompatíveis. 🎯

Os pacotes Dart seguem o semantic versioning: major.minor.patch. Um aumento da versão major indica alterações incompatíveis; minor adiciona recursos; patch corrige erros.

O caret ^1.2.0 aceita qualquer versão a partir de 1.2.0, mas inferior a 2.0.0. Esse é o padrão conveniente usado pelo pub.

Escrever apenas um número significa exactly essa versão, e nenhuma outra. Use isso com moderação quando precisar de uma única versão conhecida.

Você pode especificar um range com operadores de comparação. Isso oferece controle preciso sobre os limites inferior e superior.

Usar any aceita todas as versões. Isso é arriscado, pois uma futura versão major pode causar problemas; por isso, prefira caret.

Quando o pub resolve suas dependências, ele registra as versões exatas escolhidas em pubspec.lock. Esse arquivo fixa o que todos realmente instalam.

O arquivo de bloqueio garante compilações reproducible: quando um colega executa pub get, obtém exatamente as mesmas versões que você testou, sem atualizações inesperadas.

Para aplicativos, faça commit do pubspec.lock no controle de versão. Para pacotes reutilizáveis, deixe-o de fora para que os consumidores resolvam as versões por conta própria.

Execute dart pub upgrade para atualizar o pubspec.lock para as versões mais recentes permitidas por suas restrições. Um get simples mantém as versões fixadas existentes.

Se dois pacotes exigirem versões incompatíveis, o pub informará um conflict. Então, afrouxe uma restrição ou escolha versões compatíveis dos pacotes.

Agora você sabe interpretar constraints, como caret e intervalos, e sabe que o pubspec.lock fixa versões exatas para compilações reproduzíveis e sem conflitos. 🎉