Configurar o SDK do Jetpack XR

Dispositivos XR relevantes
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.
Saiba mais sobre esses dispositivos →
Headsets XR
Óculos XR com fio
Óculos com áudio e
tela
Saiba mais sobre esses dispositivos →

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

Verificar a compatibilidade com o SDK do Android

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

Adicionar dependências de biblioteca

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

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

Primeiro, consulte os seguintes guias de referência 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.1.0-alpha02"
    implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01"
    implementation "androidx.xr.compose:compose:1.0.0-beta02"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
    implementation("androidx.xr.compose:compose:1.0.0-beta02")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

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

Se você quiser ativar a minificação e a ofuscação de código usando o ProGuard para seus builds, também precisará adicionar uma dependência às extensões do Android para a biblioteca 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.4.0"
}

Kotlin

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

Adicionar dependências de biblioteca para experiências aumentadas (óculos com áudio e tela)

Primeiro, consulte os seguintes guias de referência 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.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha22"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22"
    implementation "androidx.xr.projected:projected:1.0.0-alpha14"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha22")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22")
    implementation("androidx.xr.projected:projected:1.0.0-alpha14")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}
Anterior
Criar um projeto do Android XR