Laden Sie Android Studio herunter und installieren Sie es, um die Entwicklung mit Compose optimal zu nutzen. Sie enthält viele intelligente Editor-Funktionen, z. B. neue Projektvorlagen und die Möglichkeit, sich sofort eine Vorschau der Editor-UI und der Animationen anzeigen zu lassen.
Folgen Sie dieser Anleitung, um ein neues Projekt in der App „Compose“ zu erstellen, die Funktion „Compose“ für ein vorhandenes App-Projekt einzurichten oder eine in Compose geschriebene Beispiel-App zu importieren.
Neue App mit Unterstützung für Compose erstellen
Wenn Sie ein neues Projekt starten möchten, das standardmäßig die Funktion „Schreiben“ unterstützt, bietet Android Studio verschiedene Projektvorlagen, die Ihnen den Einstieg erleichtern. Gehen Sie so vor, um ein neues Projekt zu erstellen, für das die Funktion „Compose“ korrekt eingerichtet ist:
- Wenn Sie sich im Fenster Willkommen bei Android Studio befinden, klicken Sie auf Start a new Android Studio project (Neues Android Studio-Projekt starten). Wenn Sie bereits ein Android Studio-Projekt geöffnet haben, wählen Sie in der Menüleiste File > New > New Project aus.
- Wählen Sie im Fenster Projektvorlage auswählen die Option Leere Aktivität aus und klicken Sie auf Weiter.
- Führen Sie im Fenster Projekt konfigurieren die folgenden Schritte aus:
- Legen Sie Name, Paketname und Speicherort wie gewohnt fest. Im Drop-down-Menü Language (Sprache) ist Kotlin die einzige verfügbare Option, da Jetpack Compose nur mit Klassen funktioniert, die in Kotlin geschrieben sind.
- Wählen Sie im Drop-down-Menü Mindest-API-Level das API-Level 21 oder höher aus.
- Klicken Sie auf Fertig.
Jetzt können Sie mit der Entwicklung einer App mit Jetpack Compose beginnen. In der Jetpack Compose-Anleitung erfahren Sie, wie Sie mit dem Toolkit loslegen.
Compose für eine vorhandene App einrichten
Konfigurieren Sie zuerst den Compose-Compiler mit dem Compose Compiler Gradle-Plug-in.
Füge dann der Datei build.gradle
deiner App die folgende Definition hinzu:
Groovy
android {
buildFeatures {
compose true
}
}
Kotlin
android {
buildFeatures {
compose = true
}
}
Wenn Sie das Flag compose
im Android-Block BuildFeatures
auf true
setzen, wird die Compose-Funktion in Android Studio aktiviert.
Fügen Sie abschließend die Compose-BOM und die erforderlichen Compose-Bibliotheksabhängigkeiten aus dem folgenden Block zu Ihren Abhängigkeiten hinzu:
Groovy
dependencies {
def composeBom = platform('androidx.compose:compose-bom:2024.10.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.adaptive:adaptive'
// Optional - Integration with activities
implementation 'androidx.activity:activity-compose:1.9.2'
// 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:2024.10.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.adaptive:adaptive")
// Optional - Integration with activities
implementation("androidx.activity:activity-compose:1.9.2")
// 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")
}
Beispiel-Apps für Jetpack Compose testen
Am schnellsten können Sie die Funktionen von Jetpack Compose ausprobieren, indem Sie die Jetpack Compose-Beispielanwendungen auf GitHub testen. So importieren Sie ein Beispiel-App-Projekt aus Android Studio:
- Wenn Sie sich im Fenster Willkommen bei Android Studio befinden, wählen Sie Android-Codebeispiel importieren aus. Wenn Sie bereits ein Android Studio-Projekt geöffnet haben, wählen Sie in der Menüleiste File > New > Import Sample aus.
- Geben Sie oben im Assistenten Samples durchsuchen in die Suchleiste „compose“ ein.
- Wählen Sie aus den Suchergebnissen eine Jetpack Compose-Beispielanwendung aus und klicken Sie auf Next (Weiter).
- Ändern Sie entweder den Anwendungsnamen und den Projektspeicherort oder belassen Sie die Standardwerte.
- Klicken Sie auf Fertig.
Android Studio lädt die Beispiel-App an den angegebenen Pfad herunter und öffnet das Projekt. Sie können dann in jedem Beispiel MainActivity.kt
untersuchen, um Jetpack Compose APIs wie Crossfade-Animationen, benutzerdefinierte Komponenten, die Verwendung von Typografie und die Darstellung von hellen und dunklen Farben in der IDE-Vorschau zu sehen.
Informationen zur Verwendung von Jetpack Compose für Wear OS finden Sie unter Jetpack Compose für Wear OS einrichten.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Mit Compose navigieren
- Compose-Layout testen
- Reagiere auf Konzentration