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

🚨 P16: Alerta Gotham (Broadcast & Alarmes)

v1.0 — Android Nativo, Kotlin, BroadcastReceiver Dinâmico e Estático, AlarmManager com Alarmes Exatos e Disparo do Bat-Sinal

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

• P15: J.A.R.V.I.S. Sync com WorkManager
• ➡️ P16 (este): Alerta Gotham com Broadcast & Alarmes
• P17: Anime Soundboard com MediaPlayer
• P18: Radar de Habilidades com Canvas 2D
• P19: Banco de Wakanda com MVVM & Room

🏛️ Visão Geral & Arquitetura Visual

O projeto Alerta Gotham domina o sistema de comunicação por difusão de eventos (event broadcasting) e agendamento temporal de alta precisão no Android. A aplicação implementa BroadcastReceiver dinâmico e contextual para capturar alterações de estado do hardware (bateria fraca, conexão de fone de ouvido, modo avião) e orquestra o AlarmManager com alarmes exatos (setExactAndAllowWhileIdle) para projetar o Bat-Sinal nos céus de Gotham no horário exato de patrulha programado pelo Comissário Gordon.

📁 Estrutura de Pastas Anti-Colisão

Os receptores de transmissão, agendadores de alarme e layouts residem na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p16_gotham_broadcast/
├── assets/
│   ├── mockup_gotham_fluxo.svg
│   ├── screenshot_01_gotham_painel.svg
│   ├── screenshot_02_gotham_armado.svg
│   └── screenshot_03_gotham_notificacao.svg
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/alertagotham/
│   │   │       │   ├── receiver/
│   │   │       │   │   └── BatSinalReceiver.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 estendendo BroadcastReceiver com tratamento do callback onReceive().
• RF-02: Configurar AlarmManager com setExactAndAllowWhileIdle() garantindo execução no Doze Mode.
• RF-03: Empacotar a ação de alerta em uma PendingIntent.getBroadcast() com flag imutável.
• RF-04: Registrar dinamicamente receptor para escuta de eventos de energia e conectividade.
• RF-05: Disponibilizar botão para cancelar alarmes previamente agendados.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Pontualidade Temporal): Desvio temporal de disparo do alarme exato inferior a 1 segundo.
• RNF-02 (Conformidade com Android 12+): Verificação de permissão SCHEDULE_EXACT_ALARM em APIs modernas.
• RNF-03 (Execução Rápida do Receiver): Limitação estrita do tempo de processamento dentro do onReceive (< 10 segundos).
• RNF-04 (Compatibilidade de Versão): Suporte estável desde Android API 21 até Android API 34.
• RNF-05 (Segurança de Transmissão): Proteção contra transmissões falsificadas exigindo intents explícitas ou permissões de assinatura.

3. Diagrama de Casos de Uso

flowchart TD
    Gordon([fa:fa-user Comissário Gordon])
    Alarm[(fa:fa-clock AlarmManager)]
    Receiver[(fa:fa-tower-broadcast BatSinalReceiver)]
    Notif[(fa:fa-bell Notificação de Emergência)]

    subgraph AppGotham ["🚨 Alerta Gotham (mobile-android-kotlin)"]
        UC01["Programar Horário de Patrulha"]
        UC02["Agendar Alarme Exato no Sistema"]
        UC03["Disparar Evento de Broadcast"]
        UC04["Emitir Alerta do Bat-Sinal"]
        UC05["Cancelar Alarme Ativo"]
    end

    Gordon --> UC01
    UC01 --> UC02
    UC02 --> Alarm
    Alarm -.->|Tempo Atingido| UC03
    UC03 --> Receiver
    Receiver --> UC04
    UC04 --> Notif
    Gordon --> UC05
    UC05 --> Alarm

4. Matriz de Rastreabilidade (RTM)

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

2. Compile e instale no dispositivo

./gradlew installDebug

🏁 Matriz de Checkpoints de Conclusão