Organize pacotes dentro do módulo

Um pacote agrupa arquivos Kotlin relacionados sob um nome separado por pontos. Bons pacotes facilitam a navegação por um módulo compartilhado que está crescendo. 📁

Todo arquivo começa com uma linha de pacote. Ela deve corresponder ao caminho da pasta, para que a estrutura continue previsível para todos.

Prefira agrupar por recurso em vez de agrupar por tipo. Um pacote do carrinho mantém juntos seu modelo, sua lógica e seus auxiliares.

Uma divisão organizada coloca o domínio com os modelos e regras puras, e os dados com a comunicação de rede e o armazenamento. Essa fronteira mantém cada parte focada.

Comece os pacotes com um nome de domínio reverso, como com.acme.shared. Isso impede que seu código entre em conflito com pacotes de bibliotecas.

Mantenha a árvore de pastas correspondente aos nomes dos pacotes. Quando os dois se alinham, qualquer pessoa consegue encontrar uma classe apenas pelo nome completo.

Coloque os tipos que você expõe em um único pacote público e evidente, como com.acme.shared.api. Assim, os chamadores têm um único lugar para procurar.

Mantenha os auxiliares em um pacote interno, como .impl ou .util. O nome indica imediatamente que os chamadores devem ficar fora.

Evite aninhamentos intermináveis. Uma árvore rasa, com alguns pacotes claros, é mais fácil de examinar do que dez camadas de pastas pequenas.

Use o mesmo layout de pacotes em commonMain, androidMain e iosMain. Caminhos correspondentes facilitam localizar pares expect e actual.

Leia sua lista de pacotes de cima para baixo. Apenas os nomes devem explicar o que o módulo faz e onde cada responsabilidade está.

Agrupe por recurso ou camada, replique as pastas nos pacotes, mantenha a estrutura rasa e oculte os elementos internos. Uma árvore clara cresce junto com o módulo. 🎉