Configurações do Projeto

Configurações Gerais

Clonando os repositórios

Backend:

Clonar via HTTPS:

https://tools.ages.pucrs.br/comunidade-universitaria/comunidade-universitaria-back.git

Clonar via SSH:

ssh://[email protected]:8822/comunidade-universitaria/comunidade-universitaria-back.git

Para o uso de configuração, acesse o README do projeto: https://tools.ages.pucrs.br/comunidade-universitaria/comunidade-universitaria-back/-/blob/main/README.md

Frontend:

Clonar via HTTPS:

https://tools.ages.pucrs.br/comunidade-universitaria/comunidade-universitaria-front.git

Clonar via SSH:

ssh://[email protected]:8822/comunidade-universitaria/comunidade-universitaria-front.git

Frontend

Setup do ambiente de desenvolvimento

Ferramentas necessárias

• Node.js

Extensões do VsCode recomendadas

• ESLint
• Prettier

Ferramentas auxiliares

• Expo Go

Executando a aplicação

Antes de começar a desenvolver, é necessário instalar as dependências do projeto:

npm install

Com as dependências instaladas, executar o comando para iniciar o servidor de desenvolvimento:

npm start

Note que serão exibidas diversas opções no terminal de como visualizar as alterações que estão desenvolvidas no projeto. Podemos utilizar das seguintes ferramentas:

App Expo Go

Para visualizar as mudanças, basta escanear o QR Code exibido no terminal com o aplicativo.

Observação: seu celular e notebook/PC devem estar conectados na mesma rede. A rede da PUCRS limita as funcionalidades do aplicativo, sendo talvez necessário utilizar um emulador como alternativa.

Emulador Android

Para instalar o Android Studio, seguir as instruções deste [guia (https://docs.expo.dev/workflow/android-studio-emulator/). Após a instalação e configuração do dispositivo virtual, selecione a opção para abrir com o Android no terminal do Expo. Alternativamente, pode ser executado o comando:

npm run android

Deploy do Aplicativo

Para fazer o deploy do aplicativo é necessário ter uma conta expo e realizar o login interativo via CLI com o comando:

expo login

Em seguida execute o seguinte comando para configurar o build tanto para iOS quanto Android:

eas build:configure

Android

Após feita a configuração através do comando anterior, ao executar o comando:

eas build --platform android

Irá gerar um arquivo *.aab que é o executável pronto para publicar na Play Store. Neste projeto o que queremos é um arquivo com extensão *.apk para gerarmos o QRCode e compartilharmos nas apresentações, logo podemos adicionar uma nova configuração de build ao arquivo gerado pelo eas. Temos como exemplo o arquivo abaixo:

{
  "cli": {
    "version": ">= 0.49.0"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "preview-android": {
      "distribution": "internal",
      "android": {
        "buildType": "apk"
      }
    },
    "production": {}
  },
  "submit": {
    "production": {}
  }
}

Onde adicionamos o preview-android que ira gerar o arquivo necessário para instalar e testar sem a necessidade de publicar na Play Store. Agora é só rodar o comando para gerar a *.apk:

eas build -p android --profile preview-android