Cykl życia elementów kompozycyjnych

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Z tej strony dowiesz się więcej o cyklu życia komponentu oraz o tym, jak Compose decyduje, czy komponent wymaga ponownego skompilowania.

Omówienie cyklu życia

Jak wspomniano w dokumentacji dotyczącej zarządzania stanem, kompozycja opisuje interfejs aplikacji i jest generowana przez uruchamianie komponentów. Kompozycja to struktura drzewikowa komponentów, które opisują interfejs użytkownika.

Gdy Jetpack Compose uruchamia komponenty po raz pierwszy, podczas pierwotnej kompozycji śledzi komponenty wywoływane do opisu interfejsu użytkownika w kompozycji. Gdy stan aplikacji się zmieni, Jetpack Compose zaplanowa przetworzenie. Rekompozycja to sytuacja, w której Jetpack Compose ponownie wykonuje komponenty, które mogły ulec zmianie w odpowiedzi na zmiany stanu, a potem aktualizuje kompozycję, aby odzwierciedlić wszelkie zmiany.

Kompozycja może być wygenerowana tylko przez początkową kompozycję i zaktualizowana przez rekompozycję. Jedynym sposobem na zmodyfikowanie kompozycji jest jej ponowne skompilowanie.

Rysunek 1. Cykl życia komponentu w kompozycji. Wchodzi do kompozycji, jest w niej ponownie złożony co najmniej 0 razy i z niej wychodzi.

Rekompozycja jest zwykle wywoływana przez zmianę obiektu State<T>. Compose śledzi te wartości i uruchamia wszystkie komponenty w kompozycji, które odczytują dany State<T>, oraz wszystkie komponenty, które są wywoływane przez te komponenty i których nie można pominąć.

Jeśli kompozyt został wywołany kilka razy, w kompozycji umieszczono wiele jego wystąpień. Każde wywołanie ma własny cykl życia w kompozycji.

@Composable
fun MyComposable() {
    Column {
        Text("Hello")
        Text("World")
    }
}
LifecycleSnippets.kt

Rysunek 2. Przykład MyComposable w kompozycji. Jeśli kompozyt jest wywoływany wielokrotnie, w kompozycji umieszczane są jego liczne wystąpienia. Element o innym kolorze wskazuje, że jest to osobna instancja.

Anatomia kompozytowa w komponowanych

Występowanie kompozytowalnej usługi w kompozycji jest identyfikowane przez jej miejsce wywołania. Kompilator Compose traktuje każde miejsce wywołania jako osobne. Wywoływanie komponentów z wielu miejsc wywołania spowoduje utworzenie wielu instancji komponentu w kompozycji.

Jeśli podczas ponownego tworzenia kompozyt używa innych kompozytów niż podczas poprzedniego tworzenia, Compose określa, które z nich zostały wywołane lub nie, a w przypadku tych, które zostały wywołane w obu kompozycjach, nie tworzy ich ponownie, jeśli ich dane wejściowe się nie zmieniły.

Zachowanie tożsamości jest kluczowe, aby efekty uboczne były powiązane z kompozycją, dzięki czemu mogą zostać ukończone, zamiast uruchamiać się ponownie przy każdej rekompozycji.

Rozważ ten przykład:

@Composable
fun LoginScreen(showError: Boolean) {
    if (showError) {
        LoginError()
    }
    LoginInput() // This call site affects where LoginInput is placed in Composition
}

@Composable
fun LoginInput() { /* ... */ }

@Composable
fun LoginError() { /* ... */ }
LifecycleSnippets.kt

W tym fragmencie kodu funkcja LoginScreen wywołuje kompozyt LoginError warunkowo, a kompozyt LoginInput zawsze. Każde wywołanie ma unikalne miejsce wywołania i źródło, które kompilator wykorzysta do jego jednoznacznej identyfikacji.

Rysunek 3. Reprezentacja LoginScreen w kompozycji, gdy stan się zmienia i występuje ponowne tworzenie kompozycji. Ten sam kolor oznacza, że nie została ona ponownie złożona.

Mimo że funkcja LoginInput została wywołana jako pierwsza, a potem jako druga, instancja funkcji LoginInput będzie zachowana w przypadku kolejnych rekompozycji. Dodatkowo, ponieważ funkcja LoginInput nie zawiera żadnych parametrów, które zmieniłyby się w trakcie rekompozycji, wywołanie funkcji LoginInput zostanie pominięte przez funkcję Compose.

Dodawanie dodatkowych informacji, które ułatwiają inteligentne zmiany składu reklam

Wywoływanie kompozytowanego komponentu wiele razy spowoduje jego wielokrotne dodanie do kompozycji. Gdy wywołujesz kompozyt wielokrotnie z tego samego miejsca wywołania, Compose nie ma żadnych informacji umożliwiających jednoznaczne zidentyfikowanie każdego wywołania tego kompozytu, więc oprócz miejsca wywołania używana jest kolejność wykonania, aby zachować odrębność instancji. Czasami wystarczy takie zachowanie, ale w niektórych przypadkach może ono powodować niepożądane działanie.

@Composable
fun MoviesScreen(movies: List<Movie>) {
    Column {
        for (movie in movies) {
            // MovieOverview composables are placed in Composition given its
            // index position in the for loop
            MovieOverview(movie)
        }
    }
}
LifecycleSnippets.kt

W przykładzie powyżej Compose używa kolejności wykonywania oprócz miejsca wywołania, aby zachować odrębność instancji w kompozycji. Jeśli nowy element movie zostanie dodany do dołu listy, kompozytor może ponownie użyć wystąpień już obecnych w kompozycji, ponieważ ich lokalizacja na liście się nie zmieniła, a więc dane wejściowe movie są takie same w przypadku tych wystąpień.

Rysunek 4. Przykład elementu MoviesScreen w kompozycji, gdy nowy element jest dodawany na końcu listy. Elementy kompozycyjne MovieOverview w kompozycji można ponownie wykorzystać. Ten sam kolor w MovieOverview oznacza, że komponent nie został ponownie skompilowany.

Jeśli jednak lista movies ulegnie zmianie, np. przez dodanie elementów do góry lub pośredniej pozycji na liście, usunięcie elementów lub zmianę ich kolejności, spowoduje to ponowne ułożenie wszystkich wywołań MovieOverview, których parametr wejściowy zmienił pozycję na liście. Jest to bardzo ważne, jeśli na przykład MovieOverview pobiera obraz filmu za pomocą efektu ubocznego. Jeśli rekompozycja zostanie przeprowadzona w trakcie tworzenia efektu, zostanie on anulowany i rozpoczęty ponownie.

@Composable
fun MovieOverview(movie: Movie) {
    Column {
        // Side effect explained later in the docs. If MovieOverview
        // recomposes, while fetching the image is in progress,
        // it is cancelled and restarted.
        val image = loadNetworkImage(movie.url)
        MovieHeader(image)

        /* ... */
    }
}
LifecycleSnippets.kt

Rysunek 5. Przykładowy element MoviesScreen w kompozycji, gdy do listy zostanie dodany nowy element. Komponentów MovieOverview nie można ponownie wykorzystać, a wszystkie efekty uboczne zostaną ponownie uruchomione. Inny kolor w MovieOverview oznacza, że usługa została ponownie skompilowana.

Najlepiej jest traktować tożsamość wystąpienia MovieOverview jako powiązaną z tożsamością przekazanego mu obiektu movie. Jeśli zmienimy kolejność listy filmów, najlepiej będzie uporządkować w taki sam sposób instancje w drzewie kompozycji zamiast ponownie tworzyć każdy element MovieOverview z inną instancją filmu. Dzięki funkcji Compose możesz podać w czasie wykonywania wartości, których chcesz używać do identyfikowania danej części drzewa: kompozyt key.

Owijanie bloku kodu w wywołanie kluczowego komponentu z co najmniej jedną przekazaną wartością powoduje połączenie tych wartości w celu identyfikacji tego wystąpienia w kompozycji. Wartość key nie musi być globalnie unikalna, musi być tylko unikalna wśród wywołań kompozytowych w miejscu wywołania. W tym przykładzie każda movie musi mieć key, który jest unikalny wśród movies. Może się ona dzielić tym key z inną kompozycją w aplikacji.

@Composable
fun MoviesScreenWithKey(movies: List<Movie>) {
    Column {
        for (movie in movies) {
            key(movie.id) { // Unique ID for this movie
                MovieOverview(movie)
            }
        }
    }
}
LifecycleSnippets.kt

Dzięki temu nawet wtedy, gdy elementy na liście ulegną zmianie, funkcja Compose rozpoznaje poszczególne wywołania funkcji MovieOverview i może ich używać ponownie.

Rysunek 6. Przykładowy element MoviesScreen w kompozycji, gdy do listy zostanie dodany nowy element. Składniki MovieOverview mają unikalne klucze, więc Compose rozpoznaje, które instancje MovieOverview się nie zmieniły, i może ich używać ponownie. Ich efekty uboczne będą nadal wykonywane.

Niektóre komponenty mają wbudowaną obsługę komponentu key. Na przykład funkcja LazyColumn akceptuje niestandardowe ustawienie key w języku opisu usługi items.

@Composable
fun MoviesScreenLazy(movies: List<Movie>) {
    LazyColumn {
        items(movies, key = { movie -> movie.id }) { movie ->
            MovieOverview(movie)
        }
    }
}
LifecycleSnippets.kt

pomijanie, jeśli dane wejściowe się nie zmieniły;

Podczas ponownego tworzenia kompozycji można całkowicie pominąć wykonanie niektórych funkcji kompozytowych, jeśli ich dane wejściowe nie zmieniły się od poprzedniej kompozycji.

Funkcja typu „composable” może być pomijana chyba że:

• Funkcja ma typ zwracany inny niż Unit.
• Funkcja jest opatrzona adnotacją @NonRestartableComposable lub @NonSkippableComposable
• Wymagany parametr ma niestabilny typ

Dostępny jest eksperymentalny tryb kompilatora, Strong Skipping, który łagodzi ostatnie wymaganie.

Aby typ został uznany za stabilny, musi być zgodny z tym dokumentem:

• Wynik funkcji equals dla 2 wybranych instancji będzie zawsze taki sam.
• Jeśli publiczna usługa tego typu ulegnie zmianie, Composition zostanie o tym powiadomiony.
• Wszystkie publiczne typy usług są też stabilne.

Istnieją ważne typy wspólne, które mieszczą się w ramach tego kontraktu i będą traktowane przez kompilator Compose jako stabilne, mimo że nie są wyraźnie oznaczone jako stabilne za pomocą adnotacji @Stable:

• Wszystkie typy wartości prymitywnych: Boolean, Int, Long, Float, Char itp.
• Strings
• Wszystkie typy funkcji (lambdas)

Wszystkie te typy mogą przestrzegać umowy stabilnej, ponieważ są niezmienne. Typy niezmienne nigdy się nie zmieniają, więc nie trzeba ich powiadamiać o zmianach w składzie, co znacznie ułatwia przestrzeganie umowy.

Warto zwrócić uwagę na typ MutableState, który jest stabilny, ale może ulec zmianie. Jeśli wartość jest przechowywana w MutableState, obiekt stanu jest ogólnie uważany za stabilny, ponieważ usługa Compose będzie powiadamiana o wszelkich zmianach właściwości .value w State.

Gdy wszystkie typy przekazane jako parametry do komponentu są stabilne, wartości parametrów są porównywane pod kątem równości na podstawie pozycji komponentu w drzewie interfejsu użytkownika. Rekompozycja jest pomijana, jeśli wszystkie wartości są takie same jak w poprzednim wywołaniu.

Compose uznaje typ za stabilny tylko wtedy, gdy może to udowodnić. Na przykład interfejs jest zazwyczaj traktowany jako niestabilny, a typy z zmiennymi właściwościami publicznymi, których implementacja może być niezmienna, również nie są stabilne.

Jeśli Compose nie jest w stanie stwierdzić, że typ jest stabilny, ale chcesz, aby Compose traktował go jako stabilny, oznacz go adnotacją @Stable.

// Marking the type as stable to favor skipping and smart recompositions.
@Stable
interface UiState<T : Result<T>> {
    val value: T?
    val exception: Throwable?

    val hasError: Boolean
        get() = exception != null
}
LifecycleSnippets.kt

W powyższym fragmencie kodu UiState jest interfejsem, więc Compose może uznać ten typ za niestabilny. Dodając adnotację @Stable, informujesz Compose, że ten typ jest stabilny, co pozwala Compose na preferowanie inteligentych przekształceń. Oznacza to też, że Compose będzie traktować wszystkie swoje implementacje jako stabilne, jeśli interfejs jest używany jako typ parametru.