Setup do Mobile¶

Guia completo para configurar e executar o aplicativo mobile do TepConfina.

Pre-requisitos¶

Ferramenta	Versao Minima	Plataforma
Flutter SDK	3.x	Todas
Dart	3.x	Incluso no Flutter
Android Studio	2024.x	Android
Xcode	15+	iOS (somente macOS)
Java JDK	17	Android
CocoaPods	1.14+	iOS (somente macOS)

Xcode somente macOS

O desenvolvimento para iOS requer macOS com Xcode instalado. Para desenvolvimento exclusivo Android, Linux e Windows tambem sao suportados.

Clonando o Repositorio¶

git clone git@github.com:TecnoePec/tepconfina-mobile.git
cd tepconfina-mobile

Verificando o Ambiente¶

Execute o diagnostico do Flutter:

flutter doctor -v

Todos os itens devem estar marcados com checkmark verde. Resolva quaisquer pendencias antes de prosseguir.

Instalando Dependencias¶

flutter pub get

Principais Dependencias¶

Pacote	Funcao
flutter_riverpod	Gerenciamento de estado
hive / hive_flutter	Armazenamento local
dio	Cliente HTTP
go_router	Navegacao
freezed	Imutabilidade e union types
mocktail	Mocks para testes

Configuracao de Ambiente¶

Copie o arquivo de exemplo:

cp .env.example .env

Conteudo do .env:

API_URL=http://10.0.2.2:5000
APP_NAME=TepConfina

IP do emulador Android

O endereco 10.0.2.2 e o alias do localhost da maquina host no emulador Android. Para dispositivos fisicos, use o IP da rede local.

Executando o Projeto¶

Android¶

# Listar dispositivos disponiveis
flutter devices

# Executar no emulador ou dispositivo conectado
flutter run

iOS (somente macOS)¶

# Instalar dependencias nativas
cd ios && pod install && cd ..

# Executar no simulador
flutter run -d ios

Modo de desenvolvimento¶

# Hot reload automatico
flutter run --debug

Estrutura do Projeto¶

lib/
  core/
    config/         # Configuracoes da app
    services/       # AuthService, ApiService, StorageService
    theme/          # Tema e cores
  features/
    auth/           # Login, registro
    dashboard/      # Tela principal
    lotes/          # Gestao de lotes
    animais/        # Gestao de animais
    pesagens/       # Registro de pesagens
  shared/
    models/         # Modelos de dados
    providers/      # Riverpod providers
    widgets/        # Widgets reutilizaveis

Comandos Uteis¶

Comando	Descricao
`flutter pub get`	Instala dependencias
`flutter run`	Executa o app
`flutter test`	Roda os testes
`flutter build apk`	Gera APK de release
`flutter build ios`	Gera build iOS
`flutter clean`	Limpa cache e build
`dart run build_runner build`	Gera codigo (freezed, json)

Geracao de Codigo¶

Apos alterar modelos com anotacoes @freezed ou @JsonSerializable:

dart run build_runner build --delete-conflicting-outputs

Watch mode

Use dart run build_runner watch durante o desenvolvimento para regenerar codigo automaticamente.

Verificacao

O app deve abrir na tela de login. Utilize as mesmas credenciais do ambiente web para autenticar.