Pablo
220 lines
5.2 KiB
Markdown
220 lines
5.2 KiB
Markdown
# 📦 Guía de Instalación Rápida - iTartanas
|
|
|
|
## 🎉 ¡La aplicación está lista!
|
|
|
|
El proyecto se ha compilado exitosamente. Tienes dos versiones de APK disponibles:
|
|
|
|
---
|
|
|
|
## 📱 APKs Generados
|
|
|
|
### 1️⃣ APK Debug (Desarrollo)
|
|
```
|
|
📍 Ubicación:
|
|
app\build\outputs\apk\debug\app-debug.apk
|
|
|
|
✅ Ideal para: Desarrollo y pruebas
|
|
✅ Tamaño: ~5-10 MB
|
|
✅ Firma: Debug keystore
|
|
```
|
|
|
|
### 2️⃣ APK Release (Producción)
|
|
```
|
|
📍 Ubicación:
|
|
app\build\outputs\apk\release\app-release-unsigned.apk
|
|
|
|
⚠️ Nota: Sin firmar (necesita firma para distribución pública)
|
|
✅ Ideal para: Uso personal
|
|
✅ Tamaño: ~5-10 MB (optimizado)
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Instalación en Dispositivo Android
|
|
|
|
### Método 1: Transferencia Manual (Recomendado)
|
|
|
|
1. **Copia el APK** a tu dispositivo Android:
|
|
- Por cable USB
|
|
- Por Google Drive / Dropbox
|
|
- Por correo electrónico
|
|
- Por Bluetooth
|
|
|
|
2. **En tu dispositivo Android**:
|
|
- Abre el **Explorador de Archivos**
|
|
- Navega a la ubicación del APK
|
|
- Toca el archivo `app-debug.apk`
|
|
|
|
3. **Permite instalación**:
|
|
- Si es la primera vez: Ve a **Configuración** → **Seguridad**
|
|
- Activa **"Fuentes desconocidas"** o **"Instalar apps desconocidas"**
|
|
- Vuelve y toca el APK de nuevo
|
|
|
|
4. **Instala**:
|
|
- Toca **"Instalar"**
|
|
- Espera a que termine
|
|
- Toca **"Abrir"**
|
|
|
|
### Método 2: Desde Android Studio
|
|
|
|
1. Conecta tu dispositivo Android por USB
|
|
2. En Android Studio, haz clic en **"Run"** (▶️)
|
|
3. Selecciona tu dispositivo
|
|
4. La app se instalará automáticamente
|
|
|
|
### Método 3: ADB (Para desarrolladores)
|
|
|
|
```bash
|
|
# Desde la raíz del proyecto
|
|
adb install app\build\outputs\apk\debug\app-debug.apk
|
|
```
|
|
|
|
---
|
|
|
|
## ✅ Verificación Post-Instalación
|
|
|
|
Después de instalar, verifica que:
|
|
|
|
1. ✅ El icono de **iTartanas** aparece en el cajón de aplicaciones
|
|
2. ✅ Al abrir, muestra la pantalla de "Lector de Tarjeta Millennium"
|
|
3. ✅ Tu dispositivo tiene **NFC activado**:
|
|
- Ve a **Configuración** → **Conexiones** → **NFC**
|
|
- Activa el interruptor
|
|
|
|
---
|
|
|
|
## 🧪 Primera Prueba
|
|
|
|
1. Abre la aplicación **iTartanas**
|
|
2. Verás la pantalla de instrucciones
|
|
3. Acerca tu **Tarjeta Millennium** al lector NFC
|
|
4. En 1-2 segundos verás:
|
|
- ✅ Número de tarjeta (enmascarado)
|
|
- ✅ Saldo actual
|
|
- ✅ Últimos 3 movimientos
|
|
|
|
---
|
|
|
|
## 📍 Ubicación del Lector NFC
|
|
|
|
El lector NFC suele estar en la **parte trasera** del teléfono:
|
|
|
|
```
|
|
┌─────────────┐
|
|
│ │
|
|
│ [Cámara] │ ← Cerca de aquí
|
|
│ │
|
|
│ NFC │ ← Zona NFC
|
|
│ │
|
|
│ │
|
|
└─────────────┘
|
|
```
|
|
|
|
**Tip**: Prueba moviendo la tarjeta lentamente por la parte trasera hasta que la app responda.
|
|
|
|
---
|
|
|
|
## ⚠️ Solución de Problemas Comunes
|
|
|
|
### "No se puede instalar la aplicación"
|
|
**Solución**: Activa la instalación de fuentes desconocidas en Configuración
|
|
|
|
### "Este dispositivo no tiene NFC"
|
|
**Solución**: Verifica que tu dispositivo tiene hardware NFC (busca en las especificaciones)
|
|
|
|
### "Por favor, activa el NFC"
|
|
**Solución**: Ve a Configuración → Conexiones → NFC y actívalo
|
|
|
|
### "Error al leer la tarjeta"
|
|
**Soluciones**:
|
|
- Mantén la tarjeta estable 2 segundos
|
|
- Limpia la tarjeta y el teléfono
|
|
- Quita la funda del teléfono si es metálica
|
|
- Intenta en otra zona del teléfono
|
|
|
|
---
|
|
|
|
## 🔄 Actualización de la App
|
|
|
|
Para actualizar a una nueva versión:
|
|
|
|
1. Desinstala la versión anterior (opcional)
|
|
2. Instala el nuevo APK
|
|
3. O simplemente instala sobre la versión existente
|
|
|
|
**Nota**: Como la app no guarda datos, no perderás información.
|
|
|
|
---
|
|
|
|
## 📊 Información del Build
|
|
|
|
```
|
|
✅ Estado: BUILD SUCCESSFUL
|
|
✅ Tareas ejecutadas: 95
|
|
✅ Errores: 0
|
|
✅ Warnings: 0 críticos
|
|
✅ Tiempo de compilación: ~1-2 minutos
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 Funcionalidades Disponibles
|
|
|
|
Una vez instalada, podrás:
|
|
|
|
1. ✅ **Leer número de tarjeta** - En formato seguro y enmascarado
|
|
2. ✅ **Consultar saldo** - En tiempo real desde el chip NFC
|
|
3. ✅ **Ver últimos 3 movimientos** con:
|
|
- Fecha y hora exacta
|
|
- Tipo de operación (Carga/Validación)
|
|
- Importe de la operación
|
|
- Ubicación o línea del transporte
|
|
|
|
---
|
|
|
|
## 📱 Requisitos del Dispositivo
|
|
|
|
Para usar iTartanas necesitas:
|
|
|
|
- ✅ **Android 7.0** o superior (API 24+)
|
|
- ✅ **Hardware NFC** en el dispositivo
|
|
- ✅ **NFC activado** en configuración
|
|
- ✅ **Tarjeta Millennium** válida
|
|
|
|
---
|
|
|
|
## 🔒 Privacidad
|
|
|
|
La aplicación:
|
|
- ✅ **NO** requiere conexión a Internet
|
|
- ✅ **NO** guarda tus datos
|
|
- ✅ **NO** envía información a servidores
|
|
- ✅ **Solo lee** la información pública del chip NFC
|
|
- ✅ **No puede modificar** el saldo o datos
|
|
|
|
---
|
|
|
|
## 📞 ¿Necesitas Ayuda?
|
|
|
|
Consulta estos documentos en el proyecto:
|
|
|
|
1. **README.md** - Documentación técnica completa
|
|
2. **INSTALLATION_GUIDE.md** - Guía detallada de uso
|
|
3. **CHANGELOG.md** - Cambios y características
|
|
4. **RESUMEN.md** - Resumen ejecutivo del proyecto
|
|
|
|
---
|
|
|
|
## 🎊 ¡Listo para Usar!
|
|
|
|
Tu aplicación **iTartanas** está completamente funcional y lista para leer tu Tarjeta Millennium.
|
|
|
|
**¡Disfruta de la app!** 🚇🚌🚋
|
|
|
|
---
|
|
|
|
**Última actualización**: 9 de Marzo, 2026
|
|
**Versión**: 1.0
|
|
**Build**: SUCCESSFUL ✅
|
|
|