O SDK do Android XR agora está disponível na prévia para desenvolvedores. Queremos saber sua opinião Acesse nossa página de suporte para entrar em contato.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para começar a desenvolver para o Android XR, use o build Canary mais recente do
Android Studio, que inclui novas ferramentas e atualizações otimizadas para o Android
XR.
Os novos recursos incluídos nesta versão do Android Studio são:
Emulador do Android XR
Adição de suporte a XR no Layout Inspector
Modelo de projeto de RV
Requisitos do sistema para o emulador Android XR
No macOS:
Sistema operacional: macOS 13.3 ou mais recente.
CPU/GPU: Apple Silicon (chip M1 ou mais recente)
RAM/VRAM: 16 GB ou mais
Para Windows:
SO: Windows 11 ou mais recente.
CPU: Intel de 9ª geração ou mais recente ou AMD Ryzen série 1000 ou mais recente.
RAM: 16 GB ou mais
GPU: NVIDIA GeForce série 10 ou mais recente ou AMD Radeon RX série 5000 ou mais recente.
VRAM: 8 GB ou mais
Configurações do BIOS: as extensões de CPU VMX precisam estar ativadas no BIOS do computador.
Instalar e configurar o Android Studio para desenvolvimento de XR
Siga estas etapas para fazer o download do Android Studio e configurar seu
ambiente de desenvolvimento:
Feche todas as versões do Android Studio que já estão
instaladas.
Baixe o build canário mais recente do Android Studio, extraia para
o local de sua preferência e inicie o aplicativo.
Siga as instruções de instalação no assistente.
Na caixa de diálogo Welcome to Android Studio, clique em More Actions e
selecione SDK Manager.
Na página Android SDK, clique na guia SDK Tools e selecione as seguintes ferramentas para instalar:
Android SDK Build-Tools
Android Emulator
Android SDK Platform-Tools
Layout Inspector para API 31 a 36
Na guia SDK Platforms, faça o seguinte:
Marque a caixa de seleção Mostrar detalhes do pacote para conferir todas as opções.
Selecione a imagem do sistema Google Play XR ARM (macOS) ou Google Play
XR Intel x86_64 (Windows).
Clique em Aplicar para fazer as atualizações e em OK.
Aguarde a conclusão de todas as etapas de instalação e clique em Concluir.
Criar um projeto Android XR
Siga estas etapas para criar um projeto Android XR no Android Studio ou estender
um projeto atual para XR.
Na janela Welcome to Android Studio, faça uma destas ações:
Se você estiver criando um novo app de RV/RA, clique em Novo projeto e vá para a próxima etapa.
Se você estiver espacializando um app existente, clique em Abrir para selecionar seu projeto e pule para a próxima etapa, "Criar um novo dispositivo virtual Android para o emulador do Android". Para ajuda com a espacialização do seu app atual para Android XR, leia Leve seu app Android para o 3D com XR.
Na categoria XR, selecione o modelo Basic Headset Activity e clique em Next.
Na próxima tela, escolha um nome para o projeto. Você pode deixar as configurações padrão. Em seguida, clique em Concluir.
Criar um Dispositivo virtual Android para o Android Emulator
O emulador do Android XR é uma versão especializada do emulador do Android
projetada para o desenvolvimento de apps de RV. Ele permite testar e depurar aplicativos de realidade estendida (XR) no ambiente familiar do Android Studio.
Para usar o Android XR Emulator, você precisa criar um novo dispositivo virtual.
Para isso, siga estas etapas:
No Android Studio, clique em Tools > AVD Manager e siga as
instruções para criar um novo dispositivo virtual Android (AVD, na sigla em inglês).
Na janela Adicionar dispositivo, em Formato, selecione a opção XR e, em seguida, Dispositivo XR na lista Nome. Clique em Próxima.
Na próxima guia (Configurar dispositivo virtual), em Imagem do sistema,
selecione a imagem do sistema Android XR mais recente compatível com seu
sistema.
Clique em Finish.
Para iniciar o emulador, clique no botão Executar no Gerenciador de dispositivos.
O emulador é aberto em uma janela separada.
Para iniciar o app no emulador, clique no ícone Executar no Android Studio.
Ativar as estatísticas de uso para ajudar a melhorar o Android Studio
Como esta é uma versão de prévia para desenvolvedores do Android Studio, muitos desses
recursos ainda estão em desenvolvimento. Ative as estatísticas de uso e envie feedback para nos ajudar a melhorar essas ferramentas.
Para ativar as estatísticas de uso:
Clique em Configurações > Aparência e comportamento > Configurações do sistema > Compartilhamento de dados.
Selecione Enviar estatísticas de uso ao Google.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-01 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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**."]]
