Ruby Academy · Lekcja

Publikowanie w RubyGems

Wydawanie własnego gema

Publikowanie w RubyGems to bezpłatna lekcja Ruby Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Ruby Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Ruby Academy zawiera 4 lekcji w sumie.

Czym jest RubyGems.org?

RubyGems.org to publiczny serwis, w którym publikuje się i pobiera gemy Ruby. Po uruchomieniu gem install lub bundle install narzędzie domyślnie pobiera stamtąd pakiety.

Publikacja sprawia, że gem można instalować na całym świecie.
Nazwa każdego gema jest unikatowa i przydzielana według zasady „kto pierwszy, ten lepszy”.
Opublikowaną wersję należy traktować jako trwałą.

Utworzenie konta

Przed publikacją potrzebne jest bezpłatne konto RubyGems.org. Następnie należy zalogować się z poziomu wiersza poleceń, aby narzędzie gem mogło uwierzytelniać wysyłane pakiety. Dane uwierzytelniające są przechowywane lokalnie na potrzeby przyszłych publikacji.

Lista kontrolna przed publikacją

Przed wydaniem należy potwierdzić:

Numer wersji został zwiększony.
Testy przechodzą pomyślnie.
Dziennik zmian został zaktualizowany.
Gemspec zawiera wszystkie pliki i właściwą licencję.

Kilka minut kontroli zapobiega opublikowaniu niedziałającej wersji.

checklist = ["version bumped", "tests pass", "changelog updated", "gemspec valid"]
checklist.each { |item| puts "[ ] " + item }

Zbudowanie pakietu

Uruchomienie gem build mygem.gemspec odczytuje plik gemspec i tworzy plik taki jak mygem-0.1.0.gem, zawierający kod oraz metadane. Jest to dokładnie artefakt, który zostanie przesłany.

Testowanie kompilacji lokalnie

Należy zainstalować zbudowany plik w czystym środowisku za pomocą gem install ./mygem-0.1.0.gem, a następnie spróbować go zaimportować. Pozwala to wykryć brakujące pliki lub błędy ładowania, zanim pakiet stanie się dostępny dla wszystkich.

Przesyłanie do RubyGems

Publikowanie odbywa się za pomocą gem push mygem-0.1.0.gem. Po chwili dana wersja pojawi się na RubyGems.org i każdy będzie mógł ją zainstalować. Polecenie korzysta z zapisanych poświadczeń w celu autoryzacji przesyłania.

Wydawanie za pomocą Rake

Gemy utworzone przez Bundler zawierają zadanie rake release. Oznacza ono wersję w git, buduje gem i przesyła go w jednym kroku, dzięki czemu znacznik git i opublikowana wersja zawsze są zgodne.

Nie można ponownie przesłać tej samej wersji

Po opublikowaniu wersji 1.0.0 nie można zastąpić jej innym kodem. Aby naprawić problem, należy opublikować nową wersję, na przykład 1.0.1. Gwarantuje to, że dana wersja zawsze składa się z dokładnie tych samych bajtów u każdego użytkownika.

published = "1.0.0"
fix = "1.0.1"
puts "Cannot overwrite " + published
puts "Publish " + fix + " instead"

Usuwanie wadliwego wydania

Jeśli wersja jest wadliwa lub niebezpieczna, polecenie gem yank mygem -v 1.0.1 usuwa ją z nowych instalacji. Istniejące pliki lock mogą nadal się do niej odwoływać, dlatego usunięcie wersji jest ostatecznością, a nie przyciskiem cofania.

Zabezpieczanie konta

Należy chronić gem przed przejęciem:

Włącz uwierzytelnianie wieloskładnikowe na RubyGems.org.
Używaj kluczy API o ograniczonym zakresie i uprawnieniach.
Dodaj zaufanych współwłaścicieli za pomocą gem owner, aby gem mógł być utrzymywany również wtedy, gdy przestaniesz się nim zajmować.

Po opublikowaniu

Po udostępnieniu pakietu umieść instrukcje instalacji w pliku README, ogłoś wydanie i monitoruj zgłaszane problemy. Na zgłoszenia błędów odpowiadaj, publikując wydania poprawkowe. Utrzymywany gem z czasem buduje zaufanie i zyskuje użytkowników.

Szybki test

Sprawdź swoją wiedzę na temat publikowania.

Podsumowanie: publikowanie w RubyGems

Poznano proces wydawania:

Utworzenie konta i zalogowanie się.
Przeprowadzenie kontroli przed wydaniem, a następnie uruchomienie gem build.
Testowanie lokalne, a następnie uruchomienie gem push (lub rake release).
Wersje są trwałe; poprawki należy publikować jako nowe wersje albo użyć gem yank.
Zabezpieczenie konta za pomocą MFA i współwłaścicieli.

Na tym kończy się kurs Tworzenie własnego gema Ruby.

Często zadawane pytania

Czy lekcja „Publikowanie w RubyGems” jest bezpłatna?

Tak — pełny tekst „Publikowanie w RubyGems” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Ruby Academy, przejdź na CoddyKit PRO. Kurs Ruby Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Publikowanie w RubyGems”?

Wydawanie własnego gema Ćwiczysz Ruby Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Ruby Academy?

Nie wymagamy żadnego doświadczenia. Ruby Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „Publikowanie w RubyGems”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Ruby Academy?

Tak. Każda lekcja Ruby Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Ruby Academy