Aby wygodnie korzystać z funkcji tworzenia wiadomości, pobierz i zainstaluj Android Studio. Zawiera wiele inteligentnych funkcji edytora, np. nowe szablony projektów oraz możliwość natychmiastowego podglądu interfejsu tworzenia wiadomości i animacji.
Wykonaj te instrukcje, aby utworzyć nowy projekt aplikacji Tworzenie, skonfigurować funkcję Utwórz dla istniejącego projektu aplikacji lub zaimportować przykładową aplikację napisaną w sekcji Utwórz.
Tworzenie nowej aplikacji z obsługą tworzenia wiadomości
Jeśli chcesz rozpocząć nowy projekt, który będzie domyślnie zawierał obsługę tworzenia wiadomości, Android Studio zawiera różne szablony, które ułatwią Ci rozpoczęcie pracy. Aby utworzyć nowy projekt z prawidłową konfiguracją tworzenia, wykonaj te czynności:
- Jeśli jesteś w oknie Witamy w Android Studio, kliknij Rozpocznij nowy projekt Android Studio. Jeśli masz już otwarty projekt Android Studio, na pasku menu wybierz Plik > Nowy > Nowy projekt.
- W oknie Wybierz szablon projektu wybierz Puste działanie i kliknij Dalej.
- W oknie Skonfiguruj projekt wykonaj te czynności:
- Ustaw Nazwa, Nazwa pakietu i Zapisz lokalizację tak jak zwykle. Pamiętaj, że w menu Język dostępna jest tylko opcja Kotlin, ponieważ Jetpack Compose działa tylko z klasami napisanymi w języku Kotlin.
- W menu Minimalny poziom interfejsu API wybierz poziom API 21 lub wyższy.
- Kliknij Zakończ.
Możesz już zacząć tworzyć aplikacje przy użyciu Jetpack Compose. Zapoznaj się z samouczkiem Jetpack Compose, aby zacząć korzystać z tego narzędzia i poznać jego możliwości.
Konfigurowanie funkcji Utwórz w istniejącej aplikacji
Aby zacząć korzystać z funkcji tworzenia wiadomości, musisz najpierw dodać do projektu konfiguracje kompilacji. Dodaj tę definicję do pliku build.gradle
aplikacji:
Odlotowy
android {
buildFeatures {
compose true
}
composeOptions {
kotlinCompilerExtensionVersion = "1.5.11"
}
}
Kotlin
android {
buildFeatures {
compose = true
}
composeOptions {
kotlinCompilerExtensionVersion = "1.5.11"
}
}
Kilka uwag:
- Ustawienie flagi
compose
natrue
w bloku AndroidaBuildFeatures
włącza funkcję tworzenia wiadomości. - Obsługa wersji rozszerzenia Kotlin Compiler zdefiniowane w bloku
ComposeOptions
jest powiązana z wersją Kotlin. Zapoznaj się z mapą zgodności i wybierz wersję biblioteki pasującą do wersji Kotlin w Twoim projekcie.
Dodatkowo dodaj do zależności BOM tworzenia wiadomości i podzbiór zależności biblioteki tworzenia wiadomości z poniższego bloku:
Odlotowy
dependencies {
def composeBom = platform('androidx.compose:compose-bom:2024.04.01')
implementation composeBom
androidTestImplementation composeBom
// Choose one of the following:
// Material Design 3
implementation 'androidx.compose.material3:material3'
// or Material Design 2
implementation 'androidx.compose.material:material'
// or skip Material Design and build directly on top of foundational components
implementation 'androidx.compose.foundation:foundation'
// or only import the main APIs for the underlying toolkit systems,
// such as input and measurement/layout
implementation 'androidx.compose.ui:ui'
// Android Studio Preview support
implementation 'androidx.compose.ui:ui-tooling-preview'
debugImplementation 'androidx.compose.ui:ui-tooling'
// UI Tests
androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
debugImplementation 'androidx.compose.ui:ui-test-manifest'
// Optional - Included automatically by material, only add when you need
// the icons but not the material library (e.g. when using Material3 or a
// custom design system based on Foundation)
implementation 'androidx.compose.material:material-icons-core'
// Optional - Add full set of material icons
implementation 'androidx.compose.material:material-icons-extended'
// Optional - Add window size utils
implementation 'androidx.compose.material3:material3-window-size-class'
// Optional - Integration with activities
implementation 'androidx.activity:activity-compose:1.8.2'
// Optional - Integration with ViewModels
implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.6.1'
// Optional - Integration with LiveData
implementation 'androidx.compose.runtime:runtime-livedata'
// Optional - Integration with RxJava
implementation 'androidx.compose.runtime:runtime-rxjava2'
}
Kotlin
dependencies {
val composeBom = platform("androidx.compose:compose-bom:2024.04.01")
implementation(composeBom)
androidTestImplementation(composeBom)
// Choose one of the following:
// Material Design 3
implementation("androidx.compose.material3:material3")
// or Material Design 2
implementation("androidx.compose.material:material")
// or skip Material Design and build directly on top of foundational components
implementation("androidx.compose.foundation:foundation")
// or only import the main APIs for the underlying toolkit systems,
// such as input and measurement/layout
implementation("androidx.compose.ui:ui")
// Android Studio Preview support
implementation("androidx.compose.ui:ui-tooling-preview")
debugImplementation("androidx.compose.ui:ui-tooling")
// UI Tests
androidTestImplementation("androidx.compose.ui:ui-test-junit4")
debugImplementation("androidx.compose.ui:ui-test-manifest")
// Optional - Included automatically by material, only add when you need
// the icons but not the material library (e.g. when using Material3 or a
// custom design system based on Foundation)
implementation("androidx.compose.material:material-icons-core")
// Optional - Add full set of material icons
implementation("androidx.compose.material:material-icons-extended")
// Optional - Add window size utils
implementation("androidx.compose.material3:material3-window-size-class")
// Optional - Integration with activities
implementation("androidx.activity:activity-compose:1.8.2")
// Optional - Integration with ViewModels
implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.6.1")
// Optional - Integration with LiveData
implementation("androidx.compose.runtime:runtime-livedata")
// Optional - Integration with RxJava
implementation("androidx.compose.runtime:runtime-rxjava2")
}
Wypróbuj przykładowe aplikacje Jetpack Compose
Najszybszym sposobem na przetestowanie możliwości Jetpack Compose jest wypróbowanie przykładowych aplikacji Jetpack Compose w serwisie GitHub. Aby zaimportować przykładowy projekt aplikacji z Android Studio, wykonaj te czynności:
- Jeśli jesteś w oknie Witamy w Android Studio, wybierz Import an Android code sample (Importuj przykładowy kod na Androida). Jeśli masz już otwarty projekt Android Studio, na pasku menu wybierz Plik > Nowy > Importuj próbkę.
- Na pasku wyszukiwania u góry kreatora Przeglądaj przykłady wpisz „utwórz”.
- Wybierz z wyników wyszukiwania jedną z przykładowych aplikacji Jetpack Compose i kliknij Dalej.
- Zmień nazwę aplikacji i lokalizację projektu lub zachowaj wartości domyślne.
- Kliknij Zakończ.
Android Studio pobiera przykładową aplikację na podaną ścieżkę i otwiera projekt. Następnie możesz sprawdzić MainActivity.kt
w każdym z przykładów, aby zobaczyć interfejsy Jetpack Compose API, takie jak przenikanie animacji, komponenty niestandardowe, typografia oraz wyświetlanie jasnych i ciemnych kolorów w podglądzie w IDE.
Jeśli chcesz używać Jetpack Compose na Wear OS, przeczytaj artykuł Konfigurowanie Jetpack Compose na Wear OS.
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy JavaScript jest wyłączony
- Nawigacja przy użyciu tworzenia wiadomości
- Testowanie układu tworzenia wiadomości
- Reaguj, aby skupić się