rocketseat-docs-rn

iOS

Capa

Dependências

Para configurar o ambiente iOS no macOS, iremos realizar 6 instalações principais:

  • Homebrew;
  • Node.js 14 (LTS);
  • Yarn 1;
  • Watchman;
  • CocoaPods;
  • Xcode.

Não será realizada a instalação global do react-native-cli pois ela tem causado erros. Para criar e executar nossos projetos React Native, utilizaremos os comandos via npx

Instalando Homebrew

O Homebrew é um gerenciador de pacotes para OS X muito famoso e útil. Vamos instalá-lo em nosso sistema como seguinte comando:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Instalando Node 14 (LTS) e Watchman

Com o Homebrew instalado, vamos instalar o Node 14 (LTS) e o Watchman:

Se você já tiver o Node.js instalado em sua máquina, certifique-se que sua versão é a 12 ou mais recente.

brew install node@14 watchman

Após a instalação do Node, precisamos adicionar o seu caminha a nossa variável ambiente PATH. Procure pelo primeiro dos seguintes arquivos existentes no seu sistema: ~/.zshrc ou ~/.bashrc, e adicione essas linhas no arquivo (de preferência no final):

Se nenhum desses arquivos existir, crie o ~/.bashrc caso utilize o Shell padrão ou ~/.zshrc caso utilize o ZSH.

### Enviroment Variables
export PATH=$PATH:/usr/local/opt/node@14/bin

Após a instalação, verifique se ela foi realizada com sucesso com os comandos (execute um de cada vez):

node -v
npm -v

Instalando Yarn 1

Execute o comando para instalar o Yarn:

sudo npm install --global yarn

Após a instalação, verifique se ela foi realizada com sucesso com o comando:

yarn -v

CocoaPods

CocoaPods é um gerenciador de dependências que precisaremos instalar para que nossos projetos React Native funcionem corretamente. Execute o seguinte comando no seu terminal:

sudo gem install cocoapods

Xcode

A equipe do React Native recomenda que a versão mínima do XCode utilizada seja a 12 para garantir que não ocorram erros. Caso não consiga atualizar sua versão por ter um SO antigo e tenha muitos problemas com os projetos iOS, recomendamos que utilize o Android

Xcode é uma ferramenta gratuita desenvolvida pela Apple e essencial nos projetos React Native para iOS, visto que é a partir dela que temos acesso a SDKs e Simuladores de diversos dispositivos Apple.

Para baixar, basta acessar a Mac App Store, buscar por Xcode e clicar no botão de Download. Também é possível baixar por esse link.

Executando app no Simulador

Para esse passo é preciso que você já tenha criado o seu projeto react native. Caso não tenha criado ainda, você pode criar com o comando npx react-native init nomedoprojeto

Com o Xcode instalado, basta abrir dois terminais. Um para executar o Metro Bundler e o segundo para instalar o app no aparelho. Os comandos são:

  • Terminal 1
npm start
# Ou yarn start
  • Terminal 2

    Utilize os comandos do react-native-cli via npx em vez de uma instalação global para evitar possíveis erros.

npx react-native run-ios
# Ou yarn run react-native run-ios
# Ou yarn ios

E o simulator do Xcode deve abrir automaticamente. Você pode ainda escolher a versão do simulator utilizado passando a propriedade --simulator

npx react-native run-ios --simulator="iPhone 12 Pro Max"
# Ou yarn run react-native run-ios --simulator="iPhone XS Max"
# Ou yarn ios --simulator="iPhone XS Max"

Simulator

Executando app no Dispositivo

Caso você tenha um dispositivo físico iOS, também é possível executar a aplicação diretamente nele. Caso tenha interesse em configurar essa etapa, clique aqui

Edit this page on GitHub