dart pub publish auf pub.dev

Wenn Ihr Package bereit ist, bringt ein einziger Befehl es in die Welt. Publishing stellt Ihre Bibliothek auf pub.dev bereit, sodass jeder davon abhängen kann. 🌍

Legen Sie in pubspec.yaml eine eindeutige version nach den Regeln der semantischen Versionierung fest. Major-, Minor- und Patch-Nummer zeigen Benutzern genau, wie umfangreich die Änderungen sind.

Jede Veröffentlichung benötigt einen passenden Eintrag in Ihrem CHANGELOG. Benutzer lesen ihn, um zu entscheiden, ob und wie sie aktualisieren. Beschreiben Sie die Änderungen daher verständlich.

Ein veröffentlichtes Package muss eine LICENSE-Datei enthalten. Sie informiert Benutzer über deren rechtliche Rechte, und pub.dev erkennt gängige Open-Source-Lizenzen automatisch.

Führen Sie publish mit dem dry-run-Flag aus, um alles ohne Hochladen zu validieren. So werden fehlende Dateien oder Warnungen sichtbar, solange sich Änderungen noch leicht vornehmen lassen.

Bei Ihrer ersten Veröffentlichung wird ein Browser geöffnet, in dem Sie sich anmelden. pub.dev verknüpft den Upload mit Ihrem account. Später können Sie weitere Personen als Uploader hinzufügen.

Wenn der Probelauf fehlerfrei ist, entfernen Sie das Flag und veröffentlichen Sie das Package. Der Befehl publish lädt Ihre Dateien hoch und macht die Version innerhalb weniger Sekunden verfügbar.

Sobald eine Version veröffentlicht ist, kann sie nicht gelöscht, sondern nur zurückgezogen werden, um von einer neuen Verwendung abzuraten. Prüfen Sie Ihre Dateien daher sorgfältig, denn ein Fehler bleibt in der Versionshistorie erhalten.

Halten Sie Geheimnisse und überflüssige Dateien aus dem Upload heraus. Dart ignoriert Dateien, die von Ihrer .gitignore erfasst werden. Eine saubere Commit-Praxis sorgt daher für ein aufgeräumtes veröffentlichtes Archiv.

Veröffentlichen Sie unter einem verifizierten Publisher, der mit einer Domain verknüpft ist, die Ihnen gehört. Das Badge schafft Vertrauen und bündelt alle Ihre Pakete unter einer Identität. 🛡️

Erhöhen Sie bei jeder Aktualisierung die Version, ergänzen Sie einen Eintrag im CHANGELOG, führen Sie die Prüfungen erneut aus und veröffentlichen Sie das Paket anschließend wieder. Dieser reibungslose Ablauf wiederholt sich während der gesamten Lebensdauer.

Was ist der sichere erste Schritt, bevor Sie Ihr Paket tatsächlich hochladen?

Sie haben gelernt, eine Version zu erstellen, ein Changelog zu führen, eine Lizenz anzugeben, einen Probelauf durchzuführen und schließlich dart pub publish auszuführen. Ihr Paket ist nun Teil des Ökosystems. 🎉