Pablo
5.2 KiB
📦 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)
-
Copia el APK a tu dispositivo Android:
- Por cable USB
- Por Google Drive / Dropbox
- Por correo electrónico
- Por Bluetooth
-
En tu dispositivo Android:
- Abre el Explorador de Archivos
- Navega a la ubicación del APK
- Toca el archivo
app-debug.apk
-
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
-
Instala:
- Toca "Instalar"
- Espera a que termine
- Toca "Abrir"
Método 2: Desde Android Studio
- Conecta tu dispositivo Android por USB
- En Android Studio, haz clic en "Run" (▶️)
- Selecciona tu dispositivo
- La app se instalará automáticamente
Método 3: ADB (Para desarrolladores)
# 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:
- ✅ El icono de iTartanas aparece en el cajón de aplicaciones
- ✅ Al abrir, muestra la pantalla de "Lector de Tarjeta Millennium"
- ✅ Tu dispositivo tiene NFC activado:
- Ve a Configuración → Conexiones → NFC
- Activa el interruptor
🧪 Primera Prueba
- Abre la aplicación iTartanas
- Verás la pantalla de instrucciones
- Acerca tu Tarjeta Millennium al lector NFC
- 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:
- Desinstala la versión anterior (opcional)
- Instala el nuevo APK
- 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:
- ✅ Leer número de tarjeta - En formato seguro y enmascarado
- ✅ Consultar saldo - En tiempo real desde el chip NFC
- ✅ 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:
- README.md - Documentación técnica completa
- INSTALLATION_GUIDE.md - Guía detallada de uso
- CHANGELOG.md - Cambios y características
- 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 ✅