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 de 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 Jetpack XR requiere que tu app use un Android minSdk de 24 y un compileSdk de 34 o superior.

Agrega dependencias de bibliotecas

Las dependencias que requiere tu app dependen de los tipos de experiencias y dispositivos de realidad extendida para los que compilas. 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 de realidad extendida y lentes de realidad extendida)

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-alpha12"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha13"
    implementation "androidx.xr.compose:compose:1.0.0-alpha12"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha16"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha12"

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

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

Kotlin

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

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

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

Habilita la minimizació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 Jetpack XR alpha05 o versiones posteriores.

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 de 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-alpha12"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha08"
    implementation "androidx.xr.projected:projected:1.0.0-alpha05"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha11"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha08")
    implementation("androidx.xr.projected:projected:1.0.0-alpha05")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha11")
}