Nakładanie warstw architektury w Jetpack Compose

Ta strona zawiera ogólny przegląd warstw architektury, z których składa się Jetpack Compose, oraz podstawowych zasad, które determinują ten projekt.

Jetpack Compose nie jest pojedynczym monolitycznym projektem. Jest tworzony z liczby modułów, które są łączone ze sobą, aby utworzyć kompletny pakiet. Poznanie różnych modułów, z których składa się Jetpack Compose, umożliwia:

  • Używaj odpowiedniego poziomu abstrakcji do tworzenia aplikacji lub biblioteki
  • Dowiedz się, kiedy możesz „zejść” na niższy poziom, aby uzyskać większą kontrolę lub dostosować ustawienia
  • Zminimalizuj liczbę zależności

Warstwy

Główne warstwy Jetpack Compose:

Rysunek 1. Główne warstwy Jetpack Compose.

Każda warstwa jest budowana na niższych poziomach, łącząc funkcje w komponenty wyższego poziomu. Każda warstwa opiera się na publicznych interfejsach API niższych warstw, aby weryfikować granice modułu i umożliwiać zastępowanie dowolnej warstwy w razie potrzeby. Przyjrzyjmy się tym warstwom od dołu do góry.

Czas działania
Ten moduł zawiera podstawy dotyczące środowiska wykonawczego Compose, takie jak remember, mutableStateOf, @Composableoraz adnotacjeSideEffect. Jeśli potrzebujesz tylko funkcji zarządzania drzewem w Compose, a nie interfejsu użytkownika, możesz tworzyć bezpośrednio na tej warstwie.
UI
Warstwa interfejsu składa się z wielu modułów (ui-text, ui-graphics, ui-tooling itp.). Te moduły implementują podstawy pakietu narzędzi interfejsu użytkownika, takie jak LayoutNode, Modifier, moduły obsługi danych wejściowych, niestandardowe układy i rysowanie. Jeśli potrzebujesz tylko podstawowych koncepcji dotyczących pakietu narzędzi interfejsu użytkownika, możesz zbudować tę warstwę.
Fundamenty
Ten moduł zawiera elementy konstrukcyjne interfejsu Compose niezależne od systemu projektowania, takie jak Row i Column, LazyColumn, rozpoznawanie konkretnych gestów itp. Możesz tworzyć własne elementy na podstawie warstwy podstawowej, aby tworzyć własny system projektowania.
Materiał
Ten moduł zapewnia implementację systemu Material Design dla interfejsu Compose, oferując system motywów, stylizowane komponenty, animacje fali i ikony. Używaj tej warstwy, gdy używasz w aplikacji Material Design.

Zasady projektowania

Zasada przewodnia Jetpack Compose polega na dostarczaniu małych, skoncentrowanych elementów funkcjonalności, które można łączyć (czyli kompilować), zamiast kilku wielkich komponentów. Takie podejście ma wiele zalet.

Kontrola

Komponenty wyższego poziomu wykonują za Ciebie więcej czynności, ale ograniczają zakres Twojej bezpośredniej kontroli. Jeśli potrzebujesz większej kontroli, możesz „rozwinąć” komponent na niższym poziomie.

Jeśli na przykład chcesz animować kolor komponentu, możesz użyć interfejsu animateColorAsState:

val color = animateColorAsState(if (condition) Color.Green else Color.Red)
ArchitectureLayering.kt

Jeśli jednak chcesz, aby komponent zawsze był szary, nie możesz tego zrobić za pomocą tego interfejsu API. Zamiast tego możesz otworzyć menu i użyć interfejsu API o niższym poziomie Animatable:

val color = remember { Animatable(Color.Gray) }
LaunchedEffect(condition) {
    color.animateTo(if (condition) Color.Green else Color.Red)
}
ArchitectureLayering.kt

Interfejs API animateColorAsState wyższego poziomu jest zbudowany na interfejsie API Animatable niższego poziomu. Korzystanie z interfejsu API niższego poziomu jest bardziej skomplikowane, ale daje większą kontrolę. Wybierz poziom abstrakcji, który najlepiej odpowiada Twoim potrzebom.

Dostosowywanie

W przypadku komponentów wyższego poziomu, które tworzysz z mniejszych elementów, łatwiej jest je w razie potrzeby dostosować. Na przykład implementacja Button udostępniona przez warstwę Material:

@Composable
fun Button(
    // …
    content: @Composable RowScope.() -> Unit
) {
    Surface(/* … */) {
        CompositionLocalProvider(/* … */) { // set LocalContentAlpha
            ProvideTextStyle(MaterialTheme.typography.button) {
                Row(
                    // …
                    content = content
                )
            }
        }
    }
}
ArchitectureLayering.kt

Button składa się z 4 komponentów:

  1. MateriałSurfacez tłem, kształtem, obsługą kliknięć itp.

  2. CompositionLocalProvider, która zmienia przezroczystość treści, gdy przycisk jest włączony lub wyłączony.

  3. A ProvideTextStyle określa domyślny styl tekstu do użycia

  4. Row określa domyślną zasadę układu dla treści przycisku.

Aby uprościć strukturę, pominęliśmy niektóre parametry i komentarze, ale cały komponent składa się z zaledwie około 40 wierszy kodu, ponieważ łączy on te 4 elementy w jeden przycisk. Komponenty takie jak Button mają określone parametry, które udostępniają, aby zachować równowagę między umożliwieniem korzystania z częstych dostosowań a niekontrolowanym wzrostem liczby parametrów, który może utrudnić korzystanie z komponentu. Komponenty Material Design oferują np. opcje dostosowywania określone w systemie Material Design, dzięki czemu łatwiej jest stosować się do jego zasad.

Jeśli jednak chcesz wprowadzić zmiany, które wykraczają poza parametry komponentu, możesz „zejść” o poziom niżej i stworzyć jego wersję. Na przykład Material Design określa, że przyciski powinny mieć jednolite kolorowe tło. Jeśli potrzebujesz tła z gradientem, parametry Button nie obsługują tej opcji. W tym przypadku możesz użyć implementacji Material Button jako odniesienia i utworzyć własny komponent:

@Composable
fun GradientButton(
    // …
    background: List<Color>,
    modifier: Modifier = Modifier,
    content: @Composable RowScope.() -> Unit
) {
    Row(
        // …
        modifier = modifier
            .clickable(onClick = {})
            .background(
                Brush.horizontalGradient(background)
            )
    ) {
        CompositionLocalProvider(/* … */) { // set material LocalContentAlpha
            ProvideTextStyle(MaterialTheme.typography.button) {
                content()
            }
        }
    }
}
ArchitectureLayering.kt

Powyższe rozwiązanie nadal korzysta z komponentów z poziomu warstwy Material, takich jak pojęcia alfa bieżącej zawartości i bieżący styl tekstu. Jednak zastępuje materiał Surface materiałem Row i stylizuje go, aby uzyskać pożądany wygląd.

Jeśli nie chcesz w ogóle używać koncepcji Material Design, na przykład podczas tworzenia własnego systemu projektowania, możesz ograniczyć się do korzystania wyłącznie z elementów warstwy podstawowej:

@Composable
fun BespokeButton(
    // …
    backgroundColor: Color,
    modifier: Modifier = Modifier,
    content: @Composable RowScope.() -> Unit
) {
    Row(
        // …
        modifier = modifier
            .clickable(onClick = {})
            .background(backgroundColor)
    ) {
        // No Material components used
        content()
    }
}
ArchitectureLayering.kt

Jetpack Compose rezerwuje najprostsze nazwy dla komponentów najwyższego poziomu. Na przykład: androidx.compose.material.Text jest oparte na androidx.compose.foundation.text.BasicText. Dzięki temu możesz podać własną implementację z najbardziej rozpoznawalną nazwą, jeśli chcesz zastąpić wyższe poziomy.

Wybór odpowiedniego poziomu abstrakcji

Filozofia tworzenia warstwowych, wielokrotnego użytku komponentów w Compose oznacza, że nie zawsze musisz sięgać po elementy niższego poziomu. Wiele komponentów wyższego poziomu nie tylko oferuje więcej funkcji, ale często implementuje też najlepsze praktyki, takie jak obsługa ułatwień dostępu.

Jeśli np. chcesz dodać obsługę gestów do niestandardowego komponentu, możesz go utworzyć od podstaw za pomocą komponentu Modifier.pointerInput, ale istnieją też inne komponenty wyższego poziomu, które mogą stanowić lepszy punkt wyjścia, np. Modifier.draggable, Modifier.scrollable lub Modifier.swipeable.

Zazwyczaj lepiej jest tworzyć komponenty na najwyższym poziomie, które oferują funkcje potrzebne do korzystania ze sprawdzonych metod.

Więcej informacji

Przykładowy projekt systemu projektowania znajdziesz w pliku Jetsnack sample.