@ObjCName i API przyjazne dla Swift
Kształtowanie eksportów tak, aby miejsca wywołań w Swift brzmiały naturalnie
@ObjCName i API przyjazne dla Swift to bezpłatna lekcja Kotlin Multiplatform 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 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.
Zadbaj o wygodę programistów Swift
Współdzielony interfejs API powinien brzmieć naturalnie w Swift. Kilka adnotacji i dobrych praktyk sprawi, że most będzie wyglądał natywnie, a nie jak doczepiony element.
Zmień nazwę za pomocą @ObjCName
Adnotacja @ObjCName pozwala nadać typowi lub funkcji inną nazwę po stronie Swift bez zmieniania nazwy w Kotlinie.
@ObjCName("UserService")
class UserRepositoryCzytelniejsze nazwy metod
Używaj @ObjCName także dla funkcji, aby rozwlekła nazwa Kotlin stała się krótkim, idiomatycznym miejscem wywołania w Swift.
@ObjCName("load")
fun loadUserData()Unikaj konfliktów nazw
Kotlin pozwala na przeciążenia, których Obj-C nie potrafi wyrazić. Zmiana nazwy za pomocą @ObjCName zapobiega zniekształconym nazwom, które Swift zobaczyłby w przeciwnym razie.
Ukrywaj za pomocą @HiddenFromObjC
Oznacz wewnętrzne funkcje pomocnicze za pomocą @HiddenFromObjC, aby nigdy nie pojawiały się we frameworku, zachowując małą i przejrzystą powierzchnię API dla Swift.
@HiddenFromObjC
fun internalCache()Argumenty domyślne znikają
Kotlinowe argumenty domyślne nie przechodzą przez most, więc Swift widzi jedną pełną sygnaturę. Jeśli Swift potrzebuje wariantów, udostępnij przeciążenia.
Preferuj proste typy
Na granicy API udostępniaj proste klasy danych i prymitywy. Rozbudowane generyki i hierarchie sealed są niewygodne dla wywołujących je użytkowników Swift.
Uważaj na nazwy właściwości
Właściwość logiczna Kotlin isActive brzmi świetnie w Swift, ale nietypowe nazwy getterów mogą wyglądać niezgrabnie, dlatego nazywaj właściwości z myślą o Swift.
Dokumentuj dla iOS
Dodawaj KDoc do eksportowanych elementów. Część dokumentacji pojawia się w Xcode, pomagając programistom iOS korzystać ze współdzielonego API bez zgadywania.
Testuj miejsca wywołań
Otwórz wygenerowany nagłówek lub plik Swift i rzeczywiście przeczytaj, jak wygląda Twoje API. Jeśli jest niezgrabne, dopracuj adnotacje.
Dopracowany most
Przemyślane nazewnictwo i ukrywanie elementów sprawiają, że współdzielony Kotlin staje się API, które programiści Swift chętnie wykorzystują, ułatwiając współpracę między zespołami.
Szybkie sprawdzenie
Sprawdźmy, do czego służy @ObjCName.
Podsumowanie
Kształtuj eksport za pomocą @ObjCName i @HiddenFromObjC, preferuj proste typy i sprawdzaj rzeczywiste miejsca wywołań w Swift. Przyjazny most ma znaczenie. 🎉
Często zadawane pytania
Czy lekcja „@ObjCName i API przyjazne dla Swift” jest bezpłatna?
Tak — pełny tekst „@ObjCName i API przyjazne dla Swift” 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 „@ObjCName i API przyjazne dla Swift”?
Kształtowanie eksportów tak, aby miejsca wywołań w Swift brzmiały naturalnie Ć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 4 z 4.
Ile czasu zajmuje lekcja „@ObjCName i API przyjazne dla Swift”?
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
- Jak Kotlin mapuje się na Objective-C
- Funkcje suspend jako Swift async
- Zbieranie Flow ze Swift
- @ObjCName i API przyjazne dla Swift