Strutturare una libreria pubblicabile
Organizzare lib, src e l’API pubblica
Strutturare una libreria pubblicabile è una lezione Dart Academy gratuita su CoddyKit. Questa è la lezione 1 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Dart Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Dart Academy include 4 lezioni in totale.
Un package è semplicemente una cartella
Un package Dart pubblicabile è semplicemente una cartella con un file pubspec.yaml nella radice. Quel singolo file trasforma del codice qualsiasi in qualcosa che pub.dev può ospitare. 📦
La cartella lib è lo spazio pubblico
Tutto ciò che si desidera far importare agli utenti si trova in lib. I file direttamente in lib fanno parte dell'interfaccia pubblica del package, quindi vanno collocati con attenzione.
Nascondere gli interni in lib/src
Il codice che non si vuole esporre va inserito in lib/src. Per convenzione, questi file sono dettagli implementativi privati e non sono destinati all'importazione diretta da parte degli utenti.
lib/
my_package.dart
src/
helper.dartIl file del punto di ingresso
La maggior parte dei package include un file principale in lib, con lo stesso nome del package. Questo punto di ingresso è ciò che gli utenti importano per ottenere l'intera libreria in una volta sola.
import 'package:my_package/my_package.dart';Riesportare con la parola chiave export
Il punto di ingresso usa export per rendere disponibili le parti di lib/src di cui gli utenti hanno effettivamente bisogno. In questo modo si crea un'API pubblica unica, pulita e intenzionale.
export 'src/calculator.dart';
export 'src/parser.dart';Definire con cura l'API pubblica
L'insieme dei nomi esportati costituisce la propria API pubblica. È bene mantenerla ridotta e stabile, perché ogni simbolo esportato è una promessa agli utenti.
Gli underscore indicano la privacy
In Dart, i nomi che iniziano con un underscore sono privati della libreria. Anche all'interno di lib/src, si antepone un underscore agli helper che non si vuole esporre.
int _internalCount = 0;La cartella example
Si aggiunge una cartella example con un piccolo programma eseguibile. Mostra agli utenti come funziona il package e fa guadagnare punti su pub.dev. ✨
I test appartengono a test
I test automatizzati si trovano nella cartella test, al di fuori di lib. Non vengono distribuiti agli utenti, ma dimostrano che il package si comporta come promesso.
I file nella radice sono importanti
Una buona radice del package contiene anche un README, un CHANGELOG e una LICENSE. Questi tre file sono i primi elementi che pub.dev mostra ai visitatori.
Una struttura chiara a colpo d'occhio
Una volta assemblato il tutto, la struttura appare come una mappa: lib per l'API, src per gli interni, oltre a example, test e ai file di metadati.
my_package/
lib/
example/
test/
pubspec.yamlVerifica rapida
Dove si inserisce il codice che deve rimanere un dettaglio implementativo interno?
Riepilogo: una libreria ordinata
Si è appresa la struttura: lib contiene l'API pubblica, lib/src nasconde gli interni ed export definisce ciò che gli utenti vedono. Prima la struttura, poi la pubblicazione. 🚀
Domande Frequenti
La lezione «Strutturare una libreria pubblicabile» è gratuita?
Sì — il testo completo di «Strutturare una libreria pubblicabile» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Dart Academy, passa a CoddyKit PRO. Il corso Dart Academy include 4 lezioni in totale.
Cosa imparerò in «Strutturare una libreria pubblicabile»?
Organizzare lib, src e l’API pubblica Eserciti Dart Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Dart Academy?
Non è richiesta alcuna esperienza precedente. Dart Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 4.
Quanto tempo richiede la lezione «Strutturare una libreria pubblicabile»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Dart Academy?
Sì. Ogni lezione Dart Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Strutturare una libreria pubblicabile
- Documentare con i commenti dartdoc
- Linting, formattazione e punteggio pana
- dart pub publish su pub.dev