Kotlin Multiplatform Academy · Lekcja

Wersjonowanie i stabilność API

Zarządzaj zmianami łamiącymi zgodność i publicznym kontraktem API.

Lekcja 3 z 413 kroki

Wersjonowanie i stabilność API to bezpłatna lekcja Kotlin Multiplatform Academy na CoddyKit. To lekcja 3 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 Kotlin Multiplatform Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Kotlin Multiplatform Academy zawiera 4 lekcji w sumie.

Wersja to obietnica

Gdy zespoły polegają na Twojej bibliotece, numer wersji mówi im, czego mogą oczekiwać po aktualizacji. Traktuj go jak umowę, a nie zgadywanie. 🤝

Wersjonowanie semantyczne

SemVer wykorzystuje trzy liczby: major, minor i patch. Każda z nich sygnalizuje osobny rodzaj zmiany wszystkim, którzy korzystają z Twojego kodu.

version = "2.4.1"

Patch na poprawki

Zwiększ numer patch w przypadku zgodnych wstecznie poprawek błędów. Odbiorcy mogą swobodnie aktualizować bibliotekę bez zmian w swoim kodzie.

Minor na nowe funkcje

Zwiększ numer minor, gdy dodajesz funkcjonalność bez wprowadzania zmian powodujących niezgodność. Istniejące miejsca wywołań nadal będą działać jak wcześniej.

Major na zmiany niezgodne

Zwiększ numer major przy każdej zmianie powodującej niezgodność. Ostrzega to oba zespoły, że aktualizacja może wymagać modyfikacji ich kodu.

Publiczne API wyznacza granicę

Stabilność ocenia się na podstawie publicznego interfejsu. Zmiana nazwy funkcji publicznej psuje kod korzystających z niej osób, ale zmiana prywatnej funkcji pomocniczej już nie.

Ukrywaj elementy, które mogą się zmienić

Oznacz niestabilny kod jako internal, aby nie wchodził w skład umowy z odbiorcami. Możesz go dowolnie refaktoryzować bez zwiększania głównego numeru wersji.

internal fun buildCache() { }

Najpierw oznacz jako przestarzałe

Zapewnij wywołującym łagodne przejście za pomocą @Deprecated. Ich kod nadal się kompiluje, wyświetla ostrzeżenie i informuje, czego należy użyć zamiast tego elementu.

@Deprecated("Use greet(name)")
fun greeting() = greet("there")

Zaproponuj zamiennik

Połącz oznaczenie jako przestarzałe z podpowiedzią ReplaceWith, aby IDE mogło automatycznie naprawić stare miejsca wywołań. Migracja staje się wtedy kwestią jednego kliknięcia.

@Deprecated("Renamed", ReplaceWith("greet(name)"))

Uważaj na przypadkowe zmiany niezgodne

Nawet zmiana kolejności parametrów może zepsuć kod wywołujący napisany w Swifcie. Monitoruj swoje API za pomocą narzędzia dump, aby nieoczekiwane zmiany zostały wykryte podczas przeglądu kodu.

Prowadź changelog

Przejrzysty changelog zawiera listę zmian dla każdej wersji. Zarówno zespoły Android, jak i iOS mogą dzięki niemu planować aktualizacje bez obaw.

Szybki test

Sprawdźmy Twoje wyczucie wersjonowania.

Odpowiedz w interaktywnej lekcji

Podsumowanie

Stosuj SemVer, chroń publiczne API, ukrywaj niestabilny kod za pomocą internal, łagodnie oznaczaj elementy jako przestarzałe i prowadź changelog, któremu ufają oba zespoły. 🎉

Bezpłatny start

Ucz się Kotlin dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 30
Lekcje: 120

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Wersjonowanie i stabilność API” jest bezpłatna?

Tak — pełny tekst „Wersjonowanie i stabilność API” 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 Kotlin Multiplatform Academy, przejdź na CoddyKit PRO. Kurs Kotlin Multiplatform Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Wersjonowanie i stabilność API”?

Zarządzaj zmianami łamiącymi zgodność i publicznym kontraktem API. Ćwiczysz Kotlin Multiplatform 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ąć Kotlin Multiplatform Academy?

Nie wymagamy żadnego doświadczenia. Kotlin Multiplatform 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 3 z 4.

Ile czasu zajmuje lekcja „Wersjonowanie i stabilność API”?

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 Kotlin Multiplatform Academy?

Tak. Każda lekcja Kotlin Multiplatform 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 Kotlin Multiplatform Academy