필요한 종속 항목 추가

이 가이드에서는 Jetpack XR SDK를 사용하여 Android XR 애플리케이션을 만드는 방법을 설명합니다. 몰입형 XR 환경을 빌드하기 위한 Android 스튜디오의 필수 종속 항목 및 프로젝트 설정을 다룹니다.

호환성

Jetpack XR SDK에는 minSdk 24가 필요하며 SDK 34 이상으로 컴파일해야 합니다.

종속 항목 추가

Jetpack XR SDK의 각 라이브러리에 필요한 종속 항목과 호환성 문제를 알아보려면 다음 참조 가이드를 참고하세요.

예

Hello Android XR 샘플의 다음 스니펫은 모든 Jetpack XR SDK 종속 항목이 포함된 build.gradle 파일의 예를 보여줍니다.

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

다음은 상응하는 libs.toml 파일의 예입니다.

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

Hello Android XR 샘플을 참고하세요.

Android 스튜디오에서 기본 헤드셋 활동 템플릿을 사용하여 새 앱 만들기

XR용 Jetpack Compose가 포함된 새 프로젝트를 만들려면 다음 단계를 따르세요.

  1. Welcome to Android Studio 창에 있다면 Start a new Android Studio project를 클릭합니다. 이미 Android 스튜디오 프로젝트가 열려 있다면 메뉴 바에서 File > New를 선택합니다.
  2. 템플릿 옵션에서 XR을 선택한 다음 기본 헤드셋 활동을 선택합니다.
  3. Configure your project 창에서 다음을 완료합니다.
    1. Application name을 설정합니다.
    2. 샘플의 Project location을 선택합니다.
  4. Finish를 클릭합니다.
  5. Gradle 속성 파일에 설명된 대로 프로젝트의 build.gradle 파일이 올바르게 구성되었는지 확인합니다.