Aby w pełni korzystać z możliwości Compose, pobierz i zainstaluj Android Studio. Zawiera wiele inteligentnych funkcji edytora, takich jak nowe szablony projektów i możliwość natychmiastowego wyświetlania podglądu interfejsu Compose i animacji.
Postępuj zgodnie z tymi instrukcjami, aby utworzyć nowy projekt aplikacji napisanej w Compose, skonfigurować Compose w istniejącym projekcie aplikacji lub zaimportować przykładową aplikację napisaną w Compose.
Tworzenie nowej aplikacji z obsługą Compose
Jeśli chcesz rozpocząć nowy projekt, który domyślnie obsługuje Compose, Android Studio zawiera różne szablony projektów, które pomogą Ci zacząć. Aby utworzyć nowy projekt z prawidłowo skonfigurowanym Compose, wykonaj te czynności:
- Jeśli jesteś w oknie Witamy w Android Studio, kliknij Rozpocznij nowy projekt w Android Studio. Jeśli masz już otwarty projekt Android Studio, na pasku menu wybierz Plik > Nowy > Nowy projekt.
- W oknie Select a Project Template (Wybierz szablon projektu) kliknij Empty Activity (Pusta aktywność), a następnie Next (Dalej).
- W oknie Skonfiguruj projekt wykonaj te czynności:
- Ustaw Nazwę, Nazwę pakietu i Lokalizację zapisu w zwykły sposób. Pamiętaj, że w menu Język jedyną dostępną opcją jest Kotlin, ponieważ Jetpack Compose działa tylko z klasami napisanymi w tym języku.
- W menu Minimalny poziom API wybierz poziom API 21 lub wyższy.
- Kliknij Zakończ.
Możesz teraz zacząć tworzyć aplikację za pomocą Jetpack Compose. Aby zacząć i dowiedzieć się, co możesz zrobić za pomocą tego zestawu narzędzi, wypróbuj samouczek Jetpack Compose.
Konfigurowanie Compose w przypadku istniejącej aplikacji
Najpierw skonfiguruj kompilator Compose za pomocą wtyczki Gradle Compose Compiler.
Następnie dodaj tę definicję do pliku build.gradle aplikacji:
Groovy
android {
buildFeatures {
compose true
}
}
Kotlin
android {
buildFeatures {
compose = true
}
}
Ustawienie flagi compose na true w bloku BuildFeatures Androida włącza funkcje Compose w Android Studio.
Na koniec dodaj BOM Compose i podzbiór zależności biblioteki Compose, których potrzebujesz, do zależności z tego bloku:
Groovy
dependencies {
def composeBom = platform('androidx.compose:compose-bom:2025.10.01')
implementation composeBom
androidTestImplementation composeBom
// Choose one of the following:
// Material Design 3
implementation 'androidx.compose.material3:material3'
// 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 - Add window size utils
implementation 'androidx.compose.material3.adaptive:adaptive'
// Optional - Integration with activities
implementation 'androidx.activity:activity-compose:1.11.0'
// Optional - Integration with ViewModels
implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5'
// 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:2025.10.01")
implementation(composeBom)
androidTestImplementation(composeBom)
// Choose one of the following:
// Material Design 3
implementation("androidx.compose.material3:material3")
// 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 - Add window size utils
implementation("androidx.compose.material3.adaptive:adaptive")
// Optional - Integration with activities
implementation("androidx.activity:activity-compose:1.11.0")
// Optional - Integration with ViewModels
implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5")
// 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 wypróbowanie możliwości Jetpack Compose jest skorzystanie z przykładowych aplikacji Jetpack Compose hostowanych na GitHubie. Aby zaimportować przykładowy projekt aplikacji z Android Studio, wykonaj te czynności:
- Jeśli widzisz okno Witamy w Android Studio, kliknij Importuj przykładowy kod Androida. Jeśli masz już otwarty projekt Android Studio, na pasku menu wybierz Plik > Nowy > Importuj przykład.
- Na pasku wyszukiwania u góry kreatora Przeglądaj przykłady wpisz „compose”.
- Wybierz jedną z przykładowych aplikacji Jetpack Compose z wyników wyszukiwania i kliknij Dalej.
- Zmień nazwę aplikacji i lokalizację projektu lub zachowaj wartości domyślne.
- Kliknij Zakończ.
Android Studio pobierze przykładową aplikację do określonej ścieżki i otworzy projekt. Następnie możesz sprawdzić MainActivity.kt w każdym z przykładów, aby zobaczyć interfejsy API Jetpack Compose, takie jak animacja przejścia, komponenty niestandardowe, używanie typografii oraz wyświetlanie jasnych i ciemnych kolorów w podglądzie w IDE.
Aby używać Jetpack Compose na Wear OS, zapoznaj się z artykułem Konfigurowanie Jetpack Compose na Wear OS.
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy język JavaScript jest wyłączony.
- Nawigowanie za pomocą Compose
- Testowanie układu Compose
- Reagowanie na fokus