Jetpack XR SDK 설정

적용 가능한 XR 기기

이 가이드는 이러한 유형의 XR 기기를 위한 환경을 빌드하는 데 도움이 됩니다.

XR 기기 유형 알아보기 →

XR 기기 유형 알아보기 →

빌드를 시작하려면 먼저 Jetpack XR SDK를 설정해야 합니다. 각 섹션의 단계에 따라 SDK로 개발 환경을 설정하세요.

Android SDK 호환성 확인

Jetpack XR SDK를 사용하려면 앱에서 Android minSdk 24 및 compileSdk 34 이상을 사용해야 합니다.

라이브러리 종속 항목 추가

앱에 필요한 종속 항목은 빌드 중인 환경 및 XR 기기 유형에 따라 다릅니다. 앱의 종속 항목을 추가하는 방법에 관한 자세한 내용은 다음 섹션을 참고하세요.

몰입형 환경 (XR 헤드셋 및 XR 글라스)을 위한 라이브러리 종속 항목 추가

먼저 다음 참조 가이드를 참고하여 각 필수 라이브러리에 필요한 종속 항목 및 호환성 문제를 이해하세요.

• XR 런타임
• Jetpack SceneCore
• XR용 Jetpack Compose
• XR용 Material Design
• Jetpack XR용 ARCore

그런 다음 앱의 build.gradle.kts 파일에 필요한 종속 항목을 추가합니다.

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"
}

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")
}

코드 축소 사용 설정(선택사항)

빌드에 ProGuard를 사용하여 코드 축소 및 난독화를 사용 설정하려면 XR 라이브러리용 Android 확장 프로그램에 종속 항목도 추가해야 합니다. 이는 Jetpack XR alpha05 이상을 사용하는 프로젝트에 필수입니다.

모듈의 build.gradle.kts 파일에 다음 compileOnly 종속 항목을 추가합니다.

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

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

증강 환경 (오디오 및 디스플레이 안경)을 위한 라이브러리 종속 항목 추가

먼저 다음 참조 가이드를 참고하여 각 필수 라이브러리에 필요한 종속 항목 및 호환성 문제를 이해하세요.

• XR 런타임
• Jetpack XR용 ARCore
• Jetpack Compose Glimmer
• Jetpack Projected

그런 다음 앱의 build.gradle.kts 파일에 필요한 종속 항목을 추가합니다.

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha18"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18"
    implementation "androidx.xr.projected:projected:1.0.0-alpha13"
    implementation "androidx.xr.arcore:arcore:1.0.0-beta02"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha18")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18")
    implementation("androidx.xr.projected:projected:1.0.0-alpha13")
    implementation("androidx.xr.arcore:arcore:1.0.0-beta02")
}