Inizia a utilizzare l'SDK Jetpack XR

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

Compatibilità

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

Aggiungere 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:

Quindi, aggiungi le dipendenze necessarie al file build.gradle.kts della tua app:

Trendy

dependencies {
    
    // Required for Java
    implementation "com.google.guava:listenablefuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha06"
    implementation "androidx.xr.compose:compose:1.0.0-alpha06"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha05"
}

Kotlin

dependencies {
    
    // Required for Java
    implementation("com.google.guava:listenablefuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha06")
    implementation("androidx.xr.compose:compose:1.0.0-alpha06")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

Vedi l'esempio Hello Android XR.

Attiva la minimizzazione del codice (facoltativo)

Se vuoi attivare la minimizzazione e l'offuscamento del codice utilizzando ProGuard per le tue build, devi aggiungere una dipendenza dalla libreria Android Extensions for XR. Questa operazione è necessaria per i progetti che utilizzano Jetpack XR alpha05 o versioni successive.

Aggiungi la seguente dipendenza compileOnly al file build.gradle.kts del modulo:

Trendy

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.0.0"
}

Crea una nuova app in Android Studio utilizzando il modello di attività di base per visore

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

  1. Se ti trovi nella finestra Benvenuto in Android Studio, fai clic su Avvia un nuovo progetto Android Studio. Se hai già aperto un progetto Android Studio, seleziona File > Nuovo dalla barra dei menu.
  2. Seleziona XR dalle opzioni Modello e poi Attività di base del visore.
  3. Nella finestra Configura il progetto:
    1. Imposta il nome dell'applicazione.
    2. Scegli la posizione del progetto per il campione.
  4. Fai clic su Fine.
  5. Verifica che il file build.gradle del progetto sia configurato correttamente, come descritto in File delle proprietà Gradle.