Aggiungi le dipendenze necessarie

Questa guida fornisce istruzioni per creare un'applicazione Android XR utilizzando l'SDK Jetpack XR. Copre le dipendenze e la configurazione del progetto essenziali in Android Studio per la creazione di esperienze XR immersive.

Compatibilità

L'SDK Jetpack XR richiede un minSdk di 24 e deve essere compilato per l'SDK 34 o versioni successive

Aggiungi dipendenze

Consulta le seguenti guide di riferimento per comprendere le dipendenze necessarie e i problemi di compatibilità per ciascuna delle librerie nell'SDK Jetpack XR

Esempio

Il seguente snippet dell'esempio Hello Android XR mostra un file build.gradle di esempio che include tutte le dipendenze dell'SDK Jetpack XR:

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)
}

Ed ecco un esempio del file libs.toml corrispondente:

[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" }

Consulta l'esempio Hello Android XR.

Creare una nuova app in Android Studio utilizzando il modello di attività di base per gli auricolari

Per creare un nuovo progetto che includa Jetpack Compose per XR, procedi come segue:

  1. Se ti trovi nella finestra Ti diamo il benvenuto in Android Studio, fai clic su Avvia un nuovo progetto Android Studio. Se hai già aperto un progetto Android Studio, selezionate File > Nuovo dalla barra dei menu.
  2. Seleziona XR dalle opzioni Modello e poi Attività di base con cuffie.
  3. Nella finestra Configura il progetto, procedi nel seguente modo:
    1. Imposta il nome dell'applicazione.
    2. Scegli la località del progetto per il tuo sample.
  4. Fai clic su Fine.
  5. Verifica che il file build.gradle del progetto sia configurato correttamente, come descritto in File di proprietà Gradle.