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

🎲 P01: Guia Passo a Passo - Dados RPG (D20 Clássico)

v1.0 — Android Nativo, Java, RelativeLayout, Views XML e Gerador Random

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

• ➡️ P01 (este): Dados RPG 2D Clássico · Java · XML Views · Eventos de Toque
• P01 (3D): Dados RPG 3D · RotateAnimation & Interpoladores
• P01 (Hello World): Ciclo de Vida & ViewBinding em Kotlin
• P02: Jogo da Memória com Cartas PNG & Grid

🏛️ Visão Geral & Arquitetura Visual

O Simulador de Dados D20 Clássico é a porta de entrada para a engenharia de software na plataforma Android utilizando a arquitetura de Views declarativas clássicas. O projeto aborda a criação de telas com XML (RelativeLayout e LinearLayout), a vinculação de componentes de interface via findViewById, a manipulação do ciclo de vida da Activity e a reação a eventos de toque do usuário com setOnClickListener.

📁 Estrutura de Pastas Anti-Colisão

Todo o código-fonte Android, recursos gráficos e scripts de compilação Gradle estão encapsulados na subpasta canônica mobile-android-xml/:

catalogo_projetos/android_p01_dado_2d/
├── assets/
│   ├── arquitetura_dado_2d.svg
│   └── screenshot_p01.png
├── mobile-android-xml/
│   ├── app/
│   │   ├── src/
│   │   │   └── main/
│   │   │       ├── java/br/com/curso/dadosrpg/
│   │   │       │   └── MainActivity.java
│   │   │       ├── res/
│   │   │       │   ├── layout/activity_main.xml
│   │   │       │   └── values/strings.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: Renderizar interface escurecida com título “DUNGEON MASTER”, mostrador numérico e botão de rolagem.
• RF-02: Gerar números pseudo-aleatórios inteiros uniformemente distribuídos entre 1 e 20 com java.util.Random.
• RF-03: Atualizar a propriedade de texto do TextView principal ao disparar o evento de clique.
• RF-04: Bloquear toques múltiplos acidentais durante a atualização do valor.
• RF-05: Exibir valor inicial neutro (ex: “D20”) antes do primeiro lançamento.

Requisitos Não-Funcionais (RNF)

• RNF-01 (Compatibilidade): Suporte retrocompatível com Android 5.0 Lollipop (API 21) até Android 14 (API 34).
• RNF-02 (Tempo de Resposta): Tempo entre o toque do usuário e a atualização da tela inferior a 16 milissegundos (60 FPS).
• RNF-03 (Consumo de Memória): Pegada de memória RAM da aplicação inferior a 30 MB.
• RNF-04 (Legibilidade): Separação estrita de strings de interface no arquivo res/values/strings.xml (i18n).
• RNF-05 (Estabilidade): Ausência total de Memory Leaks decorrentes de referências estáticas à Activity.

3. Diagrama de Casos de Uso

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

    subgraph AppDado ["🎲 App Dado D20 (mobile-android-xml)"]
        UC01["Visualizar Mesa de Jogo"]
        UC02["Tocar em Lançar Sorte"]
        UC03["Sortear Valor Aleatório (1 a 20)"]
        UC04["Identificar Sucesso/Falha Crítica"]
        UC05["Reiniciar Marcador"]
    end

    Player --> UC01
    Player --> UC02
    UC02 --> UC03
    UC03 --> UC04
    Player --> UC05

4. Matriz de Rastreabilidade (RTM)

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

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

package br.com.curso.dadosrpg;

import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import androidx.appcompat.app.AppCompatActivity;
import java.util.Random;

public class MainActivity extends AppCompatActivity {

    // Componentes da Interface
    private TextView txtResultado;
    private Button btnRolar;

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

        // Ligando o Java ao XML (IDs)
        txtResultado = findViewById(R.id.txt_resultado);
        btnRolar = findViewById(R.id.btn_rolar);

        // Ação de Clique do Botão
        btnRolar.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                rolarDado();
            }
        });
    }

    /**
     * Sorteia um número de 1 a 20 e atualiza a tela
     */
    private void rolarDado() {
        // Gerador de números aleatórios
        Random gerador = new Random();

        // Sorteia de 0 a 19 e soma 1 (para ficar de 1 a 20)
        int numero = gerador.nextInt(20) + 1;

        // Mostra o número no TextView (convertendo int para String)
        txtResultado.setText(String.valueOf(numero));
    }
}

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/android_p01_dado_2d/mobile-android-xml

2. Compile e execute via Gradle Wrapper

./gradlew assembleDebug
./gradlew test

[!TIP] No Android Studio, selecione File > Open e aponte para a pasta mobile-android-xml/. Selecione um emulador (AVD Pixel com API 33+) e clique em Run (Shift+F10).

🏁 Matriz de Checkpoints de Conclusão