Começar a usar o SDK Jetpack XR

Este guia fornece instruções para criar um aplicativo Android XR usando o SDK do Jetpack para XR. Ele aborda dependências essenciais e a configuração do projeto 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 {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha07"
    implementation "androidx.xr.compose:compose:1.0.0-alpha07"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha11"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha06"

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

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

Kotlin

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

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

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

Consulte o exemplo do Hello Android XR.

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, adicione uma dependência à biblioteca Android Extensions para 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")
}

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.