Configura el SDK de Jetpack XR

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Visores de realidad extendida
Lentes de realidad extendida con cable
Lentes con IA

Antes de comenzar a compilar, debes configurar el SDK de Jetpack XR. Sigue los pasos de cada sección para configurar tu entorno de desarrollo con el SDK.

Verifica la compatibilidad del SDK de Android

El SDK de XR de Jetpack requiere que tu app use un minSdk de Android de 24 y un compileSdk de 34 o una versión posterior.

Agrega dependencias de bibliotecas

Las dependencias que requiere tu app dependen de los tipos de experiencias y dispositivos de XR para los que la desarrollas. Consulta las siguientes secciones para obtener más información sobre cómo agregar las dependencias de tu app.

Agrega dependencias de bibliotecas para experiencias inmersivas (visores y lentes de XR)

Primero, consulta las siguientes guías de referencia para comprender las dependencias necesarias y los problemas de compatibilidad de cada una de las bibliotecas requeridas:

Luego, agrega las dependencias necesarias al archivo build.gradle.kts de tu app:

Groovy

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

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

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

Kotlin

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

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

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

Habilita la reducción de código (opcional)

Si deseas habilitar la ofuscación y la minimización de código con ProGuard para tus compilaciones, también debes agregar una dependencia en la biblioteca de Android Extensions for XR. Esto es obligatorio para los proyectos que usan XR de Jetpack alpha05 o una versión posterior.

Agrega la siguiente dependencia compileOnly al archivo build.gradle.kts de tu módulo:

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")
}

Agrega dependencias de bibliotecas para experiencias aumentadas (lentes con IA)

Primero, consulta las siguientes guías de referencia para comprender las dependencias necesarias y los problemas de compatibilidad de cada una de las bibliotecas requeridas:

Luego, agrega las dependencias necesarias al archivo build.gradle.kts de tu app:

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha10"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha05"
    implementation "androidx.xr.projected:projected:1.0.0-alpha04"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha10"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha10")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha05")
    implementation("androidx.xr.projected:projected:1.0.0-alpha04")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha10")
}