Configuração do Projeto

Acesso Rápido

• Configuração do ambiente mobile
• Setup Backend
• Setup Frontend
• Tecnologias necessárias
  • Instalação do Node
  • Instalação do Expo
  • Instalação do Git
  • Instalação do Android Studio
• Iniciando o projeto
  • Clonar o projeto
  • Executar o projeto
• Problemas/erros comuns

Configuração do ambiente mobile

Texto texto

Setup back-end

Texto texto

Setup front-end

Texto texto

Tecnologias necessárias

Instalação do Node

O primeiro passo para configuração do nosso ambiente é a instalação do Node.js, pois este irá gerenciar e preparar nosso ambiente.

Baixe apenas a versão LTS (Long Term Support), pois é a versão testada e segura. A página de download do Node.js pode encontrado através deste link.

Instalação do Expo

Instalação do expo-cli

O Expo fará o gerenciamento do código e a ponte entre o código e o dispositivo, seja ele virtual ou físico. Para a instalação deste, apenas é necessário a execução do comando:

npm install -g expo-cli

Onde:

• npm install é o comando para instalação.
• -g refere-se a uma instalação global, isso significa que o Expo estará disponível para todo o sistema invés de estar apenas contido a um diretório específico.
• expo-cli refere-se ao que será instalado, neste caso o próprio Expo.

Instalação do Expo Go

Faça o download do aplicativo do Expo. Ele é utilizado para executar/reproduzir o projeto usando seu dispositivo físico. O aplicativo está disponível tanto para Android quanto para iOS.

Quando instalado, em alguns dispositivos, versões e/ou sistemas, não é necessário passar pelo Wizard após instalado o aplicativo. Caso seja necessário, o aplicativo irá avisar quais são as configurações básicas que devem serem feitas.

Instalação do Git

O git é uma ferramenta utilizada para fazer o versionamento e controle do código do projeto. Se necessário no seu sistema operacional, o download pode ser feito através deste link.

Instalação do Android Studio

Este passo é só para caso você deseje emular um dispositivo virtual.

Baixe e instale o Android Studio do site oficial. Durante a instalação, não há a necessidade de configurar nada além das configurações padrões/recomendadas pelo Wizard. Caso você escolha mudar algo, atende-se em como isso irá afetar a instalação.

OBS: Instalar o Android Studio dentro de uma pasta que possua acento pode ocasionar erros constantes, INCLUINDO a pasta do usuário. (Ex: C:\Users\meuUsuário)

Após instalado não é necessário abrir o projeto pela interface do Android Studio. No canto inferior direito, em configure, irá abrir um grupo de opção. Em AVD manager é possível visualizar e iniciar apenas o emulador.

Iniciando o projeto

Clonar o projeto

Vá ao repositório do projeto e em Clone, copie o link da forma de clonagem que preferir.

Em seu computador, vá até a pasta onde deseja instalar o projeto e abra o git dentro da pasta. Para Windows, clique com o botão direito do mouse e selecione Git Bash here.

Na nova janela aberta, digite o comando git clone <link> e substitua <link> pelo link copiado anteriormente referente ao repositório do projeto. Confirme o comando e, após terminar, seu projeto estará pronto para ser utilizado.

Executar o projeto

Dentro da pasta do projeto, use o comando npm install para instalar todas as dependências, bibliotecas ou qualquer outro arquivo que seja necessário para rodar o projeto. Na primeira vez que o comando é executado, o esperado é que demore bastante para ser concluído.

Quando finalizado a instalação, use o comando npm start para iniciar o projeto. É possível executar/reproduzir o projeto em dispositivos virtuais ou em dispositivos físicos utilizando seu celular ou tablet.

Usando seu dispositivo físico:

Caso esteja usando um dispositivo físico, apenas aponte a câmera para o QRCODE que aparecerá no terminal.

Virtual/Emulador:

Caso esteja usando o emulador, use o comando npm run <android/ios> para inciar a compilação/build.

Para IOS: link aqui

tutorial aqui

Problemas/erros mais comuns

"Intel HAXM installation failed" durante instalação/inicialização do dispositivo virtual":

Link listando todas as possíveis causas para o problema e suas respectivas soluções: https://www.tektutorialshub.com/android-studio/haxm-installation-failed-install-intel-haxm-in-windows/

OBS: O mais comum é que isto ocorra em razão da virtualização estar desabilitada na BIOS ou por o HYPER-V estar habilitado no Windows, dê bastante atenção a esses itens dentro do tutorial linkado

“execution of scripts is disabled on this system":

Este erro refere-se as configurações do seu Windows em relação a execução de scripts. Para uma correção rápida: Como administrador, abra o PowerShell e execute o comando "Set-ExecutionPolicy RemoteSigned", o sistema irá solicitar que você confirme a ação/modificação, confirme-a. Refaça o comando que anteriormente estava sendo de executar, espere que este finalize e então volte no PowerShell e execute o comando "Set-ExecutionPolicy Restricted", para desfazer a moficação anterior e garantir a segurança do sistema.

Para uma leitura mais aprofundada sobre por que disto e o que é isto: https://docs.microsoft.com/pt-br/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.1