Como configurar o ambiente para React Native no Windows, Linux e macOS

Com Homebrew:

brew install node
brew install watchman

O Watchman é da Meta e observa mudanças no sistema de arquivos. A documentação do React Native manda instalar junto no macOS. A do Expo diz que ele só é necessário em projetos com SDK 55 ou anterior.

A documentação do React Native usa Chocolatey, em um Prompt de Comando como administrador, e aproveita para instalar o JDK na mesma linha:

choco install -y nodejs-lts microsoft-openjdk17

A página também cita o nvm-windows como alternativa para gerenciar versões do Node.

O Watchman não é mencionado em nenhuma das páginas de Windows.

A documentação do React Native não dá um comando aqui. Ela manda seguir as instruções da sua distribuição na página de gerenciadores de pacotes do Node.js, instalando o Node 22.11.0 ou mais novo.

Para o Watchman também não há pacote indicado: a orientação é compilar a partir do código-fonte.

As duas documentações recomendam a distribuição Azul Zulu, via Homebrew:

brew install --cask zulu@17
brew info --cask zulu@17
open /opt/homebrew/Caskroom/zulu@17/<numero-da-versao>

Em Macs que não são Apple Silicon o caminho é /usr/local/Caskroom. Na pasta aberta, execute Double-Click to Install Azul Zulu JDK 17.pkg.

Depois adicione ao ~/.zshrc (ou ~/.bash_profile):

export JAVA_HOME=/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home

Via Chocolatey, em um Prompt de Comando como administrador:

choco install -y microsoft-openjdk17

Nenhuma das duas documentações manda configurar JAVA_HOME no Windows.

A documentação do React Native acrescenta um aviso: se você usar um JDK mais novo, talvez precise atualizar a versão do Gradle, alterando distributionUrl em android/gradle/wrapper/gradle-wrapper.properties dentro do projeto.

Não há comando nas documentações. As duas dizem a mesma coisa: instale o OpenJDK 17, pelo AdoptOpenJDK ou pelo gerenciador de pacotes da sua distribuição.

Também não há instrução de JAVA_HOME para Linux em nenhuma das páginas.

O SDK Manager fica no botão More Actions da tela inicial do Android Studio, ou em Settings → Languages & Frameworks → Android SDK.

Na aba SDK Platforms, marque também uma imagem de sistema. Em Macs com Apple Silicon, a documentação indica a Google APIs ARM 64 v8a System Image. Em Macs Intel, Intel x86 Atom_64 System Image ou Google APIs Intel x86 Atom System Image.

O SDK Manager fica no botão More Actions, ou em Settings → Languages & Frameworks → Android SDK.

A imagem de sistema indicada é Intel x86 Atom_64 System Image ou Google APIs Intel x86 Atom System Image. A documentação não oferece opção ARM no Windows.

Se o HAXM não estiver instalado ao criar o emulador, o Android Studio oferece um botão Install HAXM.

Na documentação do React Native, o SDK Manager no Linux é aberto pelo botão Configure da tela inicial. As caixas a marcar são as mesmas do Windows.

A página também recomenda configurar aceleração de VM no seu sistema.

Adicione ao ~/.zprofile ou ~/.zshrc (no bash, ~/.bash_profile ou ~/.bashrc):

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

Recarregue e confira:

source ~/.zprofile
echo $ANDROID_HOME

O caminho real do SDK aparece em Settings → Languages & Frameworks → Android SDK, caso o seu não seja o padrão.

No Windows não há export. As duas documentações mandam usar a interface gráfica:

1. Painel de Controle → Contas de Usuário → Contas de Usuário → Alterar minhas variáveis de ambiente
2. Novo… e crie a variável de usuário ANDROID_HOME apontando para o SDK. O caminho padrão é:

%LOCALAPPDATA%\Android\Sdk

3. Selecione a variável Path → Editar → Novo e acrescente:

%LOCALAPPDATA%\Android\Sdk\platform-tools

Repare que, no Windows, as documentações mandam adicionar só o platform-tools ao Path, não o emulator, como em macOS e Linux.

Abra um novo terminal e confira:

Get-ChildItem -Path Env:\
adb --version

Adicione ao $HOME/.bashrc ou $HOME/.bash_profile (no zsh, ~/.zprofile ou ~/.zshrc):

export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

Recarregue e confira:

source $HOME/.bashrc
echo $ANDROID_HOME

Repare que o caminho do SDK no Linux ($HOME/Android/Sdk) é diferente do macOS ($HOME/Library/Android/sdk).

Instale o Xcode pela Mac App Store. A documentação do React Native pede a versão mais recente e não cita um número mínimo. O Xcode já traz o simulador de iOS e as ferramentas de build.

Depois:

1. Command Line Tools: Xcode → Settings… → painel Locations → escolha a versão mais recente no menu Command Line Tools.
2. Simulador: no Xcode 14 ou mais novo, Xcode → Settings → Platforms, clique em “+” e escolha iOS. A documentação do Expo descreve o mesmo caminho por Components → Platform Support → iOS.
3. CocoaPods: a documentação o descreve como uma gem Ruby, instalável com o Ruby que já vem no macOS. Nenhuma das páginas dá o comando de instalação nem fixa uma versão de Ruby ou de CocoaPods.

Duas notas úteis da documentação do React Native:

• A partir do React Native 0.69 dá para configurar o ambiente do Xcode pelo arquivo .xcode.env do template, que exporta NODE_BINARY.
• Se você usa NVM, considere mover a inicialização do ~/.zshrc para o ~/.zshenv:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm

No Xcode 27 o app Simulator foi substituído pelo Device Hub; no Xcode 26 ainda é o Simulator. Para abrir pela linha de comando:

xcrun simctl list devices available
open -a Simulator

Não é possível. A documentação do React Native é direta:

A Mac is required to build projects with native code for iOS.

A documentação do Expo diz o mesmo sobre o simulador: ele só roda em macOS, e de um Windows você precisa de um aparelho iOS físico ou de um simulador remoto.

Para desenvolver no seu iPhone a partir do Windows, a saída indicada é o Expo Go. A documentação acrescenta que usar o Expo Go em um aparelho iOS físico exige assinatura do Apple Developer Program, e login na CLI:

npx expo login

Não é possível, pelo mesmo motivo do Windows. A documentação do React Native repete a frase:

A Mac is required to build projects with native code for iOS.

Vale o mesmo caminho alternativo: Expo Go em um aparelho iOS físico.