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

📊 P18: Radar de Habilidades (Canvas 2D & Gráficos)

v1.0 — Android Nativo, Kotlin, Custom Views, Android Canvas 2D, Paint, Geometria Analítica e Gráficos de Radar Poligonais (Spider Chart)

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

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

🏛️ Visão Geral & Arquitetura Visual

O projeto Radar de Habilidades (Spider Chart) ensina a desenhar componentes visuais customizados no mais baixo nível da renderização do Android através da criação de Custom Views. A aplicação implementa uma classe estendendo View, sobrescrevendo o método onDraw(Canvas), calculando vértices poligonais com trigonometria analítica ($\sin$, $\cos$), configurando pincéis estéticos com a classe Paint (antialiasing, preenchimentos semitransparentes e gradientes) e animando a transição de atributos de personagens RPG (Força, Destreza, Inteligência, Vitalidade, Agilidade e Carisma).

📁 Estrutura de Pastas Anti-Colisão

A Custom View, os modelos matemáticos e as telas residem na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p18_radar_canvas/
├── assets/
│   ├── mockup_radar_fluxo.svg
│   ├── screenshot_01_radar_guerreiro.svg
│   ├── screenshot_02_radar_ladino.svg
│   └── screenshot_03_radar_mago.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/radarcanvas/
│   │   │       │   ├── view/
│   │   │       │   │   └── RadarChartView.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: Criar componente customizado RadarChartView : View(context, attrs).
• RF-02: Desenhar teia concêntrica de níveis (ex: 20%, 40%, 60%, 80%, 100%) com linhas cinzas finas.
• RF-03: Projetar os eixos radiais a partir do centro da tela utilizando funções trigonométricas.
• RF-04: Preencher a área do polígono de atributos com cor ciano semitransparente e borda sólida.
• RF-05: Disponibilizar método público setAtributos(mapaAtributos) disparando invalidate().

Requisitos Não-Funcionais (RNF)

• RNF-01 (Zero Alocação no Draw): Proibição estrita de criar novos objetos Paint() ou Path() durante o loop do onDraw().
• RNF-02 (Anti-Aliasing Completo): Pincéis configurados com suavização de bordas para eliminar serrilhados.
• RNF-03 (Frame Rate): Renderização contínua a 60/120 FPS com aceleração por hardware nativa da GPU.
• RNF-04 (Compatibilidade de Versão): Suporte estável desde Android API 21 até Android API 34.
• RNF-05 (Responsividade Geométrica): Centro e raio do gráfico calculados dinamicamente com base em min(width, height) / 2.

3. Diagrama de Casos de Uso

flowchart TD
    Player([fa:fa-user Jogador de RPG])
    Canvas[(fa:fa-palette Android Canvas 2D)]
    Animator[(fa:fa-wave-square ValueAnimator)]

    subgraph AppRadar ["📊 Radar de Habilidades (mobile-android-kotlin)"]
        UC01["Selecionar Classe de Herói"]
        UC02["Interpolar Vértices dos Atributos"]
        UC03["Desenhar Teia Poligonal de Fundo"]
        UC04["Renderizar Preenchimento Ciano Semitransparente"]
        UC05["Desenhar Rótulos de Texto nos Eixos"]
    end

    Player --> UC01
    UC01 --> UC02
    UC02 --> Animator
    Animator -.->|onAnimationUpdate| UC03
    UC03 --> Canvas
    UC04 --> Canvas
    UC05 --> Canvas

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada (RadarChartView.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_p18_radar_canvas/mobile-android-kotlin

2. Compile e execute no emulador ou dispositivo físico

./gradlew assembleDebug
./gradlew test

🏁 Matriz de Checkpoints de Conclusão