-
Notifications
You must be signed in to change notification settings - Fork 0
User es Troubleshooting FAQ
- Comprueba tu país. Ajustes → País. Un perfil guardado para Alemania llamará a la API alemana; si viajas a Francia, cambia de país. La app soporta 17 países — asegúrate de haber elegido el correcto.
- Comprueba la conectividad. Sin conexión → sin precios en vivo. La app recurre a los últimos precios conocidos en caché (marcados como obsoletos en rojo).
- Caída de la API del país. Las APIs gubernamentales caen a veces. Vuelve a intentarlo en unos minutos. Revisa downdetector o la página de GitHub Issues.
- Caché obsoleta. Tira para refrescar o pulsa el botón de refresco. La app reintenta la API.
La app tiene un único FAB central en la barra de navegación inferior — es el único disparador de búsqueda en todas las pestañas.
- En cualquier pestaña → pulsa para saltar a la rama de Búsqueda.
- En la vista de Resultados o Mapa → abre la hoja de Criterios (combustible, radio, origen).
- Dentro de la hoja de Criterios → un segundo toque lanza la búsqueda.
Los antiguos botones "Buscar cerca" y "Buscar a lo largo de la ruta" dentro de la lista de resultados se han quitado. Si el FAB se ve atenuado, suele significar que estás en modo ruta sin haber rellenado un destino.
- Necesitas una clave API gratuita de creativecommons.tankerkoenig.de.
- El formato de la clave es un UUID:
00000000-0000-0000-0000-000000000002. - Pégala en Ajustes → Claves API → Alemania.
- Si sigue fallando, puede que la clave esté limitada por uso intensivo. El servicio limita la frecuencia por clave — no compartas claves públicamente.
- Abre Ajustes de Android → Ubicación → actívala. Da a la app permiso Mientras se usa.
- ¿Dentro de un edificio? El GPS no fija en interiores. Sal a la calle o usa la búsqueda por código postal.
- Si la app dice "Solo ubicación aproximada" — activa la ubicación precisa en los ajustes del sistema.
- El servicio de routing (OSRM) es público y a veces lento.
- Una ruta de varios países puede emitir resultados parciales — el banner de arriba te dice qué países siguen respondiendo. Puedes pulsar un resultado en cuanto aparezca.
- Reintenta. La app cachea la polilínea, así que el segundo intento suele ser instantáneo.
- Si ves timeouts consistentemente, abre una issue indicando el origen y destino que usaste.
No se encuentra nada durante el escaneo:
- El contacto del coche debe estar en on (accesorio o marcha, no apagado). El motor en marcha está bien.
- El LED del adaptador debe estar encendido y fijo (azul en la mayoría). Si parpadea o está apagado, vuelve a encajarlo.
- El Bluetooth debe estar activo en el móvil.
- Android 12+: ¿concediste Bluetooth Scan y Bluetooth Connect? Abre Ajustes de Android → Aplicaciones → Tankstellen → Permisos.
- Android 11 o anterior: la app necesita el permiso Ubicación para enumerar dispositivos BLE (una particularidad del sistema operativo — la app nunca registra tu ubicación para esto).
El adaptador es visible pero la conexión falla:
- Error "Sin respuesta" — clon barato. Espera 30 s y reintenta. Intenta arrancar del todo el motor brevemente.
- Error "Fallo de init de protocolo" — chip ELM327 falsificado. Prueba otro modelo de adaptador; vLinker FS es una opción barata fiable.
- Error "Permiso denegado" — vuelve a conceder en los ajustes del sistema; algunos Android olvidan los permisos Bluetooth tras reiniciar.
Conecta pero el cuentakilómetros marca 0 o un valor incorrecto:
- Es posible que tu coche no exponga el PID A6. La app reintenta con el PID 31 y con el Mode 22 del fabricante (basado en VIN).
- Algunos coches europeos antiguos (anteriores a 2008) no exponen el cuentakilómetros por OBD2. Tendrás que teclearlo.
La grabación automática requiere:
- Adaptador emparejado a un vehículo — el primer emparejamiento manual crea la asociación.
- Grabación automática activada en Ajustes → OBD2 → Grabación automática.
- Bluetooth del móvil activo, con la optimización de batería del sistema sin matar la app.
iOS: la activación en segundo plano a nivel del sistema operativo necesaria para "auto-conectar cuando el adaptador se enciende" está aún en curso (#1542). Hasta entonces, los usuarios de iOS inician los trayectos manualmente desde la pestaña Trayectos. Android gestiona el flujo manos libres completo a día de hoy.
La superposición de aproximación solo se dispara mientras se está grabando un trayecto y estás dentro de profile.approachRadiusKm (1 km por defecto) de una estación. Si quieres verificar que la interfaz cambia correctamente sin conducir, abre Ajustes → Panel de privacidad → Probar superposición de aproximación — el botón emite un estado sintético "dentro del radio" durante 30 s. Consulta Consumo y OBD2 → Superposición de aproximación para la configuración completa.
- ¿Notificaciones del sistema activadas? Ajustes de Android → Aplicaciones → Tankstellen → Notificaciones → Permitir.
- ¿Móvil en ultra-ahorro de batería? Los ahorradores agresivos de Android matan WorkManager. Pon la app en lista blanca: Ajustes → Batería → Sin restricciones.
- El móvil estaba sin conexión a la hora de la comprobación. La comprobación se ejecuta en la siguiente ventana de red.
- El precio aún no ha bajado por debajo del umbral.
- Android limita las actualizaciones de widget a una cada ~30 min como mínimo. Es una política del sistema.
- El widget usa la misma caché que la app. Pulsa el icono de refresco del propio widget — vuelve a obtener precios en segundo plano sin abrir la app.
- Pulsar el widget abre la estación correcta tanto si la app estaba cerrada en frío como si seguía caliente en memoria; si no es así, abre una issue indicando modelo de móvil y versión de Android.
En móviles en horizontal y en tabletas (anchura ≥ 600 dp), la pantalla de Favoritos muestra la lista de favoritos y la de alertas lado a lado con un divisor vertical. No hay selector de pestañas en esa disposición porque ambos paneles son visibles a la vez. Vuelve a vertical si prefieres el selector de pestañas.
- El botón está en Ajustes → Panel de privacidad (antes decía "Copiar" — ahora es "Guardar" y realmente escribe en Descargas).
- Comprueba que hayas concedido el permiso de acceso a archivos en el primer guardado.
- Si el guardado falla, la app recurre a copiar el registro al portapapeles para que la acción nunca quede en silencio sin hacer nada.
- Prueba Ajustes → Borrar caché (mediante los ajustes del sistema Android).
- Si el cierre persiste, abre una issue indicando: versión de Android, modelo de móvil, versión de la app (en Ajustes → Acerca de) y el último informe de fallo (la app ofrece Guardar al siguiente arranque — el archivo está en Descargas).
Ajustes → Datos → Exportar todos los datos → archivo JSON escrito en la carpeta pública Descargas. Guárdalo en lugar seguro. Al reinstalar, usa Importar en la misma pantalla.
Los usuarios de TankSync no necesitan hacer esto — los datos viven en tu instancia Supabase. Ten en cuenta que los trayectos solo se sincronizan si también has activado Sincronizar trayectos en los ajustes de TankSync (es opt-in).
- Ocurre puntualmente en conexiones débiles.
- Desliza hacia abajo para refrescar el mapa.
- Si persiste tras cerrar y reabrir la app, puede que los servidores de teselas de OpenStreetMap estén limitando la frecuencia; inténtalo unos minutos después.
Ajustes → Datos → Restablecer app. Borra todas las cajas Hive locales y limpia el almacenamiento seguro. Irreversible. Si usas TankSync, elimina antes tu cuenta en el servidor: Ajustes → TankSync → Eliminar cuenta, o limpia solo las filas de viajes con Olvidar todos los trayectos sincronizados.
Parcialmente. Los favoritos funcionan sin conexión (se muestran los últimos precios conocidos). Las búsquedas requieren una llamada de red — no puedes descubrir estaciones nuevas sin ella. Los mapas cachean las teselas que has visto recientemente, así que las zonas que ya hayas visitado cargan.
- Reportar un bug: github.com/fdittgen-png/tankstellen/issues — usa la plantilla Bug Report. Adjunta el registro de errores guardado desde el Panel de privacidad.
- Solicitar una función: plantilla Feature Request, o discútelo antes en Discussions.
- Preguntas de privacidad: consulta PRIVACY.md.
👤 User Guide
🛠️ Developer Guide
Architecture
Code patterns
Quality
Deep dives
Reference
Workflow