Configura l'SDK Jetpack XR

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Visori XR
Occhiali XR con cavo
AI Glasses

Prima di poter iniziare a creare, devi configurare l'SDK Jetpack XR. Segui i passaggi descritti in ogni sezione per configurare l'ambiente di sviluppo con l'SDK.

Verifica la compatibilità dell'SDK Android

L'SDK Jetpack XR richiede che la tua app utilizzi un minSdk Android 24 e un compileSdk 34 o versioni successive.

Aggiungere dipendenze della libreria

Le dipendenze richieste dalla tua app dipendono dai tipi di esperienze e dai dispositivi XR per cui stai sviluppando. Per ulteriori informazioni sull'aggiunta delle dipendenze per la tua app, consulta le sezioni seguenti.

Aggiungere dipendenze della libreria per esperienze immersive (visori XR e occhiali XR)

Innanzitutto, consulta le seguenti guide di riferimento per comprendere le dipendenze necessarie e i problemi di compatibilità per ciascuna delle librerie richieste:

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

Groovy

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

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

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

Kotlin

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

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

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

(Facoltativo) Attiva la minimizzazione del codice

Se vuoi attivare la minimizzazione e l'offuscamento del codice utilizzando ProGuard per le tue build, devi anche aggiungere una dipendenza dalla libreria Android Extensions for XR. Questo passaggio è obbligatorio 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")
}

Aggiungere dipendenze della libreria per esperienze aumentate (occhiali AI)

Per prima cosa, consulta le seguenti guide di riferimento per comprendere le dipendenze necessarie e i problemi di compatibilità per ciascuna delle librerie richieste:

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha09"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha02"
    implementation "androidx.xr.projected:projected:1.0.0-alpha03"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha02")
    implementation("androidx.xr.proejcted:projected:1.0.0-alpha03")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")
}