Rocketseat Docs

Linux (Ubuntu)

Linux (Ubuntu)

Dependências

Para configurar o ambiente Android e iOS no Linux (Ubuntu) utilizando Expo Managed Workflow (Expo GO), precisamos de 6 ferramentas principais:

  • cURL
  • Node.js (LTS);
  • npm (já vem instalado com o Node);
  • git
  • expo-cli
  • Expo GO (app a ser instalado no dispositivo Android e/ou iOS)

Instalando cURL

O cURL pode já vir instalado na sua distro. Para verificar, basta executar curl --version no seu terminal.

Para instalar no seu sistema, basta você executar no seu terminal o comando abaixo:

sudo apt-get install curl

Para verificar se a instalação foi um sucesso, basta executar o comando abaixo:

No momento da escrita dessa documentação, a versão do cURL para Ubuntu mais recente é a 7.81.0.

curl --version

Se foi apresentado o valor da sua versão, a instalação foi um sucesso.

Instalando Node.js (LTS) e npm

Em seguida é preciso instalar o Node.js (LTS) e npm no nosso sistema.

Para instalar no seu sistema, você pode utilizar um gerenciador de pacotes como o n ou instalar utilizando o NodeSource. Nesse guia iremos utilizar o NodeSource, então basta acessar abrir o seu terminal e executar os comandos abaixo:

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs

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

Para verificar se a instalação foi um sucesso, basta executar os comandos abaixo:

No momento da escrita dessa documentação, a versão LTS do Node mais recente é a 16.16.0 e do npm é a 8.14.0.

node -v
npm -v

Git

O git pode já vir instalado na sua distro. Para verificar, basta executar git --version no seu terminal.

Para instalar no seu sistema, basta você executar no seu terminal o comando abaixo:

sudo apt-get install git

Para verificar se a instalação foi um sucesso, basta executar o comando abaixo:

No momento da escrita dessa documentação, a versão do Git para Ubuntu mais recente é a 2.34.1.

git --version

Se foi apresentado o valor da sua versão, a instalação foi um sucesso.

expo-cli

Para instalar no seu sistema, você irá utilizar o seu gerenciador de pacotes npm. Abra o seu terminal e execute o comando:

npm install -g expo-cli

Caso ocorra um erro dizendo que você não possui permissão (EACESS), siga os passo desse link

Para verificar se a instalação foi um sucesso, basta executar o comando abaixo:

No momento da escrita dessa documentação, a versão do expo-cli mais recente é a 5.5.1.

expo --version

Se foi apresentado o valor da sua versão, a instalação foi um sucesso.

Caso apareça um erro dizendo que o comando expo não foi encontrado, siga os passos desse link

Expo GO

Com a CLI instalada no seu computador, você consegue criar projetos Expo e executar o metro bundler para servir o seu código, mas para executar o app no seu celular (ou emulador) você precisa instalar o aplicativo Expo GO. Ele é o responsável por pegar o código que o metro bundler envia e exibir em tela o seu app React Native.

Para instalá-lo no seu dispositivo físico, basta buscar nas lojas o aplicativo Expo Go:

Para instalá-lo no seu emulador, basta executar o comando expo start e escolher qual emulador você deseja executar. Caso o Expo GO não esteja instalado, ele irá solicitar a sua autourização para instalar a versão necessária.

Emulador

Android

Com o Android Studio, é possível configurar um emulador Android e executar a sua aplicação nele.

Porém, esses emuladores consomem bastante recursos do seu computador. Por isso, se você possui um dispositivo físico Android e sua máquina possui configurações modestas (ex.: ⬇ i3, ⬇ 4gb RAM), é recomendado executar a aplicação no seu dispositivo físico pelo Expo GO.

Para aprender a instalar e configurar o seu emulador, siga esse guia

iOS

Disponível apenas para máquinas macOS. Windows e Linux não suportam iOS simulator.

Executando aplicação

Agora que você possui tudo que é necessário para executar sua aplicação Expo, basta seguir os seguintes passos:

  • Acesse a pasta do seu projeto pelo terminal
  • Execute o comando expo start
  • Abra o app no seu dispositivo via Expo GO
    • Se for dispositivo físico Android, basta abrir o app Expo GO, selecionar a opção Scan QR code e ler o QR Code apresentado no terminal.
    • Se for dispositivo físico iOS, basta abrir o app de camera do iOS, ler o QR Code apresentado no terminal e clicar no popup Open with Expo Go app
    • Se for emulador Android, basta digitar a no terminal.

Seguindo esses passo seu app deve abrir com sucesso no seu dispositivo 🎉

Edit this page on GitHub