-
Notifications
You must be signed in to change notification settings - Fork 0
User es Getting Started
Instala Sparkilo desde la Google Play Store — la versión de producción pública.
¿Vienes de la beta? Si te uniste al programa Open Testing (beta), Google Play te sigue sirviendo compilaciones beta — la ficha muestra el nombre de la app con una etiqueta (beta) y una nota de "Eres un tester de la versión beta". Para cambiar a la versión de producción pública:
- Abre la ficha de Play → en "Eres un tester de la versión beta", pulsa Salir del programa.
- Desinstala la compilación beta y luego vuelve a instalarla desde Play.
¿Quieres las novedades primero? Quédate en el programa beta — las nuevas compilaciones llegan al canal beta antes que a producción, así que los testers reciben cada actualización antes.
Sparkilo también ofrece una compilación totalmente sin GMS a través de su propio repositorio F-Droid (mapas de OpenStreetMap, sin servicios de Google, sin rastreo). En la app F-Droid abre Ajustes → Repositorios → + y añade:
https://fdittgen-png.github.io/tankstellen/fdroid/repo
Luego busca Sparkilo e instálala. (Si ya tienes instalada la compilación de Play, desinstálala primero — la compilación de F-Droid está firmada con una clave distinta, por lo que no puede actualizar sobre la versión de Play.)
- APK — descarga un APK de versión desde las GitHub Releases.
- iPhone — la compilación para iOS está en beta de TestFlight; solicita una invitación en GitHub Issues hasta que la ficha de la App Store esté publicada.
Sin cuenta, sin registro, sin correo — la app funciona plenamente en cuanto se instala.
Mínimo Android: 7.0 (API 24). Objetivo: Android 15. Mínimo iOS: 15.5. Objetivo: iOS 18.
En el primerísimo arranque la app muestra una pantalla de consentimiento RGPD dedicada antes que cualquier otra interfaz. Explica cada permiso y solo continúa cuando pulsas Aceptar.
- Permiso de ubicación — necesario para encontrar estaciones cercanas. Elige Mientras se usa la app. Si prefieres no compartir el GPS nunca, puedes usar el código postal.
- Notificaciones — solo si quieres recibir alertas de precio.
- Diagnóstico — opcional. No se envía nada salvo que pulses explícitamente Reportar problema.
Si rechazas la ubicación, sigues pudiendo buscar por código postal o eligiendo una ciudad en el mapa.
La app detecta ambos automáticamente desde el idioma del sistema. Si la detección falla:
- Ajustes → País — elige entre los 17 países soportados.
- Ajustes → Idioma — elige entre 23 idiomas traducidos (bg, cs, da, de, el, en, es, et, fi, fr, hr, hu, it, lt, lv, nb, nl, pl, pt, ro, sk, sl, sv). Toda la interfaz se refresca al instante.
Cambiar de país borra la caché de estaciones para que recibas resultados frescos del nuevo país.
En Ajustes → Perfil elige uno de los tres preajustes — agrupan funciones para que no tengas que activar interruptores uno a uno:
- Básico — búsqueda de precios, favoritos, alertas, planificación de ruta y carga eléctrica. Sin seguimiento de consumo.
- Medio — Básico más la pestaña Consumo. Repostajes manuales y registro de trayectos solo con GPS (sin hardware OBD2). El L/100 km estimado converge tras 3–8 repostajes mediante la matriz de calibración por vehículo.
- Completo — Medio más registro de trayectos OBD2 (adaptador requerido), grabación automática, gamificación, tarjetas de fidelidad y los eco-coaches háptico y de planeo.
Puedes cambiar de perfil cuando quieras, o activar funciones sueltas en Ajustes → Funciones para una mezcla Personalizada.
La mayoría de países funcionan sin configuración. Alemania requiere una clave API gratuita porque el servicio Tankerkoenig limita la frecuencia por usuario.
- Abre creativecommons.tankerkoenig.de
- Pulsa Get an API key y rellena el (breve) formulario
- Copia la clave — tiene el aspecto
00000000-0000-0000-0000-000000000002 - En la app: Ajustes → Claves API → Alemania → pega → Guardar
La clave se guarda en el Android Keystore (cifrado respaldado por hardware) en Android, o en el iOS Keychain en iPhone, y nunca se envía a ningún sitio salvo a la API de Tankerkoenig.
Pulsa el FAB central en la barra de navegación inferior — es el único botón de búsqueda en todas las pestañas y sabe qué hacer según dónde estés:
- En la pestaña Resultados de búsqueda o Mapa → abre la hoja de Criterios para escoger tipo de combustible, radio y ubicación de origen.
- Dentro de la hoja de Criterios → un segundo toque lanza la búsqueda.
- En cualquier otra pestaña → salta a la rama de Búsqueda.
Obtienes una lista de estaciones ordenadas por precio (más barata primero). Pulsa una estación para ver detalles, horario, métodos de pago aceptados y direcciones. Consulta Buscar estaciones para todos los detalles.
Ve a Ajustes → Pantalla de inicio. Puedes elegir qué se abre cuando pulsas el icono de la app:
- Más barata cerca (por defecto) — búsqueda inmediata con tus últimos criterios
- Estación más cercana — un único resultado, ruta más rápida
- Favoritos — directo a tus estaciones guardadas
- Mapa — mapa completo con marcadores de clúster
En Ajustes → Unidades puedes elegir cómo se muestran las distancias, volúmenes y precios. Los valores por defecto son por país: métrico (km, L, €/L) en Europa continental; tipo imperial (mi para señales de distancia en el Reino Unido, c/L para AU, etc.) donde corresponda.
Siguiente: Buscar estaciones →
👤 User Guide
🛠️ Developer Guide
Architecture
Code patterns
Quality
Deep dives
Reference
Workflow