Configuração do Projeto

Configuração do ambiente mobile

Texto texto

Setup back-end

Texto texto

Setup front-end

Preparação do ambiente React-Native

Nodejs:

O primeiro passo para configuração do nosso ambiente é a instalação do Nodejs, pois este irá gerenciar e preparar nosso ambiente. O Nodejs pode ser encontrado através do link https://nodejs.org/en/download/

Importante! Baixe apenas a versão "LTS" (versão testada e segura), a versão "current" pode apresentar problemas e instabilidade.

Instalação do expo:

O expo fará o gerenciamento do código e a ponte entre o código e o dispositivo, seja ele virtual ou um dispositivo real. Para todo sistema operacional, para 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 (o expo não ficará reservado a os repositórios abaixo da pasta onde você está) e "expo-cli" refere-se ao que será instalado, neste caso o próprio expo.

Virtual ou por dispositivo:

É possível executar/reproduzir o projeto em dispositivos virtuais ou em dispositivos reais (seu próprio celular/tablet).

Usando seu dispositivo:

Para usar seu próprio celular é necessário baixar o aplicativo do Expo.

Para Android: https://play.google.com/store/apps/details?id=host.exp.exponent&hl=pt_BR&gl=US

Para IOS: https://apps.apple.com/br/app/expo-go/id982107779

Quando instalado o aplicativo, o app irá avisar as configurações básicas que devem serem feitas, após passar pelo wizard, use e aponte a câmera para ler o QR CODE que irá aparecer no console quando o projeto for iniciado.

OBS: Em alguns dispositivos, versões e/ou sistemas, não é necessário passar pelo Wizard após instalado o App.

Virtual/Emulador:

Para Android: https://developer.android.com/studio?hl=pt

Baixe e instale o Android Studio do site oficial (link acima). 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.

Para IOS: link aqui

tutorial aqui

Clonando o projeto:

Antes de tudo, garanta que você possui o git instalado (se necessário no seu sistema operacional: https://git-scm.com/downloads)

• Vá no nosso repositório https://tools.ages.pucrs.br/descarta-facil/descartafacil-mobile

• Em "clone", copie o texto da forma de clonagem que você 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 "git clone ". Substitua "" pelo texto copiado anteriormente, no repositório do projeto. Confirme o comando e, após terminar, seu projeto estará pronto para ser iniciado

Iniciando o projeto:

Dentro da pasta do projeto, use o comando "npm install" para que o npm baixe e instale todas as dependências, bibliotecas ou qualquer outro arquivo que seja necessário para rodar o projeto. Quando finalizado a instalação, use o comando "npm start" para iniciar o projeto.

Caso esteja usando um dispositivo real, apenas aponte o leitor para o QR CODE que aparecerá no terminal.

Caso esteja usando o emulador, use o comando "npm run android" para inciar a compilação/build

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