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

🪪 P04: Cartão de Visitas Digital em ConstraintLayout

v1.0 — Android Nativo, Kotlin, ConstraintLayout Avançado, Chains, Guidelines Percentuais e Intents Nativas

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

• P01: Dados RPG (2D, 3D & Ciclo de Vida)
• P02: Jogo da Memória (PNG & POC)
• P03: Genius / Simon Says Clássico & Demo de Áudio
• ➡️ P04 (este): Cartão de Visitas Digital · ConstraintLayout & Intents
• P05: Quiz Game com Cronômetro Decrescente

🏛️ Visão Geral & Arquitetura Visual

O Cartão de Visitas Digital ensina a projetar interfaces responsivas de nível profissional no Android sem aninhar múltiplos layouts pesados. O projeto foca no uso avançado do ConstraintLayout: encadeamentos horizontais e verticais (Chains), linhas-guia percentuais (Guidelines), barreiras dinâmicas (Barriers), elevação Material com MaterialCardView, e integração direta com outros aplicativos nativos do smartphone por meio de Intents Implícitas (ligar para telefone, abrir WhatsApp, enviar e-mail e abrir perfil profissional no navegador).

📁 Estrutura de Pastas Anti-Colisão

Os layouts XML, recursos vetoriais e código Kotlin residem na subpasta canônica mobile-android-kotlin/:

catalogo_projetos/android_p04_cartao_views/
├── assets/
│   ├── arquitetura_cartao_views.svg
│   └── screenshot_p04.png
├── mobile-android-kotlin/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/cartaovisitas/
│   │   │       │   └── MainActivity.kt
│   │   │       ├── res/
│   │   │       │   ├── drawable/
│   │   │       │   └── layout/activity_main.xml
│   │   │       └── AndroidManifest.xml
│   │   └── 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: Construir a interface visual utilizando exclusivamente um único nó pai ConstraintLayout.
• RF-02: Empregar Guideline horizontal orientada a 35% da altura da tela para ancorar o cartão de destaque.
• RF-03: Conectar botões de ação social em cadeia horizontal ponderada (Spread Chain).
• RF-04: Configurar Intents implícitas para Discador Telefônico, Cliente de E-mail e Navegador Web.
• RF-05: Tratar cenários em que nenhum app instalado no sistema possa atender a Intent sem causar crash.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Hierarquia Plana): Eliminação de layouts aninhados profundos (flat view hierarchy) para renderização em sub-milissegundos.
• RNF-02 (Segurança de Intents): Verificação preventiva de integridade antes de chamar startActivity().
• RNF-03 (Design System): Aplicação estrita dos padrões de elevação e contraste do Material Design.
• RNF-04 (Compatibilidade de Tela): Responsividade comprovada em celulares compactos e tablets Android.
• RNF-05 (Qualidade de Código): Implementação concisa em Kotlin sem código boilerplate.

3. Diagrama de Casos de Uso

flowchart TD
    Client([fa:fa-user Contato / Cliente])
    OSApps[(fa:fa-mobile Apps do Sistema)]

    subgraph AppCartao ["🪪 Cartão Digital (mobile-android-kotlin)"]
        UC01["Visualizar Cartão de Visitas"]
        UC02["Tocar no Botão Telefone"]
        UC03["Tocar no Botão E-mail"]
        UC04["Tocar no Link GitHub/LinkedIn"]
        UC05["Compartilhar Contato via Intent"]
    end

    Client --> UC01
    Client --> UC02
    Client --> UC03
    Client --> UC04
    Client --> UC05
    UC02 -->|Intent.ACTION_DIAL| OSApps
    UC03 -->|Intent.ACTION_SENDTO| OSApps
    UC04 -->|Intent.ACTION_VIEW| OSApps

4. Matriz de Rastreabilidade (RTM)

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

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

./gradlew assembleDebug
./gradlew test

🏁 Matriz de Checkpoints de Conclusão