5.3 KiB

Raw Blame History

📱 Conversor de Moedas - Instruções de Uso

🚀 Como Executar o Aplicativo

Pré-requisitos

Android Studio instalado
Android SDK configurado
Dispositivo Android ou emulador

Passos para Executar

Abrir o Projeto

# Navegar para o diretório do projeto
cd /Users/240408/AndroidStudioProjects/conversordemoedas2

# Abrir no Android Studio
open -a "Android Studio" .

Sincronizar Dependências
- O Android Studio irá sincronizar automaticamente
- Ou execute: ./gradlew build
Executar o App
- Conecte um dispositivo Android ou inicie um emulador
- Clique em "Run" (▶️) no Android Studio
- Ou execute: ./gradlew installDebug

💱 Como Usar o Conversor

Interface Principal

Campo de Valor
- Digite o valor que deseja converter
- Aceita números decimais (ex: 100.50)
- Valores devem ser positivos
Seleção de Moedas
- De: Moeda de origem (padrão: USD)
- Para: Moeda de destino (padrão: BRL)
- Use os spinners para selecionar
Conversão
- Clique no botão "Converter"
- O resultado aparecerá abaixo do botão
- Formato: símbolo + valor (ex: R$ 520.00)
Taxa de Câmbio
- Mostra a taxa atual entre as moedas selecionadas
- Atualiza automaticamente ao mudar as moedas
Histórico
- Lista as últimas 50 conversões realizadas
- Mostra: valor original, resultado e data/hora
- Botão "Limpar" para apagar o histórico

🗄️ Banco de Dados SQLite

Estrutura das Tabelas

Tabela `currencies`

CREATE TABLE currencies (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    code TEXT UNIQUE NOT NULL,        -- Código da moeda (USD, BRL, etc.)
    name TEXT NOT NULL,               -- Nome completo
    symbol TEXT NOT NULL,             -- Símbolo ($, R$, €, etc.)
    rate_to_usd REAL NOT NULL         -- Taxa em relação ao USD
);

Tabela `conversions`

CREATE TABLE conversions (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    from_currency TEXT NOT NULL,      -- Moeda de origem
    to_currency TEXT NOT NULL,        -- Moeda de destino
    amount REAL NOT NULL,             -- Valor convertido
    result REAL NOT NULL,             -- Resultado
    date TEXT NOT NULL                -- Timestamp da conversão
);

Moedas Pré-cadastradas

Código	Nome	Símbolo	Taxa USD
USD	Dólar Americano	$	1.0
BRL	Real Brasileiro	R$	5.2
EUR	Euro	€	0.85
GBP	Libra Esterlina	£	0.73
JPY	Iene Japonês	¥	110.0
CAD	Dólar Canadense	C$	1.25
AUD	Dólar Australiano	A$	1.35
CHF	Franco Suíço	CHF	0.92
CNY	Yuan Chinês	¥	6.45
MXN	Peso Mexicano	$	20.0

🔧 Funcionalidades Técnicas

Conversão de Moedas

Algoritmo: Conversão via USD como moeda intermediária
Fórmula: resultado = (valor / taxa_origem) * taxa_destino
Precisão: Dupla precisão para cálculos

Persistência

SQLite: Banco local no dispositivo
Criação: Automática na primeira execução
Dados: Inserção automática das moedas padrão

Interface

Material Design: Componentes modernos
Responsiva: Adaptável a diferentes telas
Validação: Entrada de dados segura

🧪 Testando o Aplicativo

Testes Manuais

Conversão Básica
- Valor: 100
- De: USD
- Para: BRL
- Resultado esperado: R$ 520.00
Conversão Decimal
- Valor: 99.99
- De: EUR
- Para: JPY
- Verificar precisão do cálculo
Mesma Moeda
- Valor: 50
- De: USD
- Para: USD
- Resultado: $ 50.00
Histórico
- Realizar várias conversões
- Verificar se aparecem no histórico
- Testar botão "Limpar"

Testes Automatizados

Para executar os testes de demonstração:

// Na MainActivity, descomente esta linha:
CurrencyConverterDemo.runDemo(this);

Isso executará testes automáticos e mostrará os resultados no log.

🐛 Solução de Problemas

Problemas Comuns

App não compila
- Verificar se todas as dependências estão instaladas
- Executar ./gradlew clean e ./gradlew build
Conversão não funciona
- Verificar se o valor é positivo
- Confirmar se as moedas estão selecionadas
Histórico vazio
- Normal na primeira execução
- Realizar algumas conversões primeiro
Taxa de câmbio incorreta
- As taxas são fixas e podem não refletir valores reais
- Para valores reais, integrar com API de câmbio

Logs de Debug

Para ver logs detalhados:

adb logcat | grep CurrencyConverter

📈 Melhorias Futuras

Integração com API de câmbio em tempo real
Gráficos de histórico de conversões
Notificações de mudanças de taxa
Suporte a mais moedas
Modo offline/online
Backup e sincronização de dados
Temas claro/escuro
Calculadora de taxas
Favoritos de conversões
Exportar histórico

📞 Suporte

Para dúvidas ou problemas:

Verificar os logs do Android
Testar com valores simples primeiro
Verificar se o banco de dados foi criado corretamente
Consultar a documentação do código

Desenvolvido com ❤️ usando Android SDK, SQLite e Material Design

5.3 KiB Raw Blame History