Tracking affidabile su Android

Il problema in 30 secondi

Hai registrato una traccia ma sulla mappa vedi linee dritte che attraversano valli o salite impossibili. Oppure la durata e la distanza sono molto inferiori al previsto. La causa è quasi sempre la stessa: alcuni produttori Android (Oppo, Xiaomi, Huawei, OnePlus, Vivo) hanno un sistema di risparmio energetico molto aggressivo che mette in pausa le app in background — anche quelle che, come TrailShare, lo sfruttano legittimamente per registrare il GPS.

Lo stesso bug non capita su Samsung, Google Pixel, OPPO Stock Android, Nothing Phone, perché questi produttori rispettano le linee guida Android standard. Su Oppo/ColorOS, Xiaomi/MIUI, Huawei/EMUI servono 3-4 permessi extra da attivare manualmente per ogni app che deve girare in background. Una volta configurati la prima volta, TrailShare diventa stabile come su qualsiasi altro telefono.

📌 Promemoria: queste impostazioni vanno fatte una volta sola, per ogni app che vuoi usare in background (TrailShare, app di allenamento, navigazione, ecc.). Non sono colpa nostra né dell'app: sono scelte di sistema dei produttori.

Oppo (ColorOS)

I path possono variare leggermente per versione ColorOS, ma le voci sono sempre quelle.

1. Impostazioni → Batteria → Risparmio energia → TrailShare
   → attiva "Consenti esecuzione in background"
2. Impostazioni → App → Gestione avvio → TrailShare
   → Disattiva prima il toggle in alto "Gestisci automaticamente" (è quello blu di default). Finché è acceso, i tre toggle sotto restano grigi e bloccati.
   → Poi nella sezione "GESTISCI MANUALMENTE" attiva tutti e tre: "Avvio automatico", "Avvio secondario", "Esegui in background"
   → Tap OK
3. Impostazioni → Batteria → Ottimizzazione → TrailShare
   → scegli "Non ottimizzare"
4. Impostazioni → Privacy → Posizione → TrailShare
   → scegli "Consenti sempre" (non solo "durante l'uso")
5. Telefono Manager → Privacy → App protette → TrailShare
   → attiva se presente (su alcune versioni ColorOS)
6. Una volta avviata la registrazione, fai swipe-up per aprire le app recenti, cerca la card di TrailShare e tocca l'icona del lucchetto
   → blocca l'app dalla pulizia automatica del task killer

Xiaomi (MIUI / HyperOS)

1. Impostazioni → App → Gestisci app → TrailShare → Risparmio batteria
   → scegli "Nessuna restrizione"
2. Impostazioni → App → Permessi → Autostart
   → attiva per TrailShare
3. Impostazioni → App → Gestisci app → TrailShare → Altri permessi → Visualizza in popup quando in background
   → attiva
4. Impostazioni → Posizione → Permessi posizione app → TrailShare
   → "Consenti sempre"
5. Dalle app recenti, scorri la card TrailShare verso il basso fino al simbolo del lucchetto
   → la blocca dal task killer

Huawei (EMUI / HarmonyOS)

1. Impostazioni → App → TrailShare → Batteria
   → "Avvio app" → disattiva "Gestisci automaticamente" e attiva tutti e tre i toggle manuali
2. Phone Manager → App protette
   → attiva TrailShare
3. Impostazioni → Posizione → Autorizzazioni → TrailShare
   → "Consenti sempre"

OnePlus (OxygenOS)

1. Impostazioni → Batteria → Ottimizzazione batteria → TrailShare
   → "Non ottimizzare"
2. Impostazioni → App → TrailShare → Batteria → Limitazioni in background
   → "Senza restrizioni"
3. Impostazioni → Privacy → Posizione → TrailShare
   → "Consenti sempre"
4. Sui modelli più recenti (OnePlus 11+), aggiungi anche il lucchetto sulla card nelle app recenti.

Vivo (Funtouch OS / Origin OS)

1. Impostazioni → Batteria → Background → TrailShare
   → "Esegui in background"
2. iManager → Gestione app → Autostart manager → TrailShare
   → attiva
3. Impostazioni → Posizione → TrailShare
   → "Consenti sempre"

Samsung, Pixel, Nothing e altri Android "stock"

Niente da configurare oltre allo standard. Su questi telefoni TrailShare funziona già bene in background grazie al foreground service che mostriamo nella notifica. Assicurati solo che il permesso posizione sia su "Consenti sempre".

iPhone (iOS)

Su iOS non ci sono questi problemi: Apple gestisce diversamente il background. Verifica solo che Impostazioni → Privacy → Localizzazione → TrailShare sia su "Sempre". Tutto il resto è automatico.

Come verifico che funzioni?

Test rapido (15 minuti):

1. Avvia una nuova registrazione dalla sezione "Registra"
2. Blocca lo schermo e cammina o muoviti per 15 minuti
3. Sblocca, apri la traccia: la linea sulla mappa deve essere continua, senza salti rettilinei.
4. Se vedi ancora buchi → torna su questa pagina e ripeti gli step, magari hai saltato un toggle nascosto.

💡 Consiglio extra: mentre registri una traccia importante (cammino di più giorni, gara), tieni il telefono sempre acceso o in carica. Quando il device va sotto il 20% di batteria, su tutti gli Android (anche stock) il sistema diventa più aggressivo nel killare app per risparmiare energia.

Non funziona ancora?

Scrivici a info@trailshare.app allegando: modello del telefono, versione Android, versione ColorOS/MIUI/EMUI (le trovi in Impostazioni → Info telefono) e uno screenshot della traccia. Indaghiamo caso per caso e aggiorniamo questa guida con le tue indicazioni.

Una nota tecnica (per curiosi)

Android Open Source Project (AOSP) prevede una API ufficiale per le app che devono girare in background continuativamente: il Foreground Service. È un componente legittimo, ben documentato, regolarmente usato da app di navigazione, fitness tracking, audio player, ecc. TrailShare lo implementa correttamente. Il problema è che alcuni produttori OEM cinesi ignorano questa specifica per estendere artificialmente la durata della batteria, killando comunque le foreground service che non sono nella loro whitelist interna. È un comportamento documentato su dontkillmyapp.com, un progetto open source che da anni traccia questa situazione.