Organizzare i package nel modulo

Un package raggruppa file Kotlin correlati sotto un nome separato da punti. Package ben organizzati rendono facile esplorare un modulo condiviso in crescita. 📁

Ogni file inizia con una riga package. Dovrebbe rispecchiare il percorso della cartella, così la struttura rimane prevedibile per tutti.

Preferisca raggruppare per funzionalità anziché per tipo. Un package cart comprende modello, logica e helper nello stesso punto.

Una separazione ordinata prevede domain per modelli e regole pure, e data per rete e archiviazione. Il confine mantiene ogni parte focalizzata.

Inizi i package con un nome in ordine inverso di dominio, come com.acme.shared. In questo modo evita conflitti tra il suo codice e i package delle librerie.

Mantenga l’albero delle cartelle coerente con i nomi dei package. Quando coincidono, chiunque può trovare una classe partendo dal suo nome completo.

Inserisca i tipi esposti in un unico package public evidente, come com.acme.shared.api. Chi chiama avrà così un solo punto in cui cercare.

Mantenga gli helper in un package internal, come .impl o .util. Il nome comunica a colpo d’occhio che i chiamanti non dovrebbero accedervi.

Eviti livelli di annidamento infiniti. Un albero superficiale composto da pochi package chiari è più facile da esaminare di dieci livelli di cartelle minuscole.

Usi lo stesso layout di package in commonMain, androidMain e iosMain. Percorsi corrispondenti rendono facili da individuare le coppie expect e actual.

Legga l’elenco dei package dall’alto verso il basso. I soli nomi dovrebbero spiegare che cosa fa il modulo e dove si trova ogni responsabilità.

Raggruppi per funzionalità o livello, rispecchi le cartelle nei package, mantenga una struttura superficiale e nasconda gli interni. Un albero chiaro cresce insieme al modulo. 🎉