Szybki start

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.

Pobierz Android Studio

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:

  1. 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.
  2. W oknie Wybierz szablon projektu wybierz Puste działanie i kliknij Dalej.
  3. W oknie Skonfiguruj projekt wykonaj te czynności:
    1. 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.
    2. W menu Minimalny poziom interfejsu API wybierz poziom API 21 lub wyższy.
  4. 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 na true w bloku Androida BuildFeatures 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:

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