Adicionar as dependências necessárias

Este guia fornece instruções para criar um aplicativo Android XR usando o SDK do Jetpack XR. Ele aborda dependências essenciais e configuração de projetos no Android Studio para criar experiências imersivas de XR.

Compatibilidade

O SDK do Jetpack XR exige um minSdk de 24 e precisa ser compilado para o SDK 34 ou mais recente.

Adicionar dependências

Consulte os seguintes guias de referência para entender as dependências necessárias e problemas de compatibilidade de cada uma das bibliotecas no SDK XR do Jetpack:

Em seguida, adicione as dependências necessárias ao arquivo build.gradle.kts do app:

Groovy

dependencies {
    
    // Required for Java
    implementation "com.google.guava:listenablefuture:1.0"
    // Required for Kotlin
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0"

    implementation "androidx.xr.runtime:runtime:1.0.0-alpha05"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha05"
    implementation "androidx.xr.compose:compose:1.0.0-alpha05"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha10"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha05"
}

Kotlin

dependencies {
    
    // Required for Java
    implementation("com.google.guava:listenablefuture:1.0")
    // Required for Kotlin
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-guava:1.9.0")

    implementation("androidx.xr.runtime:runtime:1.0.0-alpha05")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha05")
    implementation("androidx.xr.compose:compose:1.0.0-alpha05")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha10")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha05")
}

Consulte o exemplo do Hello Android XR.

Crie um novo app no Android Studio usando o modelo de atividade básica do headset.

Para criar um novo projeto que inclua o Jetpack Compose para XR, faça o seguinte:

  1. Se estiver na janela Welcome to Android Studio, clique em Start a new Android Studio project. Se você já tiver um projeto aberto no Android Studio, selecione File > New na barra de menus.
  2. Selecione XR nas opções de Modelo e depois Atividade básica do headset.
  3. Na janela Configure your project, faça o seguinte:
    1. Defina o Application name (o nome do app).
    2. Escolha a Project location (a localização do projeto) para o exemplo.
  4. Clique em Finish.
  5. Verifique se o arquivo build.gradle do projeto está configurado corretamente, conforme descrito em Arquivos de propriedade do Gradle.