Krótkie wprowadzenie

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 i animacji Compose.

Pobierz Android Studio

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:

  1. 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.
  2. W oknie Select a Project Template (Wybierz szablon projektu) kliknij Empty Activity (Pusta aktywność), a następnie Next (Dalej).
  3. W oknie Skonfiguruj projekt wykonaj te czynności:
    1. 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.
    2. W menu Minimalny poziom API wybierz poziom API 21 lub wyższy.
  4. 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 do pliku build.gradle aplikacji tę definicję:

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.05.00')
    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.adaptive:adaptive'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.10.1'
    // 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.05.00")
    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.adaptive:adaptive")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.10.1")
    // 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 Androida Studio, wykonaj te czynności:

  1. 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.
  2. Na pasku wyszukiwania u góry kreatora Przeglądaj przykłady wpisz „compose”.
  3. Wybierz jedną z przykładowych aplikacji Jetpack Compose z wyników wyszukiwania i kliknij Dalej.
  4. Zmień nazwę aplikacji i lokalizację projektu lub zachowaj wartości domyślne.
  5. 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.