📚 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 POC (Prova de Conceito de Estado)

v1.0 — Android Nativo, Java, Matriz Reduzida 2x4, Máquina de Estados Finita e Validação Rápida

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

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

🏛️ Visão Geral & Arquitetura Visual

O projeto Jogo da Memória POC (Proof of Concept) tem o propósito pedagógico de validar a máquina de estados e o algoritmo de correspondência lógica em uma escala compacta de 8 células (matriz 2x4 com 4 pares). Essa abordagem isola a complexidade de renderização gráfica, permitindo focar estritamente na mecânica de estados transitórios (IDLE, FIRST_CARD_SELECTED, EVALUATING_MATCH, ROUND_RESOLVED), controle de concorrência e testes de unidade determinísticos.

📁 Estrutura de Pastas Anti-Colisão

Todo o projeto de prova de conceito está isolado na subpasta canônica mobile-android-xml/:

catalogo_projetos/android_p02_memoria_poc/
├── assets/
│   ├── arquitetura_memoria_poc.svg
│   ├── screenshot.png
│   ├── screenshot_8cards.png
│   └── screenshot_classic.png
├── mobile-android-xml/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/memoriapoc/
│   │   │       │   └── MainActivity.java
│   │   │       ├── res/
│   │   │       │   └── 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: Configurar matriz simplificada de 8 posições [0..7] representando 4 pares de valores inteiros.
• RF-02: Gerenciar máquina de estados finita com estados explícitos de ciclo.
• RF-03: Proibir qualquer clique adicional enquanto o aplicativo avalia duas cartas abertas.
• RF-04: Emitir logs detalhados a cada transição de estado para facilitar depuração.
• RF-05: Reiniciar a matriz e zerar contadores com o clique de um botão de reset.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Simplicidade de Código): Mínimo overhead de layout para maximizar a velocidade de testes.
• RNF-02 (Robustez de Concorrência): Mecanismo de bloqueio imune a múltiplos eventos simultâneos de toque.
• RNF-03 (Desempenho): Execução sem travamentos mesmo em hardware com baixo consumo de memória.
• RNF-04 (Compatibilidade): Suporte total a partir do Android API 21.
• RNF-05 (Documentação Técnica): Regras de estado documentadas no código e matriz de rastreabilidade.

3. Diagrama de Casos de Uso

flowchart TD
    Tester([fa:fa-user Engenheiro / Tester])

    subgraph POCMemoria ["🃏 POC Máquina de Estados (mobile-android-xml)"]
        UC01["Iniciar Matriz Reduzida (8 cartas)"]
        UC02["Selecionar Carta Primária"]
        UC03["Selecionar Carta Secundária"]
        UC04["Avaliar Correspondência"]
        UC05["Verificar Telemetria e Logs"]
    end

    Tester --> UC01
    Tester --> UC02
    UC02 --> UC03
    UC03 --> UC04
    UC04 --> 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.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 Button primeiraCarta = null;
    private Button segundaCarta = null;
    private boolean aguardando = false;
    private int paresEncontrados = 0;
    private TextView txtStatus;
    
    private final List<Button> 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 dos 8 botões (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 usando Números (4 pares = 8 cartas)
        tags.add("1");
        tags.add("2");
        tags.add("3");
        tags.add("4");
        tags.add("1");
        tags.add("2");
        tags.add("3");
        tags.add("4");

        iniciarJogo();
    }

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

        for (int i = 0; i < cards.size(); i++) {
            Button card = cards.get(i);
            card.setTag(tags.get(i));
            card.setEnabled(true);
            card.setText("?"); // Face para baixo exibe "?"
            card.setOnClickListener(v -> aoClicarNaCarta(card));
        }
    }

// … (+58 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_poc/mobile-android-xml

2. Compile e execute os testes de unidade

./gradlew test
./gradlew assembleDebug

🏁 Matriz de Checkpoints de Conclusão