| ... | ... | @@ -149,18 +149,78 @@ Uma vez que a requisição é enviada, os dados da resposta (status, corpo, head |
|
|
|
|
|
|
|
Além disso, toda vez que for feita uma alteração na collection, ela deve ser exportada como um arquivo JSON e em seguida commitada no repositório do Backend do projeto, para que todos os integrantes da equipe tenham acesso à documentação atualizada.
|
|
|
|
|
|
|
|
|
|
|
|
## Frontend
|
|
|
|
|
|
|
|
### Pré-Requisitos:
|
|
|
|
* Node versão 22.14.0
|
|
|
|
### Tecnologias do Frontend
|
|
|
|
|
|
|
|
O frontend do projeto foi desenvolvido com **React Native CLI**, utilizando **TypeScript** como linguagem principal. As principais bibliotecas e ferramentas utilizadas incluem:
|
|
|
|
|
|
|
|
- **React Navigation**: para gerenciamento de rotas e navegação entre telas;
|
|
|
|
- **React Native Paper**: biblioteca de componentes visuais baseada em Material Design;
|
|
|
|
- **Axios**: para consumo da API backend via requisições HTTP;
|
|
|
|
- **react-native-encrypted-storage**: para armazenamento seguro de dados sensíveis no dispositivo;
|
|
|
|
- **TypeScript**: para garantir tipagem estática e facilitar manutenção.
|
|
|
|
|
|
|
|
Além disso, o projeto utiliza fontes e cores customizadas definidas no repositório em conformidade com a identidade visual estabelecida nos mockups da aplicação.
|
|
|
|
|
|
|
|
### Pré-requisitos
|
|
|
|
|
|
|
|
- Node.js versão **18.18.2** ou superior
|
|
|
|
- Java JDK 17 (para compilação Android)
|
|
|
|
- Android Studio (ou dispositivo físico com modo desenvolvedor habilitado)
|
|
|
|
- yarn ou npm instalado globalmente
|
|
|
|
- Emulador Android configurado (AVD) ou celular via USB
|
|
|
|
|
|
|
|
### Instruções para executar o projeto
|
|
|
|
|
|
|
|
1. **Clone o repositório:**
|
|
|
|
|
|
|
|
```bash
|
|
|
|
git clone https://tools.ages.pucrs.br/lucky-draw/front-end.git
|
|
|
|
cd front-end
|
|
|
|
```
|
|
|
|
|
|
|
|
2. **Instale as dependências:**
|
|
|
|
|
|
|
|
```bash
|
|
|
|
npm install
|
|
|
|
# ou
|
|
|
|
yarn install
|
|
|
|
```
|
|
|
|
|
|
|
|
3. **Execute a aplicação:**
|
|
|
|
|
|
|
|
```bash
|
|
|
|
npm start
|
|
|
|
```
|
|
|
|
|
|
|
|
Se tudo der certo, deverá aparecer no terminal a seguinte tela:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Abrir outro terminal rodar o seguite comando:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
npm run-android
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
O processo acima pode demorar alguns minutos, pricipalmente na primeira vez que rodar.
|
|
|
|
Após carregar aparecerá essa mensagem e o app será iniciado no celular.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
4. **Em caso de erro de cache ou build, utilize:**
|
|
|
|
|
|
|
|
```bash
|
|
|
|
npx react-native start --reset-cache
|
|
|
|
cd android && ./gradlew clean
|
|
|
|
```
|
|
|
|
|
|
|
|
### Instruções para executar o projeto:
|
|
|
|
1. Instalar globalmente em seu terminal o [Expo](https://docs.expo.dev/) utilizando o comando `npm install -g expo-cli`.
|
|
|
|
2. Em seu diretório local, realizar o comando `git clone https://tools.ages.pucrs.br/lucky-draw/front-end.git `e `git checkout nome-branch` para a branch que está trabalhando.
|
|
|
|
3. Abra o projeto na sua IDE e, no terminal, execute o comando `npm install` e, em seguida, `npm start`.
|
|
|
|
4. Faça o Download do [Expo GO](https://expo.dev/client) na App Store ou Google Play em seu Android .e/ou iOS. Abra o app e escaneie o QR code que aparecer na tela. Se preferir você também tem a opção de abrir em um emulador pressionando `a` ou na web, pressionando `w`.
|
|
|
|
### Configurando o Emulador ou Celular
|
|
|
|
|
|
|
|
### Extensões recomendadas do VSCode:
|
|
|
|
- Para usar **emulador**, abra o Android Studio > Device Manager > crie e inicie um AVD (Android Virtual Device).
|
|
|
|
- Para usar **celular**, ative o modo desenvolvedor, depuração USB e conecte o dispositivo via cabo.
|
|
|
|
|
|
|
|
* ESLint
|
|
|
|
* Prettier |
|
|
\ No newline at end of file |
