Android XR용 앱 패키징 및 배포

Android XR은 Google Play를 통해 기존 모바일 앱 카탈로그부터 공간화된 몰입형 XR 환경에 이르기까지 다양한 앱과 환경을 XR 헤드셋에 제공합니다.

이 가이드를 검토하여 Google Play를 통해 Android XR 사용자에게 앱을 준비하고 배포하는 방법을 알아보세요. 사용성 및 품질 기준에 관한 자세한 내용은 Android XR 앱 품질 가이드라인을 참고하세요.

다음 안내를 따라 다음 작업을 수행하세요.

Play 스토어 및 Play Console 시작하기
Android App Bundle 및 크기 제한 알아보기
앱의 출시 트랙 선택
기기 제외 관리

Play 스토어 및 Play Console 시작하기

Play 스토어에 이미 게시된 모바일 앱이 있다면 Android XR용 앱을 게시하는 것이 익숙할 것입니다. Play 스토어 또는 Play Console을 처음 사용하는 경우 다음 리소스를 참고하여 시작하세요.

Android XR을 사용하면 사용자가 XR 헤드셋에서 Play 스토어를 방문하여 앱을 헤드셋에 직접 다운로드할 수 있습니다.

앱을 업로드하고 게시하려면 Play Console 계정이 필요합니다. 기존 Play Console 계정을 사용하여 개발하고 게시하거나, 플랫폼을 처음 사용하는 경우 계정을 만들 수 있습니다.

Play Console 고객센터에서 시작하는 데 필요한 정보를 확인할 수 있습니다.

Google Play 개발자 계정 등록
Google Play 개발자 정책 센터 검토
Play Console을 사용하여 앱 만들기 및 설정
앱의 가격 설정
공개, 비공개 또는 내부 테스트 설정
Android App Bundle 게시 형식 및 App Bundle 탐색기에 대해 알아보기
앱 및 사용자에 관한 보고서, 통계, 유용한 정보 보기

Android App Bundle 및 크기 제한 알아보기

Android App Bundle은 앱의 모든 컴파일된 코드 및 리소스를 포함하며 APK 생성 및 서명을 Google Play에 맡기는 게시 형식입니다.

Google Play는 앱 번들을 사용하여 각 기기 구성에 최적화된 APK를 생성하고 제공하므로 특정 기기에 필요한 코드와 리소스만 다운로드되어 앱이 실행됩니다. 여러 APK를 빌드, 서명, 관리하여 다양한 기기 지원을 최적화할 필요가 없으며 사용자는 더 작고 최적화된 다운로드를 이용할 수 있습니다.

대부분의 앱 프로젝트에서는 최적화된 APK 제공을 지원하는 App Bundle을 쉽게 빌드할 수 있습니다. 다음 중 하나를 이미 실행하고 있다면 최적화된 APK 제공 기능이 자동으로 실행됩니다.

정해진 규칙에 따라 코드와 리소스 정리
Android 스튜디오를 사용하거나 명령줄을 사용하여 서명된 Android App Bundle을 빌드하고 Google Play에 업로드

Google Play의 최대 크기 제한은 Android XR 앱에도 적용됩니다.

특히 앱에 대규모 애셋이 많이 포함된 경우 Android XR 앱에 Play Asset Delivery 또는 Play Feature Delivery를 활용하는 것이 좋습니다. Play Feature Delivery는 App Bundle의 고급 기능을 사용하여 앱의 특정 기능을 조건부로 전송하거나 주문형으로 다운로드할 수 있도록 합니다. Play Asset Delivery는 대량의 게임 애셋을 전송하기 위한 Google Play의 솔루션으로, 유연한 전송 방법과 고성능을 제공합니다.

앱의 출시 트랙 선택

Play Console에서는 앱을 게시하고 관리하는 방법을 선택할 수 있습니다. Android XR의 경우 모바일 출시 트랙 또는 전용 Android XR 출시 트랙의 두 가지 출시 트랙 중에서 선택할 수 있습니다.

선택하는 출시 트랙은 주로 기존 모바일 앱에 공간 UI, 3D 모델 또는 공간 환경을 추가하는지 아니면 새로운 XR 앱을 빌드하는지에 따라 달라집니다. 출시 트랙 옵션에 관한 안내는 다음 섹션을 참고하세요.

기존 모바일 앱 공간화

모바일 출시 트랙에 게시된 기존 앱은 앱에 Android XR에서 지원되지 않는 기능이 포함되어 있지 않은 한 Android XR 사용자가 Google Play에서 자동으로 검색할 수 있습니다.

공간 UI, 3D 모델, 공간 환경과 같은 기능을 추가하여 XR용 모바일 앱을 차별화하는 경우 Android XR 사용자에게 앱을 배포하는 두 가지 옵션이 있습니다. 어떤 경우든 기존 앱과 동일한 패키지 이름을 사용합니다.

모바일 트랙에 계속 게시

대부분의 경우 기존 모바일 APK에 XR 기능이나 콘텐츠를 번들로 묶을 수 있습니다. Play Console에서 특별히 게시 변경사항을 적용할 필요가 없습니다. 기존 APK를 계속 사용하고 모바일 출시 트랙에 동일한 애셋을 게시하면 됩니다. Android XR 사용자가 모바일 출시 트랙의 아티팩트를 받게 됩니다.

Android XR 전용 출시 트랙에 XR 환경 게시

경우에 따라 XR 앱과 모바일 앱의 기능이나 요구사항이 크게 다를 수 있습니다. 예를 들어 XR 앱에 다른 권한 집합이 필요하거나 모바일 및 XR 사용 사례를 모두 지원하도록 리팩터링하기 어려운 매우 다른 기능을 제공할 수 있습니다. 이러한 경우 Play에 등록된 기존 앱 항목을 사용하여 XR 환경의 새 APK를 만들 수 있습니다. 새 APK는 기존 모바일 앱과 패키지 이름을 공유합니다. 기존 모바일 앱은 모바일 트랙에 계속 게시되고 앱의 새 XR 변형은 Android XR 전용 트랙에 게시됩니다.

이 옵션은 버전에 대한 유연성을 높일 수 있지만 출시하고 관리해야 하는 APK가 여러 개이므로 오버헤드가 더 많이 발생합니다. Android XR 전용 트랙에 게시하려면 앱이 Jetpack XR SDK로 빌드되었는지 아니면 OpenXR 또는 Unity로 빌드되었는지에 따라 애플리케이션이 앱 매니페스트에 android.software.xr.api.spatial 기능 또는 android.software.xr.api.openxr을 포함해야 합니다. PackageManager XR 앱 기능에 대해 자세히 알아보세요.

Android XR 전용 트랙에 게시된 앱은 앱 매니페스트에 지정된 내용에 따라 android.software.xr.api.spatial 기능 또는 android.software.xr.api.openxr 기능을 지원하는 Android XR 기기에만 표시됩니다.

Android XR 전용 출시 트랙을 사용하는 방법에 관한 자세한 내용은 Play Console 가이드를 참고하세요.

새 XR 앱 빌드

XR 기기 전용으로 설계된 새 애플리케이션의 경우 Android XR 전용 트랙에만 게시해야 합니다. Android XR 전용 트랙에 게시하려면 앱이 Jetpack XR SDK로 빌드되었는지 아니면 OpenXR 또는 Unity로 빌드되었는지에 따라 앱 매니페스트에 android.software.xr.api.spatial 기능 또는 android.software.xr.api.openxr을 포함해야 합니다. PackageManager XR 앱 기능에 대해 자세히 알아보세요.