Dart Academy · Aula

Estruturando uma Biblioteca Publicável

Organize lib, src e a API pública.

Estruturando uma Biblioteca Publicável é 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.

Um pacote é apenas uma pasta

Um package Dart que pode ser publicado é simplesmente uma pasta com um pubspec.yaml na raiz. Esse único arquivo transforma código comum em algo que o pub.dev pode hospedar. 📦

A pasta lib é o espaço público

Tudo o que você deseja que os usuários importem fica em lib. Os arquivos diretamente em lib fazem parte da superfície pública do seu pacote; portanto, organize-os com cuidado.

Oculte os elementos internos em lib/src

O código que você não deseja expor deve ficar em lib/src. Por convenção, esses arquivos são detalhes privados de implementação e não devem ser importados diretamente pelos usuários.

lib/
  my_package.dart
  src/
    helper.dart

O arquivo de entrada

A maioria dos pacotes distribui um arquivo principal em lib, com o nome do pacote. Esse ponto de entrada é o arquivo que os usuários importam para obter toda a sua biblioteca de uma só vez.

import 'package:my_package/my_package.dart';

Faça uma reexportação com a palavra-chave export

Seu ponto de entrada usa export para disponibilizar as partes de lib/src de que os usuários realmente precisam. Assim, você organiza uma API pública única, limpa e intencional.

export 'src/calculator.dart';
export 'src/parser.dart';

Defina sua API pública deliberadamente

O conjunto de nomes que você exporta é sua API pública. Mantenha-o pequeno e estável, pois cada símbolo exportado é uma promessa aos usuários.

Sublinhados significam privado

Nomes que começam com um sublinhado são privados da biblioteca em Dart. Mesmo dentro de lib/src, prefixe com um sublinhado os auxiliares que você nunca deseja expor.

int _internalCount = 0;

A pasta example

Adicione uma pasta example com um pequeno programa executável. Ela mostra aos usuários como seu pacote funciona e rende pontos no pub.dev. ✨

Os testes pertencem a test

Os testes automatizados ficam na pasta test, fora de lib. Eles não são enviados aos usuários, mas comprovam que seu pacote se comporta como prometido.

Os arquivos da raiz são importantes

Uma boa raiz de pacote também contém um README, um CHANGELOG e uma LICENSE. Esses três arquivos são a primeira coisa que o pub.dev mostra aos visitantes.

Uma visão geral da organização limpa

Juntando tudo, a estrutura funciona como um mapa: lib para a API, src para os elementos internos, além de example, test e dos arquivos de metadados.

my_package/
  lib/
  example/
  test/
  pubspec.yaml

Verificação rápida

Onde você coloca o código que deve permanecer como um detalhe interno de implementação?

Recapitulação: uma biblioteca organizada

Você aprendeu a organização: lib contém a API pública, lib/src oculta os elementos internos e export seleciona o que os usuários veem. Primeiro, organize; depois, distribua. 🚀

Perguntas Frequentes

A aula “Estruturando uma Biblioteca Publicável” é grátis?

Sim — o texto completo de “Estruturando uma Biblioteca Publicável” é 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 “Estruturando uma Biblioteca Publicável”?

Organize lib, src e a API pública. 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 “Estruturando uma Biblioteca Publicável”?

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

← Voltar para Dart Academy