Klasy i właściwości expect/actual

expect/actual nie ogranicza się do funkcji. Można również deklarować całe classes, właściwości, a nawet obiekty różniące się na poszczególnych platformach.

Potrzebna jest wartość definiowana osobno na każdej platformie? Zadeklaruj expect val w commonMain i pozwól każdemu celowi dostarczyć własną wartość actual.

Android i iOS dostarczają po jednym elemencie actual val. Wspólny kod traktuje właściwość jak stałą, ale jej wartość jest ustalana osobno dla każdej platformy.

W przypadku bardziej rozbudowanego zachowania zadeklaruj expect class. Wymienia ona elementy dostępne dla wspólnego kodu, a każda platforma uzupełnia ich ciała.

Klasa actual class w androidMain implementuje każdy zadeklarowany element. W tym przykładzie name zwraca ciąg znaków właściwy dla Androida.

Każda klasa actual musi zadeklarować wszystkie elementy obiecane przez expect, z tymi samymi nazwami i typami. Brak jednego powoduje compile error.

Jeśli klasa expect ma konstruktor, oznacz konstruktor platformowy jako actual constructor. Kompilator sprawdzi, czy oba elementy się zgadzają.

We wspólnym kodzie po prostu tworzysz obiekt i korzystasz z niego. Właściwy actual zapewnia implementację obiektu, więc wspólna logika nie musi znać szczegółów platformy.

Klasa actual może dodawać dodatkowe prywatne elementy poza deklaracją expect. Dla wspólnego kodu widoczne jest tylko to, co deklaruje expect.

Użyj właściwości expect dla wartości, funkcji expect dla działania, a klasy expect tylko wtedy, gdy potrzebujesz jednocześnie state i zachowania. ✨

Nowsze wersje Kotlin kierują użytkowników raczej ku interfejsom połączonym z funkcjami expect/actual niż ku elementom expect classes, ale klasy nadal dobrze się sprawdzają.

Wiesz już, że expect/actual obejmuje również właściwości i klasy. Kształt deklaruje się w commonMain, a następnie uzupełnia każdy element w elemencie actual każdej platformy. 🎉