Android XR 개발을 시작하려면 Android XR에 최적화된 새로운 도구와 업데이트가 포함된 최신 Canary 빌드의 Android 스튜디오를 사용하세요.
이 버전의 Android 스튜디오에 포함된 새로운 기능은 다음과 같습니다.
Android XR 에뮬레이터
Layout Inspector에 XR 지원 추가
XR 프로젝트 템플릿
Android XR 에뮬레이터 시스템 요구사항
macOS:
OS: macOS 13.3 이상
CPU/GPU: Apple Silicon (M1 칩 이상)
RAM/VRAM: 16GB 이상
Windows:
OS: Windows 11 이상
CPU: Intel 9세대 이상 또는 AMD Ryzen 1000 시리즈 이상
RAM: 16GB 이상
GPU: NVIDIA GeForce 10 시리즈 이상 또는 AMD Radeon RX 5000 시리즈 이상
VRAM: 8GB 이상
BIOS 설정: 컴퓨터의 BIOS에서 VMX CPU 확장 프로그램을 사용 설정해야 합니다.
XR 개발을 위해 Android 스튜디오 설치 및 구성
다음 단계에 따라 Android 스튜디오를 다운로드하고 개발 환경을 설정하세요.
이미 설치된 Android 스튜디오 버전을 모두 닫아야 합니다.
Android 스튜디오의 최신 Canary 빌드를 다운로드하고 원하는 위치에 추출한 후 애플리케이션을 실행합니다.
마법사의 설치 안내를 따릅니다.
Welcome to Android Studio 대화상자에서 More Actions를 클릭하고 SDK Manager를 선택합니다.
Android SDK 페이지에서 SDK Tools 탭을 클릭하고 다음 도구를 선택하여 설치합니다.
Android SDK 빌드 도구
Android Emulator
Android SDK 플랫폼 도구
API 31~36용 Layout Inspector
SDK Platforms 탭에서 다음을 실행합니다.
Show Package Details 체크박스를 선택하여 모든 옵션을 확인합니다.
Google Play XR ARM 시스템 이미지 (macOS) 또는 Google Play XR Intel x86_64 (Windows)을 선택합니다.
적용을 클릭하여 업데이트를 적용한 다음 확인을 클릭합니다.
모든 설치 단계가 완료되도록 한 다음 Finish(마침)를 클릭합니다.
Android XR 프로젝트 만들기
다음 단계에 따라 Android 스튜디오에서 Android XR 프로젝트를 만들거나 기존 프로젝트를 XR로 확장합니다.
Welcome to Android Studio 창에서 다음 중 하나를 실행합니다.
새 XR 앱을 만드는 경우 새 프로젝트를 클릭하고 다음 단계로 이동합니다.
기존 앱을 공간화하는 경우 열기를 클릭하여 프로젝트를 선택한 다음 다음 단계인 Android Emulator용 새 Android 가상 기기 만들기로 건너뜁니다. (Android XR용 기존 앱의 공간화에 관한 도움말은 XR로 Android 앱을 3D로 가져오기를 참고하세요.)
이 버전은 Android 스튜디오의 개발자 미리보기 버전이므로 이러한 기능 중 상당수가 아직 개발 중입니다. 이러한 도구를 개선할 수 있도록 사용 통계를 사용 설정하고 의견을 보내주세요.
사용 통계를 사용 설정하려면 다음 단계를 따르세요.
설정 > 모양 및 동작 > 시스템 설정 > 데이터 공유를 클릭합니다.
Google에 사용 통계 보내기를 선택합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-01(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-01(UTC)"],[],[],null,["# Set up your development environment\n\nTo get started developing for Android XR, use the latest Canary build of\n[Android Studio](/studio/preview), which includes new tools and updates optimized for Android\nXR.\n| **Note:** Ensure you are using the latest Canary build of Android Studio. Other versions might not include Android XR tools.\n\nNew features included in this version of Android Studio are:\n\n- Android XR Emulator\n- Addition of XR support in the Layout Inspector\n- XR Project template\n\nSystem Requirements for Android XR Emulator\n-------------------------------------------\n\n**For macOS:**\n\n- **OS**: macOS 13.3 or later.\n- **CPU/GPU**: Apple Silicon (M1 chip or newer)\n- **RAM/VRAM**: 16 GB or higher\n\n**For Windows:**\n\n- **OS**: Windows 11 or later.\n- **CPU**: Intel 9th generation or later, or AMD Ryzen 1000-series or later.\n- **RAM**: 16 GB or higher\n- **GPU**: NVIDIA GeForce 10 series or later, or AMD Radeon RX 5000 series or later.\n- **VRAM**: 8 GB or higher\n- **BIOS Settings**: VMX CPU extensions must be enabled in your computer's BIOS\n\n| **Note:** You can check if the VMX CPU extensions are already enabled by attempting to run the 2D Android Emulator. If it runs successfully, no BIOS changes are needed.\n\nInstall and configure Android Studio for XR development\n-------------------------------------------------------\n\nComplete the following steps to download Android Studio and set up your\ndevelopment environment:\n\n1. Make sure to close any versions of Android Studio you already have\n installed.\n\n2. Download the latest Canary build of [Android Studio](/studio/preview), extract it into\n your preferred location, and launch the application.\n\n3. Follow the installation instructions in the wizard.\n\n4. In the **Welcome to Android Studio** dialog, click **More Actions** , and\n select **SDK Manager**.\n\n5. In the **Android SDK** page, click the **SDK Tools** tab and select the\n following tools to install:\n\n - Android SDK Build-Tools\n - Android Emulator\n - Android SDK Platform-Tools\n - Layout Inspector for API 31 - 36\n\n | **Note:** If you had a previous version of Android Studio installed, you may need to recheck these boxes, and click **Apply** to download the latest updates.\n6. Under the **SDK Platforms** tab, do the following:\n\n 1. Select the **Show Package Details** checkbox to see all the options.\n 2. Select the **Google Play XR ARM** system image (macOS) or **Google Play\n XR Intel x86_64** (Windows).\n\n 1. Click **Apply** to make the updates, and then click **OK**.\n 2. Allow all the installation steps to complete, then click **Finish**.\n\nCreate an Android XR project\n----------------------------\n\nFollow these steps to create an Android XR project in Android Studio or extend\nan existing project to XR.\n\n1. In the **Welcome to Android Studio** window, do one of the following:\n\n 1. If you're creating a new XR app, click **New Project** and go to the next step.\n 2. If you're spatializing an existing app, click **Open** to select your project, then skip to the next step Create a new Android Virtual Device for the Android Emulator. (For help with spatializing your existing app for Android XR, read [Bring your Android app into 3D with XR](/develop/xr/jetpack-xr-sdk/add-xr-to-existing))\n\n2. In the **XR** category, select the **Basic Headset Activity** template and\n click **Next**.\n\n3. On the next screen you can choose a name for your project. You can leave the\n default settings in place. Then click **Finish**.\n\n4. Explore the code provided in the template. Check out our [development\n guide](/develop/xr/jetpack-xr-sdk/develop-ui) and [reference documentation](/jetpack/androidx/releases/xr-compose).\n\nCreate a new Android Virtual Device for the Android Emulator\n------------------------------------------------------------\n\nThe Android XR Emulator is a specialized version of the Android emulator\ndesigned for XR app development. It lets you test and debug your Extended\nReality (XR) applications within the familiar Android Studio environment.\n| **Caution:** In rare cases, using the emulator can result in system freezes or crashes on some Windows configurations. Please ensure all data is saved before running the emulator. As a workaround, [enable WHPX](/studio/run/emulator-acceleration#vm-windows-whpx). See [release notes](/studio/preview/features) for more known issues.\n\nTo use the Android XR Emulator, you'll have to create a new virtual device.\nFollow these steps to do so:\n\n1. In Android Studio, click **Tools \\\u003e AVD Manager**, and follow the\n instructions to create a new Android Virtual Device (AVD).\n\n2. In the **Add Device** window, under **Form Factor** , select the **XR**\n option, then select **XR Device** in the **Name** list. Click **Next**.\n\n3. In the next tab (**Configure Virtual Device** ), under **System Image**,\n select the most recent Android XR system image that is compatible with your\n system.\n\n4. Click **Finish**.\n\n5. To start the emulator, click the **Run** button in Device Manager.\n\n The emulator opens in a separate window.\n\n6. To launch your app in the emulator, click the **Run** icon in Android\n Studio.\n\nFor details on using the emulator and other new XR tools, read [Android\nStudio Tools for XR](/develop/xr/jetpack-xr-sdk/studio-tools).\n\nEnable Usage Statistics to help improve Android Studio\n------------------------------------------------------\n\nBecause this is a developer preview version of Android Studio, many of these\nfeatures are still under development. Consider enabling usage statistics and\nsending feedback to help us improve these tools.\n\nTo enable Usage Statistics:\n\n1. Click **Settings \\\u003e Appearance \\& Behavior \\\u003e System Settings \\\u003e Data Sharing**.\n2. Select **Send usage statistics to google**."]]
