📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados na Especialização em Android Nativo. Recomendado revisar antes de iniciar.

⚔️ P21: Duelo Jedi (Física 2D & Colisão)

v1.0 — Android Nativo, Kotlin, Mecânica de Física 2D, Detecção de Colisão Geométrica (Círculo-Círculo e AABB), Game Loop e Renderização a 60 FPS

Série Prática Android Clássico — Projeto 21 de 21

• P19: Banco de Wakanda com MVVM & Room
• P20: Alliance Battle com Finite State Machine
• ➡️ P21 (este): Duelo Jedi com Física 2D & Colisão

🏛️ Visão Geral & Arquitetura Visual

O projeto Duelo Jedi encerra a trilha de especialização em desenvolvimento Android nativo explorando a construção de motores de jogos 2D a partir do zero. A aplicação implementa um Game Loop contínuo com delta-time ($\Delta t$), cálculos vetoriais de velocidade, aceleração e gravidade espacial, e algoritmos rigorosos de Detecção e Resolução de Colisão (Bounding Box AABB e Círculos Delimitadores) entre sabres de luz e projéteis de plasma, renderizados com alta performance em SurfaceView / Canvas 2D.

📁 Estrutura de Pastas Anti-Colisão

Os motores físicos, entidades de jogo e telas residem na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p21_duelo_physics/
├── assets/
│   ├── mockup_duelo_fluxo.svg
│   ├── screenshot_01_duelo_arena.svg
│   ├── screenshot_02_duelo_acao.svg
│   └── screenshot_03_duelo_vitoria.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/duelojedi/
│   │   │       │   ├── physics/
│   │   │       │   │   ├── Vetor2D.kt
│   │   │       │   │   └── CollisionDetector.kt
│   │   │       │   ├── game/
│   │   │       │   │   └── GameSurfaceView.kt
│   │   │       │   └── MainActivity.kt
│   │   │       └── res/
│   │   └── build.gradle
│   ├── gradle/
│   ├── build.gradle
│   ├── gradlew
│   ├── settings.gradle
│   └── README.md
└── index.md

🧑‍💼 Engenharia de Software & Especificação Formal

1. Histórias de Usuário (User Stories)

2. Requisitos do Sistema

Requisitos Funcionais (RF)

• RF-01: Implementar classe matemática Vetor2D(x, y) suportando soma, produto escalar e magnitude.
• RF-02: Implementar detecção de colisão círculo-círculo: $(x_2 - x_1)^2 + (y_2 - y_1)^2 \leq (r_1 + r_2)^2$.
• RF-03: Executar loop de renderização em thread secundária via SurfaceView.
• RF-04: Calcular ricochete físico invertendo vetores normais no ponto de contato.
• RF-05: Capturar eventos multitoque através do método onTouchEvent(MotionEvent).

Requisitos Não-Funcionais (RNF)

• RNF-01 (Taxa de Quadros Constante): Manutenção contínua de 60 quadros por segundo sem oscilações perceptíveis.
• RNF-02 (Isolamento de Thread): Zero operações pesadas de física ou travamentos de Canvas na UI Thread.
• RNF-03 (Alocação Dinâmica Zero): Proibição de instanciar novos vetores ou objetos dentro do loop update().
• RNF-04 (Compatibilidade de Versão): Suporte estável desde Android API 21 até Android API 34.
• RNF-05 (Precisão Numérica): Cálculos físicos em ponto flutuante (Float) para equilíbrio entre precisão e velocidade.

3. Diagrama de Casos de Uso

flowchart TD
    Player([fa:fa-user Jogador / Jedi])
    GameLoop[(fa:fa-arrows-spin Game Loop Thread)]
    Physics[(fa:fa-atom Motor de Física 2D)]

    subgraph AppJedi ["⚔️ Duelo Jedi (mobile-android-kotlin)"]
        UC01["Controlar Posição do Sabre"]
        UC02["Atualizar Posição dos Projéteis"]
        UC03["Avaliar Colisão Projétil x Sabre"]
        UC04["Defletir Vetor com Ricochete"]
        UC05["Renderizar Frame no Canvas"]
    end

    Player --> UC01
    GameLoop --> UC02
    UC02 --> Physics
    UC01 --> Physics
    Physics --> UC03
    UC03 -->|Intersecção| UC04
    Physics --> UC05
    UC05 --> GameLoop

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada (CollisionDetector.kt)

ℹ️ O trecho de código que ficava aqui não correspondia ao código do projeto e foi retirado. Consulte os arquivos em mobile-android-kotlin.

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/android_p21_duelo_physics/mobile-android-kotlin

2. Compile e execute os testes unitários do motor físico

./gradlew test
./gradlew assembleDebug

🏁 Matriz de Checkpoints de Conclusão