Configura l'SDK Jetpack XR

Dispositivi XR applicabili

Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.

Scopri di più sui tipi di dispositivi XR →

Scopri di più sui tipi di dispositivi XR →

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.

Verificare la compatibilità dell'SDK Android

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

Aggiungere dipendenze della libreria

Le dipendenze richieste dalla tua app dipendono dai tipi di esperienze e dispositivi XR per cui stai creando. 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:

• Runtime XR
• Jetpack SceneCore
• Jetpack Compose for XR
• Material Design for XR
• ARCore for Jetpack XR

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha15"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha16"
    implementation "androidx.xr.compose:compose:1.0.0-alpha15"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha15"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha15")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha16")
    implementation("androidx.xr.compose:compose:1.0.0-alpha15")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha15")
}

Attivare la riduzione del codice (facoltativo)

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

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

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

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.3.0")
}

Aggiungere dipendenze della libreria per esperienze di realtà aumentata (occhiali AI)

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

• Runtime XR
• ARCore for Jetpack XR
• Jetpack Compose Glimmer
• Jetpack Projected

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha15"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha13"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha13"
    implementation "androidx.xr.projected:projected:1.0.0-alpha08"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha14"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha15")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha13")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha13")
    implementation("androidx.xr.projected:projected:1.0.0-alpha08")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha14")
}