Configurar o SDK do Jetpack XR

Dispositivos XR aplicáveis
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos de XR.
Headsets de realidade estendida
Óculos XR com fio
Óculos de IA

Antes de começar a criar, você precisa configurar o SDK do Jetpack XR. Siga as etapas em cada seção para configurar seu ambiente de desenvolvimento com o SDK.

Verificar a compatibilidade do SDK do Android

O SDK do Jetpack para XR exige que seu app use um Android minSdk de 24 e um compileSdk de 34 ou mais recente.

Adicionar dependências de biblioteca

As dependências necessárias para seu app dependem dos tipos de experiências e dispositivos de RV que você está criando. Consulte as seções a seguir para mais informações sobre como adicionar as dependências do app.

Adicionar dependências de biblioteca para experiências imersivas (headsets e óculos de RV)

Primeiro, consulte os guias de referência a seguir para entender as dependências necessárias e os problemas de compatibilidade de cada uma das bibliotecas necessárias:

Em seguida, adicione as dependências necessárias ao arquivo build.gradle.kts do 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")
}

Ativar a minificação de código (opcional)

Se você quiser ativar a minimização e a ofuscação de código usando o ProGuard para seus builds, também será necessário adicionar uma dependência à biblioteca Android Extensions for XR. Isso é necessário para projetos que usam o Jetpack XR alpha05 ou mais recente.

Adicione a seguinte dependência compileOnly ao arquivo build.gradle.kts do 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")
}

Adicionar dependências de biblioteca para experiências aumentadas (óculos de IA)

Primeiro, consulte os guias de referência a seguir para entender as dependências necessárias e os problemas de compatibilidade de cada uma das bibliotecas necessárias:

Em seguida, adicione as dependências necessárias ao arquivo build.gradle.kts do 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")
}