Android XR용 앱 패키징 및 배포

적용 가능한 XR 기기
이 가이드는 이러한 유형의 XR 기기를 위한 환경을 빌드하는 데 도움이 됩니다.
XR 헤드셋
유선 XR 글라스
오디오 글라스

Android XR은 Google Play를 통해 XR 헤드셋, 유선 XR 글라스, 오디오 글라스와 같은 다양한 XR 기기에 앱의 몰입형 및 증강 환경을 제공합니다.

이 가이드를 읽고 Google Play를 통해 Android XR 사용자에게 앱을 준비하고 배포하는 방법을 알아보세요. 또한 다양한 유형의 앱 환경에 관한 사용성 및 품질 기준에 관한 자세한 내용은 Android XR 앱 품질 가이드라인을 참고하세요.

Play 스토어 및 Play Console 시작하기

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

XR 헤드셋, 유선 XR 글라스와 같은 일부 Android XR 기기에서는 사용자가 Play 스토어를 방문하여 기기에 직접 앱을 다운로드할 수 있습니다. 오디오 글라스와 같은 다른 기기에서는 사용자가 컴패니언 기기(예: 휴대전화)에 앱을 다운로드한 후 안경에 연결하여 앱 환경을 제공합니다.

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

Play Console 고객센터에서 시작하는 데 필요한 정보를 확인하세요.

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

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

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

대부분의 앱 프로젝트에서는 최적화된 APK를 제공하는 App Bundle을 빌드하는 데 많은 노력이 필요하지 않습니다. 다음 중 하나를 이미 실행하고 있다면 최적화된 APK 제공 기능이 자동으로 실행됩니다.

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의 경우 빌드하는 앱 환경의 유형에 따라 사용할 수 있는 다양한 출시 트랙이 있습니다.

증강 환경이 포함된 앱의 출시 트랙 선택

오디오 글라스용 앱의 증강 환경을 게시하는 경우 모바일 출시 트랙을 사용하세요. Play Console에는 오디오 글라스 전용 출시 트랙이 없습니다.

오디오 글라스용 기능과 콘텐츠를 기존 모바일 APK에 구현하고 Play Console에서 특정 게시 변경사항 없이 모바일 출시 트랙에 동일한 애셋을 게시할 수 있습니다.

몰입형 환경을 제공하는 앱의 출시 트랙 선택하기

XR 헤드셋 또는 유선 XR 글라스를 위한 몰입형 환경을 제공하는 앱을 빌드하는 경우 다음 두 가지 출시 트랙을 사용할 수 있습니다.

  • 모바일 출시 트랙: 앱이 휴대전화 및 태블릿과 같은 Android 휴대기기에 게시하는 데 사용하는 것과 동일한 트랙입니다.
  • 전용 Android XR 출시 트랙: Android XR 기기에서만 사용할 수 있는 앱 및 앱 변형을 위한 전용 트랙입니다.

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

1. 기존 모바일 앱을 공간화하기

모바일 출시 트랙에 게시된 기존 앱은 Android XR에서 지원되지 않는 기능을 포함하지 않는 한 Android XR 사용자를 위해 Google Play에서 자동으로 검색 가능합니다.

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

모바일 트랙에 계속 게시

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

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

경우에 따라 XR 앱과 모바일 앱의 기능이나 요구사항이 크게 다를 수 있습니다. 예를 들어 XR 앱에 다른 권한 집합이 필요하거나 모바일 및 XR 사용 사례를 모두 제공하도록 리팩터링하기 어려운 매우 다른 기능이 제공될 수 있습니다.

이 경우 Play Console에서 기존에 등록된 앱 항목을 사용하여 XR 환경을 위한 새 APK를 만들 수 있습니다. 이 옵션을 선택하는 경우 다음 사항에 유의하세요.

  • 새 APK는 기존 모바일 앱과 패키지 이름을 공유합니다.
  • 기존 모바일 앱은 모바일 트랙에 계속 게시됩니다.
  • 앱의 새로운 XR 변형이 Android XR 전용 트랙에 게시됩니다.

이 옵션을 사용하면 출시를 더 유연하게 관리할 수 있지만, 출시하고 관리해야 하는 APK가 여러 개이므로 오버헤드가 더 많이 발생합니다.

Android XR 전용 트랙에 게시하려면 앱을 빌드하는 데 사용하는 도구에 따라 앱의 매니페스트에서 다음 기능 중 하나를 선언해야 합니다.

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

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

2. 새 XR 앱 빌드

XR 기기 전용으로 개발된 새 앱의 경우 Android XR 전용 트랙에만 게시해야 합니다.

Android XR 전용 트랙에 게시하려면 앱을 빌드하는 데 사용하는 도구에 따라 앱의 매니페스트에서 다음 기능 중 하나를 선언해야 합니다.

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

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

배지를 사용하여 사용자가 Play 스토어에서 앱을 찾을 수 있도록 지원

빌드하는 XR 환경 유형에 따라 앱은 Play 스토어에서 사용자가 앱의 고품질 XR 환경을 발견하는 데 도움이 되는 배지를 받을 수 있습니다.

차별화된 몰입형 환경을 구축하여 배지를 획득하세요

몰입형 환경을 빌드하고 앱이 Android XR 차별화된 경우 Play 스토어에서 'XR용' 배지가 자동으로 부여됩니다.

차별화된 증강 환경을 구축하여 배지를 획득하세요.

증강 환경을 빌드하는 경우 Play 스토어에서 '스마트 안경에 최적화됨' 배지를 받을 수 있습니다. 이 배지를 받으려면 앱의 증강 환경에 투사된 활동을 구현하세요.

기기 제외 관리

하나 이상의 App Bundle을 Play Console에 업로드하고 나면 사용 가능한 기기 카탈로그를 보고 앱과 호환되는 기기를 확인할 수 있습니다. 앱의 호환 기기를 확인하고 제한하는 방법을 알아보려면 Play Console 고객센터를 방문하세요.

참고 항목


OpenXR™ 및 OpenXR 로고는 Khronos Group Inc. 소유의 상표이며 중국, 유럽 연합, 일본, 영국에서 상표로 등록되어 있습니다.