... | @@ -21,16 +21,34 @@ ssh://[email protected]:8822/comunidade-universitaria/comunidade-universit |
... | @@ -21,16 +21,34 @@ ssh://[email protected]:8822/comunidade-universitaria/comunidade-universit |
|
|
|
|
|
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
|
|
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
|
|
|
|
|
|
##Backend
|
|
**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
|
|
## Setup do ambiente de desenvolvimento
|
|
|
|
|
|
### Ferramentas necessárias
|
|
### Ferramentas necessárias
|
|
|
|
|
|
|
|
- [Node.js](https://nodejs.org/pt)
|
|
|
|
|
|
- [Node.js](https://nodejs.org/) (versão 20)
|
|
### Extensões do VsCode recomendadas
|
|
- [Docker](https://www.docker.com/) e [Docker Compose](https://docs.docker.com/compose/)
|
|
|
|
- [Git](https://git-scm.com/)
|
|
- ESLint
|
|
- [Prisma CLI](https://www.prisma.io/docs/getting-started/quickstart) (opcional, caso queira rodar comandos localmente)
|
|
- Prettier
|
|
|
|
|
|
|
|
### Ferramentas auxiliares
|
|
|
|
|
|
|
|
- Expo Go - App mobile
|
|
|
|
|
|
## Executando a aplicação
|
|
## Executando a aplicação
|
|
|
|
|
... | @@ -40,60 +58,81 @@ Antes de começar a desenvolver, é necessário instalar as dependências do pro |
... | @@ -40,60 +58,81 @@ Antes de começar a desenvolver, é necessário instalar as dependências do pro |
|
npm install
|
|
npm install
|
|
```
|
|
```
|
|
|
|
|
|
Então, com o aplicativo Docker aberto execute:
|
|
Com as dependências instaladas, executar o comando para iniciar o servidor de desenvolvimento:
|
|
|
|
|
|
```sh
|
|
```
|
|
docker compose up -d
|
|
npm start
|
|
```
|
|
```
|
|
|
|
|
|
## Visualização dos dados
|
|
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:
|
|
|
|
|
|
aso queira visualizar os dados, utilize:
|
|
## App Expo Go
|
|
|
|
|
|
```sh
|
|
Para visualizar as mudanças, basta escanear o QR Code exibido no terminal com o aplicativo.
|
|
npx prisma studio
|
|
|
|
```
|
|
|
|
|
|
|
|
Ou acesse o **Adminer** pelo navegador:
|
|
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.
|
|
🔗 [http://localhost:8080](http://localhost:8080)
|
|
|
|
|
|
|
|
**Frontend**:
|
|
## Emulador Android
|
|
|
|
|
|
Clonar via HTTPS:
|
|
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:
|
|
```
|
|
|
|
https://tools.ages.pucrs.br/comunidade-universitaria/comunidade-universitaria-front.git
|
|
|
|
```
|
|
|
|
|
|
|
|
Clonar via SSH:
|
|
|
|
```
|
|
```
|
|
ssh://[email protected]:8822/comunidade-universitaria/comunidade-universitaria-front.git
|
|
npm run android
|
|
```
|
|
```
|
|
|
|
|
|
## Frontend
|
|
### Deploy do Aplicativo
|
|
|
|
|
|
## Setup do ambiente de desenvolvimento
|
|
Para fazer o deploy do aplicativo é necessário ter uma [conta expo](https://expo.dev/signup) e realizar o login interativo via CLI com o comando:
|
|
|
|
|
|
### Ferramentas necessárias
|
|
```shell
|
|
|
|
expo login
|
|
- [Node.js](https://nodejs.org/dist/v20.19.0/node-v20.19.0-x64.msi) (versão 20.19 LTS)
|
|
```
|
|
|
|
|
|
### Ferramentas auxiliares
|
|
Em seguida execute o seguinte comando para configurar o build tanto para iOS quanto Android:
|
|
|
|
|
|
- [Expo Go] - App mobile
|
|
```shell
|
|
|
|
eas build:configure
|
|
|
|
```
|
|
|
|
|
|
## Executando a aplicação
|
|
#### Android
|
|
|
|
|
|
Antes de começar a desenvolver, é necessário instalar as dependências do projeto:
|
|
Após feita a configuração através do comando anterior, ao executar o comando:
|
|
|
|
|
|
```
|
|
```shell
|
|
npm install
|
|
eas build --platform android
|
|
```
|
|
```
|
|
|
|
|
|
## Visualização das telas
|
|
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:
|
|
|
|
|
|
Para visualizar as telas use o comando:
|
|
```json
|
|
|
|
{
|
|
```
|
|
"cli": {
|
|
npm start
|
|
"version": ">= 0.49.0"
|
|
|
|
},
|
|
|
|
"build": {
|
|
|
|
"development": {
|
|
|
|
"developmentClient": true,
|
|
|
|
"distribution": "internal"
|
|
|
|
},
|
|
|
|
"preview": {
|
|
|
|
"distribution": "internal"
|
|
|
|
},
|
|
|
|
"preview-android": {
|
|
|
|
"distribution": "internal",
|
|
|
|
"android": {
|
|
|
|
"buildType": "apk"
|
|
|
|
}
|
|
|
|
},
|
|
|
|
"production": {}
|
|
|
|
},
|
|
|
|
"submit": {
|
|
|
|
"production": {}
|
|
|
|
}
|
|
|
|
}
|
|
```
|
|
```
|
|
E então leia o QR code mostrado no terminal com o aplicativo Expo GO. |
|
|
|
|
|
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`:
|
|
|
|
|
|
|
|
```shell
|
|
|
|
eas build -p android --profile preview-android
|
|
|
|
``` |
|
|
|
\ No newline at end of file |