Skip to content

GitLab

Last edited by Angelo Calebe Araujo da Rocha
Page history

configuracao

Home Escopo e Cronograma Processo Design/Mockups Configuração Arquitetura Código Banco de Dados Qualidade

Configurações do Projeto

Descrição

Esta seção apresentará todas as configurações para executar o projeto.

Sumário

Configurações Gerais

Aqui serão encontradas as instruções de configuração de ambos ambientes de desenvolvimento.

Configurando a IDE

Primeiramente, você terá que instalar os seguintes programas em sua máquina:

  • Instale o Android Studio, para simular um Android
  • Ou, caso estiver utilizando macOS, instale o Xcode na App Store e digite o comando abaixo no terminal, para abrir o simulador de IPhone:
open -a Simulator
  • Se estiver utilizando a IDE Visual Studio Code, é recomendado baixar as seguintes extensões:
    • Awesome Flutter Snippets;
    • Dart;
    • Flutter.

Clonando os Repositórios

Os repositórios apus-drone-backend e apus-drone-frontend deverão ser clonados em sua máquina para executar o projeto.

A clonagem do backend pode ser feita através do seguinte comando pelo terminal:

git clone http://tools.ages.pucrs.br/apus-drones/apus-drones-backend.git

e do frontend:

git clone http://tools.ages.pucrs.br/apus-drones/apus-drones-frontend.git

Backend

Configurando a Máquina

Executando

  • Abrir o arquivo apus-drone-backend em sua máquina na IDE escolhida (VScode ou IntelliJ,...)
  • Para executar o projeto via terminal basta utilizar o comando abaixo:
    ./gradlew bootrun
  • Ou utilize os executáveis da sua IDE (como o Run and Debug no Visual Studio Code).

Frontend

Configurando a Máquina

  • Instale o Flutter (Linguagem Dart está incluída)
  • Para criar a sua variável de ambiente do backend você deve criar um arquivo de launch.json em sua pasta .vscode com a seguinte configuração:
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flutter",
      "request": "launch",
      "type": "dart",
      "args": ["--dart-define", "BASE_URL=localhost:8080"]
    }
  ]
}
  • Você deve definir a BASE_URL com o IP de sua máquina local , ou seja, trocar o nome localhost pelo IP de seu computador, que pode ser obtido com o comando ipconfig, no Windows, ou ip addr, no Linux.

Executando

  • Abrir o arquivo apus-drone-frontend em sua máquina na IDE escolhida (VScode ou IntelliJ,...)
  • Para executar o projeto via terminal basta utilizar o comando abaixo:
    • flutter run --dart-define BASE_URL=NOME_OU_IP:PORTA
  • Ou utilize os executáveis da sua IDE (como o Run and Debug no Visual Studio Code).

Implantação em produção

Frontend

Para gerar o APK, utilize o comando abaixo, onde BASE_URL é o endereço do backend:

flutter build apk --dart-define BASE_URL=NOME_OU_IP:PORTA

Mais detalhes no README do projeto: https://tools.ages.pucrs.br/apus-drones/apus-drones-frontend/blob/master/README.md

Infelizmente, não chegamos a subir o app nas lojas de aplicativos. A documentação do Flutter possui guias de como gerar o app e publicar nas lojas:

Backend

A implantação foi realizada na AWS, utilizando instâncias EC2 e Docker Swarm como orquestrador dos contêineres Docker, e outros recursos, descritos no diagrama de implantação disponível em https://tools.ages.pucrs.br/apus-drones/apus-drones-wiki/wikis/arquitetura#aws. Há um vídeo, gravado por @filipe.freitas, explicando em detalhes como fazer essa implantação, disponível em https://www.youtube.com/watch?v=L7KK9dqaivM.