Eine veröffentlichbare Bibliothek strukturieren
Strukturieren Sie lib, src und die öffentliche API
Eine veröffentlichbare Bibliothek strukturieren ist eine kostenlose Dart Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Dart Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Dart Academy-Kurs umfasst insgesamt 4 Lektionen.
Ein Package ist nur ein Ordner
Ein veröffentlichbares Dart-package ist einfach ein Ordner mit einer pubspec.yaml-Datei im Stammverzeichnis. Diese eine Datei macht aus einfachem Code etwas, das pub.dev hosten kann. 📦
Der lib-Ordner ist der öffentliche Bereich
Alles, was Benutzer importieren sollen, liegt unter lib. Dateien direkt in lib gehören zur öffentlichen Oberfläche Ihres Packages. Ordnen Sie sie daher sorgfältig an.
Interne Details in lib/src verbergen
Code, den Sie nicht nach außen geben möchten, gehört in lib/src. Diese Dateien gelten konventionell als private Implementierungsdetails und sind nicht für den direkten Import durch Benutzer gedacht.
lib/
my_package.dart
src/
helper.dartDie Einstiegspunktdatei
Die meisten Packages enthalten eine zentrale Datei in lib, die nach dem Package benannt ist. Dieser entry point wird von Benutzern importiert, um die gesamte Bibliothek auf einmal zu erhalten.
import 'package:my_package/my_package.dart';Mit dem export-Schlüssel erneut exportieren
Ihr Einstiegspunkt verwendet export, um die Teile aus lib/src bereitzustellen, die Benutzer tatsächlich benötigen. So stellen Sie eine übersichtliche, bewusst gestaltete öffentliche API zusammen.
export 'src/calculator.dart';
export 'src/parser.dart';Die öffentliche API bewusst festlegen
Die Menge der Namen, die Sie exportieren, bildet Ihre public API. Halten Sie sie klein und stabil, denn jedes exportierte Symbol ist ein Versprechen an Ihre Benutzer.
Unterstriche bedeuten privat
Namen, die mit einem Unterstrich beginnen, sind in Dart library-private. Präfixieren Sie auch innerhalb von lib/src Hilfsmethoden, die nicht nach außen gelangen sollen, mit einem Unterstrich.
int _internalCount = 0;Der example-Ordner
Fügen Sie einen example-Ordner mit einem kleinen ausführbaren Programm hinzu. Er zeigt Benutzern, wie Ihr Package funktioniert, und bringt Ihnen Punkte auf pub.dev. ✨
Tests gehören in test
Automatisierte Tests liegen außerhalb von lib im test-Ordner. Sie werden nicht an Benutzer ausgeliefert, zeigen aber, dass sich Ihr Package wie versprochen verhält.
Dateien im Stammverzeichnis sind wichtig
Ein gutes Package-Stammverzeichnis enthält außerdem eine README, ein CHANGELOG und eine LICENSE. Diese drei Dateien zeigt pub.dev Besuchern als Erstes.
Eine übersichtliche Struktur auf einen Blick
Zusammengenommen liest sich die structure wie eine Karte: lib enthält die API, src die internen Details, ergänzt durch example, test und die Metadatendateien.
my_package/
lib/
example/
test/
pubspec.yamlKurzer Check
Wo platzieren Sie Code, der ein internes Implementierungsdetail bleiben soll?
Zusammenfassung: Eine übersichtliche Bibliothek
Sie haben das layout kennengelernt: lib enthält die öffentliche API, lib/src verbirgt interne Details, und export bestimmt, was Benutzer sehen. Erst die Struktur, dann die Veröffentlichung. 🚀
Häufig gestellte Fragen
Ist die Lektion „Eine veröffentlichbare Bibliothek strukturieren“ kostenlos?
Ja — der vollständige Text von „Eine veröffentlichbare Bibliothek strukturieren“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Dart Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Dart Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Eine veröffentlichbare Bibliothek strukturieren“?
Strukturieren Sie lib, src und die öffentliche API Du übst Dart Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Dart Academy zu starten?
Keine Vorkenntnisse erforderlich. Dart Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 4.
Wie lange dauert die Lektion „Eine veröffentlichbare Bibliothek strukturieren“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Dart Academy-Lektion Code schreiben und ausführen?
Ja. Jede Dart Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Eine veröffentlichbare Bibliothek strukturieren
- Dokumentieren mit dartdoc-Kommentaren
- Linting, Formatierung und pana-Bewertung
- dart pub publish auf pub.dev