dart pub publish do pub.dev

Gdy pakiet jest gotowy, jedno polecenie wysyła go w świat. Publikowanie umieszcza bibliotekę na pub.dev, dzięki czemu każdy może od niej zależeć. 🌍

Należy ustawić wyraźny numer wersji w pubspec.yaml zgodnie z wersjonowaniem semantycznym. Numery wersji głównej, mniejszej i poprawkowej dokładnie informują użytkowników o zakresie zmian.

Każde wydanie wymaga odpowiadającego mu wpisu w pliku CHANGELOG. Użytkownicy czytają go, aby zdecydować, czy i jak przeprowadzić aktualizację, dlatego zmiany należy opisywać jasno.

Publikowany pakiet musi zawierać plik LICENSE. Informuje on użytkowników o ich prawach, a pub.dev automatycznie rozpoznaje popularne licencje open source.

Należy uruchomić publish z flagą dry-run, aby sprawdzić wszystko bez przesyłania pakietu. Polecenie ujawni brakujące pliki lub ostrzeżenia, gdy wprowadzanie zmian jest jeszcze łatwe.

Przy pierwszej publikacji otworzy się przeglądarka umożliwiająca zalogowanie. pub.dev powiąże przesłany pakiet z Pana/Pani kontem, a później będzie można dodać inne osoby jako przesyłających.

Gdy uruchomienie próbne zakończy się pomyślnie, należy usunąć flagę i opublikować pakiet. Polecenie publish przesyła pliki i w ciągu kilku sekund udostępnia daną wersję.

Po opublikowaniu wersji nie można jej usunąć, a jedynie wycofać, aby zniechęcić do jej dalszego używania. Proszę dokładnie sprawdzić pliki, ponieważ błąd pozostaje w historii.

Proszę nie dołączać do przesyłanego pakietu danych poufnych ani zbędnych plików. Dart pomija pliki pasujące do reguł w pliku .gitignore, dlatego dbałość o porządek w commitach pomaga utrzymać opublikowane archiwum w czystości.

Proszę publikować w ramach zweryfikowanego wydawcy powiązanego z domeną, której są Państwo właścicielem. Odznaka buduje zaufanie i grupuje wszystkie Państwa pakiety pod jedną tożsamością. 🛡️

Przy każdej aktualizacji proszę zwiększyć numer wersji, dodać wpis w CHANGELOG, ponownie uruchomić testy, a następnie opublikować pakiet. Ten sam płynny cykl będzie się powtarzać przy każdym kolejnym wydaniu.

Jaki jest bezpieczny pierwszy krok przed faktycznym przesłaniem pakietu?

Poznali Państwo sposób wersjonowania, prowadzenia changelogu, dodawania licencji i wykonywania dry-run, a na koniec także używania polecenia dart pub publish. Państwa pakiet należy teraz do ekosystemu. 🎉