Anatomia de pubspec.yaml
Declare metadados, dependências e restrições.
Anatomia de pubspec.yaml é uma aula grátis de Dart Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Dart Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Dart Academy inclui 4 aulas no total.
Conheça pubspec.yaml
Todo projeto Dart tem um pubspec.yaml em sua raiz. Ele é o manifesto que descreve seu projeto e lista tudo de que ele depende. 📄
Por que YAML
O Dart usa YAML aqui porque ele é legível por humanos: a indentação mostra a estrutura, e você escreve chaves seguidas de dois-pontos e um valor. Não são necessárias chaves.
name: my_app
version: 1.0.0O campo name
O campo name é obrigatório. Ele deve usar letras minúsculas e sublinhados, e se torna o identificador usado por outro código para importar seu pacote.
name: weather_clientDescrição e versão
Adicione uma description curta para que as pessoas saibam o que seu pacote faz, além de uma version que siga o formato major.minor.patch, como 1.2.0.
description: A tiny weather client.
version: 1.2.0A chave environment
A chave environment informa quais versões do Dart SDK seu projeto aceita. As ferramentas se recusam a executar se seu SDK estiver fora desse intervalo.
environment:
sdk: ^3.0.0Dependências de execução
A seção dependencies lista os pacotes de que seu código precisa durante a execução. Cada entrada associa um nome de pacote a uma restrição de versão.
dependencies:
http: ^1.2.0dev_dependencies
Use dev_dependencies para ferramentas necessárias apenas durante o desenvolvimento, como pacotes de teste ou de análise. Elas não são enviadas às pessoas que usam seu pacote.
dev_dependencies:
test: ^1.24.0Restrições de versão com acento circunflexo
Um caret como ^1.2.0 significa qualquer versão a partir de 1.2.0, mas inferior a 2.0.0. Isso permite aceitar atualizações seguras e compatíveis.
http: ^1.2.0A indentação é importante
YAML usa espaços, nunca tabulações, para mostrar níveis. Uma chave desalinhada quebra o arquivo; portanto, mantenha a indentation de dois espaços consistente em todo o arquivo.
dependencies:
http: ^1.2.0Outros campos úteis
Você também pode adicionar os campos homepage, repository e publish_to. Eles fornecem links aos usuários e permitem manter um pacote privado quando necessário.
homepage: https://example.com
publish_to: noneOnde pub faz a leitura
Quando você executa comandos do pub, a ferramenta lê primeiro o pubspec.yaml para conhecer suas dependências e depois busca e resolve tudo para você. 🔧
Verificação rápida
Onde você coloca os pacotes necessários apenas durante o desenvolvimento?
Recapitulação
Você aprendeu que o pubspec.yaml dá nome ao projeto, define o intervalo do SDK e lista as dependências de execução e de desenvolvimento. Ele é o coração de todo projeto Dart. 🎉
Perguntas Frequentes
A aula “Anatomia de pubspec.yaml” é grátis?
Sim — o texto completo de “Anatomia de pubspec.yaml” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Dart Academy, atualize para CoddyKit PRO. O curso de Dart Academy inclui 4 aulas no total.
O que vou aprender em “Anatomia de pubspec.yaml”?
Declare metadados, dependências e restrições. Você pratica Dart Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Dart Academy?
Nenhuma experiência prévia é necessária. Dart Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Anatomia de pubspec.yaml”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Dart Academy?
Sim. Cada aula de Dart Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Anatomia de pubspec.yaml
- Adicionando Dependências com dart pub
- Importações, Exportações e Bibliotecas
- Restrições de Versão e o Arquivo de Bloqueio