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

🃏 P02: Jogo da Memória com Cartas PNG & Grid

v1.0 — Android Nativo, Java, GridLayout, ImageButton, Temporizadores com Handler e Lógica de Pares

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

• P01: Dados RPG (2D, 3D & Ciclo de Vida)
• ➡️ P02 (este): Jogo da Memória com Cartas PNG · Java · GridLayout
• P02 (POC): Jogo da Memória POC · Validação de Matriz
• P03: Genius / Simon Says Clássico & Demo de Áudio

🏛️ Visão Geral & Arquitetura Visual

O Jogo da Memória Android desafia o raciocínio e a agilidade do jogador em uma grade de cartas embaralhadas aleatoriamente. O projeto aprofunda a manipulação de layouts matriciais (GridLayout), a troca dinâmica de imagens em ImageButton com estados de carta (verso e frente), e a orquestração assíncrona de temporizadores de desviramento através da classe android.os.Handler.

📁 Estrutura de Pastas Anti-Colisão

Todos os recursos gráficos, sons e código Java residem na subpasta canônica mobile-android-xml/:

catalogo_projetos/android_p02_memoria_png/
├── assets/
│   ├── arquitetura_memoria_png.svg
│   ├── screenshot.png
│   ├── screenshot_8cards.png
│   └── screenshot_classic.png
├── mobile-android-xml/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/jogomemoria/
│   │   │       │   └── MainActivity.java
│   │   │       ├── 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: Organizar os botões de cartas em grade simétrica 4x4 utilizando GridLayout.
• RF-02: Gerenciar baralho com 8 pares de cartas ilustradas em arquivos PNG transparentes.
• RF-03: Implementar máquina de estados: nenhuma carta virada, uma carta em espera, duas cartas em análise.
• RF-04: Temporizar o fechamento de cartas incompatíveis com intervalo de 1000ms usando Handler.postDelayed.
• RF-05: Disparar caixa de diálogo de vitória com resumo de desempenho ao completar os 8 pares.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Uso de Memória): Compressão otimizada de imagens PNG no diretório res/drawable evitando estouro de Heap (OutOfMemory).
• RNF-02 (Concorrência de UI): Bloqueio estrito de novos cliques enquanto a rotina assíncrona do Handler estiver em execução.
• RNF-03 (Responsividade Visual): Adaptação elástica da grade de cartas para telas de smartphones de 4.7 a 6.7 polegadas.
• RNF-04 (Compatibilidade): Suporte estável desde Android API 21 até API 34.
• RNF-05 (Qualidade de Código): Módulos Java organizados com responsabilidades claras para UI e lógica de jogo.

3. Diagrama de Casos de Uso

flowchart TD
    Player([fa:fa-user Jogador])

    subgraph AppMemoria ["🃏 Jogo da Memória (mobile-android-xml)"]
        UC01["Iniciar Partida / Embaralhar"]
        UC02["Virar Primeira Carta"]
        UC03["Virar Segunda Carta"]
        UC04["Avaliar Correspondência de Par"]
        UC05["Finalizar Partida e Exibir Estatísticas"]
    end

    Player --> UC01
    Player --> UC02
    UC02 --> UC03
    UC03 --> UC04
    UC04 -->|Par Correto| UC05

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada (MainActivity.java)

📄 mobile-android-xml/app/src/main/java/br/com/curso/memoria/MainActivity.java (arquivo real do projeto)

package br.com.curso.memoria;

import android.os.Bundle;
import android.os.Handler;
import android.widget.Button;
import android.widget.ImageButton;
import android.widget.TextView;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class MainActivity extends AppCompatActivity {

    private ImageButton primeiraCarta = null;
    private ImageButton segundaCarta = null;
    private boolean aguardando = false;
    private int paresEncontrados = 0;
    private TextView txtStatus;
    
    private final List<ImageButton> cards = new ArrayList<>();
    private final List<String> tags = new ArrayList<>();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        txtStatus = findViewById(R.id.txt_status);
        Button btnReiniciar = findViewById(R.id.btn_reiniciar);
        btnReiniciar.setOnClickListener(v -> reiniciarJogo());

        // Inicializa as referências das 8 cartas
        cards.add(findViewById(R.id.card1));
        cards.add(findViewById(R.id.card2));
        cards.add(findViewById(R.id.card3));
        cards.add(findViewById(R.id.card4));
        cards.add(findViewById(R.id.card5));
        cards.add(findViewById(R.id.card6));
        cards.add(findViewById(R.id.card7));
        cards.add(findViewById(R.id.card8));

        // Inicializa as tags (4 pares = 8 cartas)
        tags.add("poke_pikachu");
        tags.add("poke_charmander");
        tags.add("poke_squirtle");
        tags.add("poke_bulbasaur");
        tags.add("poke_pikachu");
        tags.add("poke_charmander");
        tags.add("poke_squirtle");
        tags.add("poke_bulbasaur");

        iniciarJogo();
    }

    private void iniciarJogo() {
        paresEncontrados = 0;
        txtStatus.setText("Encontre os pares!");
        
        Collections.shuffle(tags);

        for (int i = 0; i < cards.size(); i++) {
            ImageButton card = cards.get(i);
            card.setTag(tags.get(i));
            card.setEnabled(true);
            card.setImageResource(R.drawable.card_back);
            card.setOnClickListener(v -> aoClicarNaCarta(card));
        }
    }
// … (+63 linhas: veja o arquivo completo no projeto)

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/android_p02_memoria_png/mobile-android-xml

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

./gradlew assembleDebug
./gradlew test

🏁 Matriz de Checkpoints de Conclusão