Linting, Formatação e Pontuação do pana

Antes de distribuir seu código, o Dart oferece ferramentas para aprimorá-lo automaticamente. As verificações de qualidade detectam problemas cedo e dão ao seu pacote uma aparência profissional. 🧹

O comando dart format reescreve seus arquivos conforme o estilo oficial. Espaçamento e quebras de linha consistentes aparecem instantaneamente, encerrando todas as discussões sobre formatação.

Execute dart analyze para encontrar erros, avisos e padrões arriscados sem executar seu código. É como uma revisão cuidadosa que nunca se cansa.

O arquivo analysis_options.yaml controla quais regras de lint se aplicam. Você pode optar por verificações mais rigorosas ou flexibilizar as que não se adequam ao seu projeto.

Um lint é uma sugestão de estilo ou correção, não um erro obrigatório. Seguir os lints recomendados mantém seu código idiomático e mais fácil de ler para outras pessoas.

A maioria dos pacotes inclui o pacote lints e escolhe seu conjunto recomendado. Uma linha em analysis_options oferece uma lista de regras selecionada e confiável para a comunidade.

A ferramenta pana reproduz exatamente a maneira como o pub.dev pontua seu pacote. Executá-la localmente mostra sua avaliação antes que qualquer outra pessoa a veja.

Seus pontos do pub recompensam o seguimento de convenções, a documentação da API, a aprovação na análise e o suporte a plataformas. Cada categoria contribui para um total público.

Busque uma execução limpa de analyze, sem avisos. O pana desconta pontos por problemas; portanto, eliminá-los aumenta diretamente sua pontuação visível.

Execute format, analyze e testes em sua CI. Cada envio é verificado da mesma maneira, para que problemas nunca cheguem a uma versão publicada. 🤖

Imediatamente antes de publicar, execute format, analyze, test e pana juntos. Essa lista de verificação transforma surpresas no momento do envio em uma publicação tranquila e previsível.

Agora você sabe formatar, analisar, aplicar lint e executar pana para pré-visualizar os pontos do pub. Código limpo hoje significa uma pontuação maior amanhã. ✅