|
|
|
|[Página Inicial](home)|
|
|
|
|
|---|
|
|
|
|
| [Página Inicial](home) |
|
|
|
|
| ---------------------- |
|
|
|
|
|
|
|
|
# Configuração do Projeto
|
|
|
|
|
|
|
|
## Configuração do ambiente mobile
|
|
|
|
*Acesso Rápido*
|
|
|
|
|
|
|
|
* Configuração do ambiente mobile
|
|
|
|
* Setup Backend
|
|
|
|
* Setup Frontend
|
|
|
|
* [Tecnologias necessárias](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#tecnologias-necessarias)
|
|
|
|
* [Instalação do Node](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#instalacao-do-node)
|
|
|
|
* [Instalação do Expo](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#instalacao-do-expo)
|
|
|
|
* [Instalação do Git](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#instalacao-do-git)
|
|
|
|
* [Instalação do Android Studio](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#instalacao-do-android-studio)
|
|
|
|
* [Iniciando o projeto](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#iniciando-o-projeto)
|
|
|
|
* [Clonar o projeto](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#clonar-o-projeto)
|
|
|
|
* [Executar o projeto](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#executar-o-projeto)
|
|
|
|
* [Problemas/erros comuns](https://tools.ages.pucrs.br/descarta-facil/descartafacil-wiki/wikis/configuracao#problemaserros-mais-comuns)
|
|
|
|
|
|
|
|
## Configuração do ambiente mobile
|
|
|
|
Texto texto
|
|
|
|
|
|
|
|
### Setup back-end
|
|
|
|
Texto texto
|
|
|
|
|
|
|
|
### Setup front-end
|
|
|
|
Texto texto
|
|
|
|
|
|
|
|
#### Setup front-end
|
|
|
|
# Tecnologias necessárias
|
|
|
|
|
|
|
|
#### Preparação do ambiente React-Native
|
|
|
|
## Instalação do Node
|
|
|
|
|
|
|
|
**Nodejs:**
|
|
|
|
O primeiro passo para configuração do nosso ambiente é a instalação do [Node.js][0], pois este irá gerenciar e preparar nosso ambiente.
|
|
|
|
|
|
|
|
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/
|
|
|
|
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][1].
|
|
|
|
|
|
|
|
**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
|
|
|
|
|
|
|
|
**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 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.
|
|
|
|
O [Expo][2] 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:
|
|
|
|
|
|
|
|
**Virtual ou por dispositivo:**
|
|
|
|
```bash
|
|
|
|
npm install -g expo-cli
|
|
|
|
```
|
|
|
|
|
|
|
|
É possível executar/reproduzir o projeto em dispositivos virtuais ou em dispositivos reais (seu próprio celular/tablet).
|
|
|
|
Onde:
|
|
|
|
|
|
|
|
**Usando seu dispositivo:**
|
|
|
|
* `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.
|
|
|
|
|
|
|
|
Para usar seu próprio celular é necessário baixar o aplicativo do Expo.
|
|
|
|
**Instalação do Expo Go**
|
|
|
|
|
|
|
|
Para Android: https://play.google.com/store/apps/details?id=host.exp.exponent&hl=pt_BR&gl=US
|
|
|
|
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][3] quanto para [iOS][4].
|
|
|
|
|
|
|
|
Para IOS: https://apps.apple.com/br/app/expo-go/id982107779
|
|
|
|
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.
|
|
|
|
|
|
|
|
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.
|
|
|
|
## Instalação do Git
|
|
|
|
|
|
|
|
**OBS:** Em alguns dispositivos, versões e/ou sistemas, não é necessário passar pelo Wizard após instalado o App.
|
|
|
|
O [git][5] é 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][6].
|
|
|
|
|
|
|
|
**Virtual/Emulador:**
|
|
|
|
## Instalação do Android Studio
|
|
|
|
|
|
|
|
Para Android: https://developer.android.com/studio?hl=pt
|
|
|
|
**Este passo é só para caso você deseje emular um dispositivo virtual.**
|
|
|
|
|
|
|
|
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.
|
|
|
|
Baixe e instale o Android Studio do [site oficial][7]. 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)
|
|
|
|
**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.
|
|
|
|
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*
|
|
|
|
# Iniciando o projeto
|
|
|
|
|
|
|
|
*tutorial aqui*
|
|
|
|
## Clonar o projeto
|
|
|
|
|
|
|
|
**Clonando o projeto:**
|
|
|
|
Vá ao [repositório do projeto][8] e em **Clone**, copie o link da forma de clonagem que preferir.
|
|
|
|
|
|
|
|
Antes de tudo, garanta que você possui o git instalado (se necessário no seu sistema operacional: https://git-scm.com/downloads)
|
|
|
|
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**.
|
|
|
|
|
|
|
|
- Vá no nosso repositório https://tools.ages.pucrs.br/descarta-facil/descartafacil-mobile
|
|
|
|
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.
|
|
|
|
|
|
|
|
- Em "clone", copie o texto da forma de clonagem que você preferir
|
|
|
|
## Executar o projeto
|
|
|
|
|
|
|
|
- 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"
|
|
|
|
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.
|
|
|
|
|
|
|
|
- Na nova janela aberta, digite "git clone <link>". Substitua "<link>" pelo texto copiado anteriormente, no repositório do projeto. Confirme o comando e, após terminar, seu projeto estará pronto para ser iniciado
|
|
|
|
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.
|
|
|
|
|
|
|
|
**Iniciando o projeto:**
|
|
|
|
**Usando seu dispositivo físico:**
|
|
|
|
|
|
|
|
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 físico, apenas aponte a câmera para o **QRCODE** que aparecerá no terminal.
|
|
|
|
|
|
|
|
Caso esteja usando um dispositivo real, apenas aponte o leitor para o QR CODE que aparecerá no terminal.
|
|
|
|
**Virtual/Emulador:**
|
|
|
|
|
|
|
|
Caso esteja usando o emulador, use o comando `npm run <android/ios>` para inciar a compilação/build.
|
|
|
|
|
|
|
|
Caso esteja usando o emulador, use o comando "npm run android" para inciar a compilação/build
|
|
|
|
Para IOS: *link aqui*
|
|
|
|
|
|
|
|
*tutorial aqui*
|
|
|
|
|
|
|
|
#### Problemas/erros mais comuns
|
|
|
|
# Problemas/erros mais comuns
|
|
|
|
|
|
|
|
**"Intel HAXM installation failed" durante instalação/inicialização do dispositivo virtual":**
|
|
|
|
|
| ... | ... | @@ -91,4 +115,14 @@ Este erro refere-se as configurações do seu Windows em relação a execução |
|
|
|
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 |
|
|
\ No newline at end of file |
|
|
|
https://docs.microsoft.com/pt-br/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.1
|
|
|
|
|
|
|
|
[0]: https://nodejs.org/en/ "Node.js' Homepage"
|
|
|
|
[1]: https://nodejs.org/en/download/ "Node.js' Download page"
|
|
|
|
[2]: https://expo.io/ "Expo's Homepage"
|
|
|
|
[3]: https://play.google.com/store/apps/details?id=host.exp.exponent&hl=pt_BR&gl=US "Expo Go's android app download page"
|
|
|
|
[4]: https://apps.apple.com/br/app/expo-go/id982107779 "Expo Go's iOS app download page"
|
|
|
|
[5]: https://git-scm.com/ "Git's Homepage"
|
|
|
|
[6]: https://git-scm.com/downloads "Git's download page"
|
|
|
|
[7]: https://developer.android.com/studio?hl=pt "Android Studio's Download page"
|
|
|
|
[8]:https://tools.ages.pucrs.br/descarta-facil/descartafacil-mobile "Descarta facil's project repository" |
