Erforderliche Abhängigkeiten hinzufügen

In diesem Leitfaden wird beschrieben, wie Sie mit dem Jetpack XR SDK eine Android XR-Anwendung erstellen. Es werden wichtige Abhängigkeiten und die Projekteinrichtung in Android Studio für die Entwicklung immersiver XR-Erlebnisse behandelt.

Kompatibilität

Für das Jetpack XR SDK ist eine minSdk von 24 erforderlich und es muss für SDK 34 oder höher kompiliert werden.

Abhängigkeiten hinzufügen

In den folgenden Referenzhandbüchern finden Sie Informationen zu den erforderlichen Abhängigkeiten und Kompatibilitätsproblemen für jede der Bibliotheken im Jetpack XR SDK.

Verwendungsbeispiele

Das folgende Snippet aus dem Hello Android XR-Beispiel zeigt eine Beispieldatei „build.gradle“, die alle Abhängigkeiten des Jetpack XR SDK enthält:

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

Hier ist ein Beispiel für die entsprechende libs.toml-Datei:

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

Weitere Informationen finden Sie im Beispiel „Hallo Android XR“.

Mit der Vorlage für die grundlegende Headset-Aktivität eine neue App in Android Studio erstellen

So erstellen Sie ein neues Projekt mit Jetpack Compose for XR:

  1. 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 (Datei > Neu) aus.
  2. Wählen Sie unter Vorlage die Option XR und dann Einfache Headset-Aktivität aus.
  3. Führen Sie im Fenster Projekt konfigurieren die folgenden Schritte aus:
    1. Legen Sie den Namen der Anwendung fest.
    2. Wählen Sie den Speicherort des Projekts für das Beispiel aus.
  4. Klicken Sie auf Fertig.
  5. Prüfen Sie, ob die Datei „build.gradle“ des Projekts wie unter Gradle-Properties-Dateien beschrieben konfiguriert ist.