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.

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:

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha08"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha09"
    implementation "androidx.xr.compose:compose:1.0.0-alpha08"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha12"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha08"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha08"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha08"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha09"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha08"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha08"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha08")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha09")
    implementation("androidx.xr.compose:compose:1.0.0-alpha08")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha12")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha08")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha08")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha08")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha09")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha08")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha08")
}

Vedi l'esempio Hello Android XR.

(Facoltativo) Attiva la minimizzazione del codice

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:

Groovy

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

Kotlin

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.1.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 Welcome to Android Studio (Benvenuto in Android Studio), fai clic su Start a new Android Studio project (Avvia un nuovo progetto Android Studio). Se hai già aperto un progetto Android Studio, seleziona File > Nuovo dalla barra del menu.
  2. Seleziona XR dalle opzioni Modello e poi Attività di base del visore.
  3. Nella finestra Configura il progetto, procedi nel seguente modo:
    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.