Este codelab descreve como preparar o ambiente de desenvolvimento para aplicações React Native em um sistema operacional Windows 10 ou Windows 11. Ao final, o computador terá instalados: Node.js, Java Development Kit (JDK) 21, o Android SDK via linha de comando e um Emulador Android (AVD). O Visual Studio Code (VS Code) e o Expo CLI são configurados na última seção.

Tempo estimado

60 a 90 minutos, dependendo da velocidade de conexão e do computador.

O que você vai aprender

• Instalar e verificar o Node.js (versão LTS)
• Instalar e verificar o JDK 21
• Baixar e configurar o Android SDK sem o Android Studio
• Configurar as variáveis de ambiente ANDROID_HOME e PATH
• Criar e inicializar um Android Virtual Device (AVD)
• Instalar o VS Code e o Expo CLI
• Criar e executar o primeiro projeto React Native

Referências

Node.js: https://nodejs.org/

JDK 21: https://www.oracle.com/java/technologies/downloads/#java21

Android SDK (command-line tools): https://developer.android.com/studio#command-line-tools-only

React Native – Ambiente nativo: https://reactnative.dev/docs/environment-setup

Expo: https://expo.dev/

2.1 Sistema operacional

Windows 10 (64 bits, versão 1903 ou posterior) ou Windows 11.

2.2 Privilégios de administrador

A configuração de variáveis de ambiente do sistema exige privilégios de administrador. Verifique com o suporte de TI se o computador tiver restrições.

2.3 Virtualização de hardware

O emulador Android requer que a virtualização esteja habilitada na BIOS/UEFI do computador. Para verificar:

1. Pressione Ctrl + Shift + Esc para abrir o Gerenciador de Tarefas.
2. Clique na aba Desempenho e, depois, em CPU.
3. Confira se o campo Virtualização mostra Habilitado.

2.4 Espaço em disco

Reserve pelo menos 8 GB livres. O Android SDK com imagem de sistema ocupa entre 4 GB e 6 GB, e projetos Expo crescem à medida que pacotes são instalados.

2.5 Terminal recomendado

Este codelab usa o Prompt de Comando (CMD) do Windows. Os comandos que envolvem variáveis de ambiente usam a sintaxe %VARIAVEL%, que funciona apenas no CMD. No PowerShell, a sintaxe é diferente ($env:VARIAVEL).

O React Native (e o Expo CLI) são distribuídos como pacotes npm. O Node.js fornece o ambiente de execução JavaScript e o gerenciador de pacotes npm, necessários para criar e executar projetos.

3.1 Download e instalação

1. Acesse https://nodejs.org/ e baixe o instalador da versão LTS (Long-Term Support). A página exibe automaticamente a versão recomendada para a plataforma atual.
2. Execute o instalador. Mantenha todas as opções padrão marcadas.
3. Ao final da instalação, clique em Finish.

3.2 Verificação

Feche e reabra o CMD (para recarregar as variáveis de ambiente). Depois, execute os dois comandos a seguir:

Verificar versão do Node.js e do npm

node -v
npm -v

A saída deve exibir dois números de versão, por exemplo:

Exemplo de saída esperada

v22.11.0
10.9.0

O emulador Android e as ferramentas de compilação nativa do React Native dependem do Java. A versão recomendada é o JDK 21, que recebe suporte até setembro de 2026 no modelo de suporte de longo prazo (LTS) da Oracle.

4.1 Download e instalação

1. Acesse https://www.oracle.com/java/technologies/downloads/#java21 e baixe o instalador MSI para Windows x64.
2. Execute o instalador com as opções padrão.

4.2 Verificação

Verificar versão do Java

java -version

Exemplo de saída esperada

java version "21.0.x" ...
Java(TM) SE Runtime Environment (build 21.0.x ...)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.x ...)

O Android Studio não é necessário para desenvolver com React Native. O SDK pode ser instalado de forma mais leve usando apenas as ferramentas de linha de comando (command-line tools).

📁 Estrutura de pastas que será criada

C:\Users\<usuario>\AppData\Local\Android\Sdk\   (raiz do SDK)    

 Sdk\
  ├ cmdline-tools\latest\   (ferramentas de linha de comando)
  ├ platforms\              (plataformas Android)
  ├ build-tools\            (ferramentas de compilação)    
  ├ system-images\          (imagens para o emulador)
  └ platform-tools\         (adb, fastboot)

5.1 Baixar o pacote de ferramentas de linha de comando

1. Acesse Fazer o download do Android Studio e das ferramentas de apps.
2. Na seção Somente ferramentas de linha de comando, baixe o arquivo ZIP para Windows.

5.2 Organizar os arquivos

3. Crie a pasta de destino, se ela ainda não existir:

Criar estrutura de pastas

mkdir C:\Users\%USERNAME%\AppData\Local\Android\Sdk\cmdline-tools

4. Extraia o ZIP baixado. Dentro dele haverá uma pasta chamada cmdline-tools.
5. Renomeie essa pasta extraída para latest.
6. Mova a pasta latest para dentro do caminho criado no passo 3, de modo que a estrutura fique assim:

Estrutura esperada após organização

C:\Users\<usuario>\AppData\Local\Android\Sdk\cmdline-tools\latest\

5.3 Configurar a variável de ambiente ANDROID_HOME

A variável ANDROID_HOME aponta para a raiz do Android SDK e é exigida pelas ferramentas do React Native.

7. Abra as Configurações do Windows e procure por Editar as variáveis de ambiente do sistema.
8. Clique em Variáveis de Ambiente.
9. Na seção Variáveis do sistema, clique em Novo e preencha:

10. Clique em OK para salvar.

5.4 Adicionar as ferramentas ao PATH

Adicione os dois caminhos abaixo à variável de sistema PATH para que os comandos sdkmanager, avdmanager e adb fiquem disponíveis no CMD.

11. Na janela Variáveis de Ambiente, selecione a variável Path na seção Variáveis do sistema e clique em Editar.
12. Clique em Novo e adicione cada caminho:

Caminhos a adicionar no PATH

%ANDROID_HOME%\cmdline-tools\latest\bin

%ANDROID_HOME%\platform-tools

%ANDROID_HOME%\emulator

13. Clique em OK em todas as janelas abertas para salvar.
14. Feche e reabra o CMD para que as alterações entrem em vigor.

5.5 Instalar os componentes do SDK

Execute os comandos abaixo, um de cada vez, no CMD. O sdkmanager fará o download dos componentes necessários.

Plataforma e ferramentas de compilação (Android 14 – API 34)

Instalar plataforma e build-tools

sdkmanager "platforms;android-34" "build-tools;34.0.0"

Imagem de sistema para o emulador

Instalar imagem de sistema

sdkmanager "system-images;android-34;google_apis;x86_64"

Repositórios de suporte

Instalar repositórios

sdkmanager "extras;google;m2repository" "extras;android;m2repository"

Ferramentas de plataforma (adb, fastboot)

Instalar platform-tools

sdkmanager "platform-tools"

Aceitar licenças

Aceitar licenças do Android SDK

sdkmanager --licenses

Digite y e pressione Enter para cada licença exibida.

5.6 Verificar os componentes instalados

Listar componentes instalados

sdkmanager --list_installed

A saída deve listar platforms;android-34, build-tools;34.0.0, system-images;android-34;google_apis;x86_64 e platform-tools.

Um AVD é um emulador de dispositivo Android que roda no computador. O React Native usa o AVD para exibir o aplicativo durante o desenvolvimento.

6.1 Criar o AVD

Criar Android Virtual Device

avdmanager create avd -n MeuAVD34 -k "system-images;android-34;google_apis;x86_64" -d "pixel_6"

Os parâmetros usados são:

Se o avdmanager perguntar se deseja criar um hardware profile personalizado, responda no.

6.2 Verificar o AVD criado

Listar AVDs disponíveis

avdmanager list avd

A saída deve exibir MeuAVD34 na lista.

6.3 Inicializar o emulador

Inicializar o emulador Android

emulator -avd MeuAVD34

Uma janela com o emulador Android deve abrir em alguns segundos. Se o emulador inicializar e exibir a tela inicial do Android, o ambiente está correto.

O VS Code é o editor de código recomendado para este curso. É gratuito, leve e tem suporte nativo a JavaScript e TypeScript.

7.1 Download e instalação

1. Acesse https://code.visualstudio.com/ e baixe o instalador para Windows.
2. Execute o instalador. Na etapa Tarefas Adicionais, marque a opção Adicionar ao PATH (disponibiliza o comando code no CMD).
3. Conclua a instalação.

7.2 Extensões recomendadas

Abra o VS Code, vá à aba Extensões (Ctrl + Shift + X) e instale:

7.3 Verificação

Verificar versão do VS Code

code -v

8.1 Criar o primeiro projeto

1. Escolha ou crie uma pasta para seus projetos, por exemplo C:\Projetos.
2. Abra o CMD nessa pasta e execute:

Criar projeto Expo

npx create-expo-app MeuPrimeiroProjeto --template blank
cd MeuPrimeiroProjeto

8.2 Executar no emulador

Certifique-se de que o emulador está rodando (seção 6.3). Depois, execute:

Iniciar o aplicativo no emulador Android

npx expo start --android

O Expo compilará o projeto e instalará o Expo Go no emulador automaticamente. Em seguida, o aplicativo será exibido no emulador.

Execute todos os comandos abaixo no CMD após concluir a configuração. Todos devem retornar versões ou informações sem erros.

Fim do Codelab – Ambiente de Desenvolvimento React Native