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 in ogni sezione per configurare l'ambiente di sviluppo con l'SDK.

Verificare la compatibilità dell'SDK Android

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

Aggiungere dipendenze della libreria

Le dipendenze richieste dall'app dipendono dai tipi di esperienze e dispositivi XR per cui stai sviluppando. Per ulteriori informazioni sull'aggiunta delle dipendenze per l'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 per XR
• Material Design per XR
• ARCore per Jetpack XR

Poi, aggiungi le dipendenze necessarie al file build.gradle.kts dell'app:

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

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

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.1.0"
}

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

Aggiungere dipendenze della libreria per esperienze aumentate (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 per Jetpack XR
• Jetpack Compose Glimmer
• Jetpack Projected

Poi, aggiungi le dipendenze necessarie al file build.gradle.kts dell'app:

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha13"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha12"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha12"
    implementation "androidx.xr.projected:projected:1.0.0-alpha07"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha13"
}

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