Panoramica temporale

Questa pagina descrive il funzionamento del rilevamento dell'ora e del fuso orario su Android. Sono incluse informazioni su come Android rileva automaticamente l'ora e i fusi orari, opzioni di configurazione per i produttori di dispositivi e informazioni sui test.

Panoramica dell'ora e dei fusi orari

Per determinare l'ora locale di un utente da visualizzare in posizioni come la barra di stato, Android tiene traccia di due stati correlati, ma indipendenti:

• L'ora dell'epoca di Unix corrente
• Il fuso orario attuale

L'ora di epoche Unix e il fuso orario correnti sono stati a livello di dispositivo, ovvero sono condivisi da tutti gli utenti di un dispositivo.

L'ora di epoch Unix corrente non è un valore fisso. Si aggiorna automaticamente per riflettere il passare del tempo. Oltre al normale scorrere del tempo, l'ora di epoche Unix corrente di un dispositivo viene regolata se risulta errata, ad esempio dopo che il dispositivo perde l'alimentazione.

Il fuso orario corrente determina la correzione da apportare per convertire l'ora Unix epoch corrente in un'ora locale. Ad esempio, durante l'estate a Los Angeles, il dispositivo sottrae 7 ore dall'ora di epoch Unix corrente e in inverno sottrae 8 ore.

Per supportare questi calcoli dell'ora locale, tutti i dispositivi Android dispongono di un database di tutte le regole dei fusi orari globali. Per ulteriori informazioni sulle regole relative ai fusi orari, consulta Regole relative ai fusi orari.

Quando un utente si reca in una nuova località che utilizza un fuso orario diverso, l'ora di epoche Unix corrente non deve essere regolata, ma in genere l'utente vuole vedere l'ora locale anziché l'ora della località precedente. La modifica del fuso orario corrente garantisce che all'ora Unix epoch corrente venga applicata la differenza corretta per visualizzare l'ora locale corretta per la nuova località.

AOSP consente agli utenti di controllare in modo indipendente se l'ora e il fuso orario vengono impostati automaticamente tramite i seguenti meccanismi.

• Rilevamento automatico dell'ora: garantisce che sul dispositivo sia impostata la data e l'ora corrente di Unix.
• Rilevamento automatico del fuso orario: garantisce che sul dispositivo sia impostato il fuso orario corrente corretto.

Rilevamento automatico dell'ora

Questa sezione fornisce una panoramica del servizio time_detector che gestisce il rilevamento automatico dell'ora, i controlli utente, le opzioni di configurazione e i dettagli dei test.

Il servizio time_detector

Il servizio time_detector, presente sui dispositivi con Android 10 o versioni successive, gestisce il rilevamento automatico del tempo. Modifica l'ora di epoche Unix corrente del dispositivo in base alle necessità quando è attivo il rilevamento automatico dell'ora.

Il servizio time_detector è sempre in uno dei due stati: incerto o certo. Lo stato certo o incerto del servizio viene determinato dai suggerimenti relativi all'orario che riceve da varie fonti.

Quando il servizio time_detector è certo, ovvero ha ricevuto un suggerimento con informazioni sull'ora dell'epoca di Unix, sostituisce l'ora dell'epoca di Unix corrente se il suggerimento sull'ora è diverso dall'ora dell'epoca di Unix corrente.

Quando time_detector è incerto, non sostituisce l'ora corrente. Lo stato incerto in genere indica che il servizio time_detector non ha ricevuto suggerimenti sul tempo. Anche il servizio time_detector diventa incerto se i suggerimenti che ha ricevuto sono considerati troppo vecchi per essere utilizzati. L'età dei suggerimenti viene considerata perché gli aggiustamenti che utilizzano i vecchi suggerimenti relativi al tempo di epoch di Unix si basano sull'orologio in tempo reale sul dispositivo, che si presume non sia preciso su periodi lunghi.

Per stabilire automaticamente il tempo di epoch di Unix corrente, un dispositivo ha a disposizione varie fonti. In questo documento sono chiamate origini. Il serviziotime_detector tratta le sequenze di suggerimenti come distinte in base alla loro origine.

Il servizio time_detector è stateful, il che significa che tiene traccia del suggerimento più recente fornito da ogni origine. Vengono inviati nuovi suggerimenti a time_detector se per un'origine sono disponibili informazioni più recenti sull'ora di epoche Unix. Il servizio time_detector rivaluta i suggerimenti nuovi ed esistenti e aggiorna lo stato del dispositivo quando vengono ricevuti.

Sebbene l'ora UTC sia concordata a livello internazionale, esistono vari motivi per cui stabilire l'ora di epoche Unix corrente non è sempre semplice per un dispositivo Android:

• L'ora Unix è un sistema di misurazione del tempo leggermente diverso dall'ora UTC. La conversione tra i due richiede di sapere quando si verificano i secondi intercalari e come vengono gestiti dalle origini.
• Le origini potrebbero essere disponibili solo in determinati momenti o in determinate circostanze. Ad esempio, se l'origine richiede la connettività di rete, potrebbe essere disponibile solo quando il dispositivo è connesso a internet.
• Le origini potrebbero essere imprecise o contenere errori. Ad esempio, se una torre di telefonia cellulare non monitora correttamente il "tempo universale", l'origine telefonica potrebbe fornire suggerimenti sull'ora non accurati.
• Potrebbero essere state introdotte imprecisioni durante l'ottenimento del tempo dell'epoca di Unix. Ad esempio, un ritardo della rete, il buffering o la pianificazione dei processi potrebbero causare la mancata precisione della data e dell'ora di Unix.
• L'orologio di riferimento utilizzato per regolare un suggerimento in base al tempo trascorso dall'invio del suggerimento potrebbe non essere preciso.

Esistono due origini principali di rilevamento dell'ora configurate per l'utilizzo per impostazione predefinita in AOSP:

• Rete: utilizza i server di tempo Network Time Protocol (NTP).
• Telefonia: utilizza gli indicatori di telefonia per l'identità di rete e il fuso orario (NITZ).

Sia le origini di telefonia che quelle di rete richiedono la connettività a reti esterne, che non sono sempre disponibili.

A partire da Android 12, Android supporta anche le seguenti origini, che non sono configurate per l'utilizzo per impostazione predefinita:

• GNSS: utilizza il fornitore di servizi di geolocalizzazione GPS per ottenere un'ora da una sorgente GNSS.
• Esterno: origine generica che consente ai produttori di dispositivi di integrare la propria origine del tempo di epoch di Unix.

Impostazioni temporali

Gli utenti possono attivare il rilevamento automatico dell'ora in Sistema > Data e ora nell'app Impostazioni AOSP.

Figura 1. Rilevamento automatico dell'ora nelle Impostazioni.

La tabella seguente descrive i controlli utente per il rilevamento dell'ora nell'app Impostazioni AOSP.

Quando l'utente inserisce l'ora manualmente, inserisce la propria ora locale, non l'ora di epoche Unix. L'ora di epocha Unix corrente viene calcolata utilizzando il fuso orario corrente per ricavare un'ora di epocha Unix.

Configurazione

I produttori di dispositivi possono configurare il servizio time_detector in vari modi, ad esempio scegliendo quali origini utilizzare e come dare la priorità ai relativi indicatori.

Assegnazione della priorità alle origini

A partire da Android 12, i produttori di dispositivi possono modificare il core/res/res/values/config.xmlfile di configurazione per specificare quali origini dell'ora includere nel rilevamento automatico dell'ora e la priorità con cui time_detector prende in considerazione queste origini.

Per i dispositivi con Android 11 o versioni precedenti, la priorità dell'origine è hardcoded su ["telephony", "network"], il che significa che i suggerimenti di telefonia hanno la priorità rispetto ai suggerimenti di rete.

La configurazione predefinita di AOSP è la seguente:

<!-- Specifies priority of automatic time sources. Suggestions from higher entries in the list
     take precedence over lower ones.
     See com.android.server.timedetector.TimeDetectorStrategy for available sources. -->
<string-array name="config_autoTimeSourcesPriority">
    <item>network</item>
    <item>telephony</item>
</string-array>

In Android 12, i suggerimenti relativi a reti e telefonia sono configurati come origini da utilizzare per impostazione predefinita. I suggerimenti relativi all'ora della rete hanno la priorità rispetto ai suggerimenti relativi all'ora telefonica. I produttori di dispositivi possono modificare l'ordine delle origini per ripristinare il comportamento in Android 11 o versioni precedenti, dove alla telefonia viene assegnata una priorità più elevata.

Per impostazione predefinita, se il suggerimento valido con la priorità più alta corrisponde all'ora corrente dell'orologio di sistema del dispositivo entro un paio di secondi, l'ora del dispositivo non verrà modificata. Questo serve a evitare di creare lavoro per le app installate che ascoltano l'intentACTION_TIME_CHANGED.

I valori di origine consentiti sono:

• Rete
• Telefonia
• GNSS
• Esterno

Limiti di tempo consentiti

Android 14 introduce un limite di tempo massimo per i suggerimenti di tempo ricevuti dal servizio time_detector. Se il dispositivo supporta i processi a 32 bit, il framework imposta un limite di tempo massimo per impedire al dispositivo di utilizzare un suggerimento di orario che potrebbe attivare il problema Y2038.

Android 12 ha introdotto un limite di tempo inferiore utilizzato per verificare i suggerimenti relativi all'ora ricevuti dal servizio time_detector. Il valore inferiore del vincolo temporale utilizzato per i suggerimenti automatici viene impostato dal timestamp della compilazione. Questo funziona in base al principio che un'ora valida non può essere precedente alla compilazione dell'immagine di sistema del dispositivo. Se un suggerimento per l'ora è precedente al limite di tempo inferiore, il servizio time_detector lo ignora perché non può essere valido se il timestamp della compilazione è corretto.

Per i dispositivi con Android 11 o versioni precedenti, il servizio time_detector non convalida i suggerimenti relativi all'ora di epoche Unix in arrivo.

Tempo di debug e test

Questa sezione fornisce informazioni su come eseguire il debug e testare il comportamento del servizio time_detector e di altri componenti condivisi da tutte le origini.

Interagire con il servizio time_detector

Per visualizzare la configurazione e lo stato del servizio time_detector, utilizza:time_detector

adb shell cmd time_detector dump

Per visualizzare altri comandi per il debug e il test del rilevamento del fuso orario, utilizza:

adb shell cmd time_detector help

L'output della guida descrive anche le proprietà del servizio device_config che possono essere utilizzate per influire sul comportamento di time_detector per i test o in produzione. Per maggiori dettagli, vedi Configurare un dispositivo utilizzando il servizio device_config.

Per convalidare il rilevamento automatico dell'ora, i tester devono sapere quali origini utilizza il serviziotime_detector. Di seguito è riportato un esempio dell'output del comando adb shell cmd time_detector dump, con le informazioni sull'origine e sullo stato attuale del servizio in grassetto:

$ adb shell cmd time_detector dump

TimeDetectorStrategy:
  mLastAutoSystemClockTimeSet=null
  mEnvironment.isAutoTimeDetectionEnabled()=true
  mEnvironment.elapsedRealtimeMillis()=23717241
  mEnvironment.systemClockMillis()=1626707861336
  mEnvironment.systemClockUpdateThresholdMillis()=2000
  mEnvironment.autoTimeLowerBound()=2021-07-19T07:48:05Z(1626680885000)
  mEnvironment.autoOriginPriorities()=[network,telephony]
  Time change log:
    ...
  Telephony suggestion history:
    ...
  Network suggestion history:
    ...
  Gnss suggestion history:
    ...
  External suggestion history:
    ...

Le informazioni possono essere interpretate come segue:

Il log delle modifiche dell'ora indica le occasioni in cui il servizio time_detector ha cambiato l'ora Unix epoch corrente del dispositivo.

Le informazioni sulla cronologia dei suggerimenti indicano quali suggerimenti sono stati fatti da ogni origine.

Rilevamento automatico del fuso orario

Questa sezione fornisce una panoramica del servizio time_zone_detector che gestisce il rilevamento automatico del fuso orario, i controlli utente nelle impostazioni, il rilevamento del fuso orario per telefonia e posizione e i dettagli dei test.

Il servizio time_zone_detector

Il servizio time_zone_detector, presente sui dispositivi con Android 11 o versioni successive, gestisce il rilevamento automatico del fuso orario. Modifica il fuso orario corrente del dispositivo in base alle necessità quando il rilevamento automatico del fuso orario è attivo.

Quando il rilevamento automatico del fuso orario è attivo, time_zone_detector può essere in uno di due stati: incerto e certo.

Quando il servizio time_zone_detector è in un determinato stato, significa che il servizio time_zone_detector ha ricevuto informazioni precise sul fuso orario, che possono causare l'override del fuso orario corrente. Se è incerto, significa che non ha ricevuto informazioni o solo informazioni con bassa confidenza, il che significa che non sostituirà il fuso orario corrente.

Alcuni stati del servizio time_zone_detector possono includere quelli in cui time_zone_detector non ha informazioni sui fusi orari da utilizzare o in cui ha più fusi orari tra cui scegliere. Questi stati sono i seguenti:

• Viene inserito uno stato con zero fusi orari quando il dispositivo si trova in un luogo senza fuso orario, ad esempio in acque internazionali o in un'area in discussione. Questo stato è simile a uno stato incerto, ma indica che time_zone_detector non deve intraprendere ulteriori azioni per provare a determinare il fuso orario.
• Viene inserito uno stato con più fusi orari in cui esistono condizioni di ambiguità o di confine. In questo stato, se il fuso orario corrente è uno dei fusi orari di cui time_zone_detector è certo, il fuso orario corrente viene lasciato invariato. In caso contrario, viene utilizzato uno dei fusi orari disponibili. Questo conferisce a time_zone_detector un elemento di aderenza se l'utente ha selezionato manualmente il proprio fuso orario in precedenza o quando il dispositivo si avvicina a un confine.

Lo stato certo o incerto del servizio time_zone_detector è determinato dai suggerimenti per i fusi orari inviati da un algoritmo.

In genere, i suggerimenti sono di due tipi che corrispondono quasi esattamente ai possibili stati di time_zone_detector: certo e incerto. Di seguito sono riportati alcuni esempi di tipi di suggerimenti:

• type = uncertain, zoneIds = []

  • L'algoritmo non sa qual è il fuso orario.

• type = certain, zoneIds = ["Europe/London"]

  • L'algoritmo è certo che la zona è Europa/Londra.

• type = certain, zoneIds = []`

  • L'algoritmo è certo, ma non esiste un ID zona associato alla località attuale.

• type = certain, zoneIds = ["America/Denver", "America/Phoenix"]

  • L'algoritmo è certo che la risposta è una delle due zone, ma non può scegliere tra "America/Denver" e "America/Phoenix".

Il servizio time_zone_detector tratta le sequenze di suggerimenti come distinte in base al loro algoritmo. A seconda dell'algoritmo, i suggerimenti potrebbero anche contenere metadati che indicano il grado di certezza dell'algoritmo.

Il servizio time_zone_detector è stateful, il che significa che conserva un record del suggerimento più recente fornito da ciascun algoritmo. I nuovi suggerimenti vengono inviati al servizio time_zone_detector se un suggerimento precedente non è più corretto, ovvero se un algoritmo ora ha un suggerimento diverso o se ha perso la capacità di rilevare il fuso orario. Il servizio time_zone_detector rivaluta i suggerimenti nuovi ed esistenti e aggiorna lo stato del dispositivo quando vengono ricevuti.

Android supporta due algoritmi per il rilevamento del fuso orario:

• Telefonia
• Posizione

In genere, il servizio time_zone_detector utilizza un singolo algoritmo per determinare il fuso orario. Quando l'algoritmo di geolocalizzazione è supportato su un dispositivo, l'algoritmo utilizzato dal dispositivo viene determinato in base alle impostazioni del fuso orario configurate dall'utente. Quando l'algoritmo in uso non è sicuro del fuso orario, time_zone_detector solitamente non utilizza i suggerimenti di un altro algoritmo. I suggerimenti associati agli algoritmi non in uso possono essere memorizzati da time_zone_detector, ma non vengono utilizzati a meno che l'algoritmo non cambi. Quando l'utente modifica le impostazioni per il rilevamento automatico del fuso orario e l'algoritmo cambia, viene utilizzato il suggerimento più recente disponibile per il nuovo algoritmo.

Per informazioni dettagliate sulla situazione in cui vengono utilizzati più algoritmi per determinare il fuso orario, consulta la sezione Modalità di riserva per la telefonia.

Modalità di riserva per la telefonia

Sui dispositivi con Android 13 e versioni successive, il servizio time_zone_detector supporta la modalità di riserva per la telefonia. Questa modalità consente ad Android di utilizzare temporaneamente i suggerimenti di rilevamento della telefonia nelle situazioni in cui il rilevamento della posizione non è in grado di rilevare il fuso orario o in cui il rilevamento della posizione richiede più tempo rispetto al rilevamento della telefonia.

La modalità di riserva per la telefonia si applica ai dispositivi su cui sono supportati sia la telefonia sia il rilevamento della posizione e in cui l'utente ha attivato l'opzione Usa la posizione per impostare il fuso orario nelle Impostazioni del fuso orario. La modalità viene attivata automaticamente quando un dispositivo viene riavviato e quando la modalità aereo è disattivata.

In Android 14 e versioni successive, il fallback per la telefonia può essere attivato tramite le API di generazione di report sullo stato del LTZP, ovvero se un LTZP segnala che è incerto e la sua capacità di rilevare la posizione o il fuso orario è ridotta dal suo ambiente, viene attivata la modalità di fallback per la telefonia.

In modalità di riserva per la telefonia, il servizio time_zone_detector utilizza i suggerimenti di telefonia come se il rilevamento della posizione fosse disattivato fino a quando l'algoritmo di geolocalizzazione non fa un determinato suggerimento. Dopo aver ricevuto un determinato suggerimento, la modalità di riserva per la telefonia viene disattivata e vengono utilizzati esclusivamente i suggerimenti di località.

Per i dettagli di configurazione della modalità di riserva per la telefonia, consulta Configurazione del rilevamento del fuso orario.

Impostazioni fuso orario

Gli utenti possono attivare e configurare le impostazioni per il rilevamento automatico del fuso orario nell'app Impostazioni AOSP.

Figura 2. Rilevamento automatico del fuso orario nelle Impostazioni.

La tabella seguente descrive i controlli utente per il rilevamento del fuso orario nell'app Impostazioni AOSP.

Di seguito viene fornita una panoramica del comportamento del dispositivo per il rilevamento del fuso orario in base alle impostazioni scelte dall'utente:

• [Data e ora] Imposta automaticamente il fuso orario:OFF

  • L'utente deve selezionare manualmente il fuso orario.

• [Data e ora] Imposta automaticamente il fuso orario:ON

  • [Posizione] Usa posizione: OFF

    • Gli indicatori di telefonia vengono utilizzati per rilevare il fuso orario.

  • [Posizione] Usa posizione: ON

    • [Data e ora] Usa la posizione per impostare il fuso orario: ON

      • La posizione viene utilizzata per rilevare il fuso orario.

    • [Data e ora] Usa la posizione per impostare il fuso orario: OFF

      • Gli indicatori di telefonia vengono utilizzati per rilevare il fuso orario.

Dispositivi con più utenti

Poiché molte delle impostazioni coinvolte sono limitate all'utente corrente, il comportamento di rilevamento del fuso orario di un dispositivo può cambiare quando l'utente corrente cambia su un dispositivo Android multiutente.

L'opzione di attivazione/disattivazione Usa posizione per impostare il fuso orario è limitata all'utente corrente e non è limitata dai criteri del dispositivo, il che significa che gli utenti possono sempre modificarne il valore, anche quando l'opzione di attivazione/disattivazione Imposta fuso orario automaticamente è disattivata o se altri controlli dell'ora o del fuso orario sono limitati dal Controller dei criteri del dispositivo.

 Dispositivi che supportano solo l'algoritmo di rilevamento del fuso orario in base alla posizione

Questa sezione descrive il comportamento dei dispositivi che supportano solo l'algoritmo di geolocalizzazione.

• Android 14 e versioni successive

  • L'opzione Usa posizione non viene mostrata agli utenti nell'app Impostazioni AOSP e il dispositivo si comporta come se l'opzione Usa posizione fosse attivata.
  • Il valore dell'impostazione SettingsProvider basata sugli utenti location_time_zone_detection_enabled viene ignorato. Questo valore registra la preferenza dell'utente su altri tipi di dispositivi.

• Android 12 o Android 13

  • L'opzione Usa posizione è visibile agli utenti nell'app Impostazioni AOSP e gli utenti possono disattivarla. Se l'opzione è disattivata, il dispositivo non rileva automaticamente il fuso orario.

Comportamento quando si passa dal rilevamento automatico e viceversa

Quando l'utente passa dal rilevamento del fuso orario manuale ad automatico,time_zone_detector potrebbe già essere certo del fuso orario corrente. In questo caso, quando l'utente attiva il rilevamento automatico, il fuso orario del dispositivo potrebbe essere modificato contemporaneamente in modo da corrispondere all'opinione del servizio time_zone_detector.

Analogamente, quando l'utente apporta una modifica nelle Impostazioni che comporta una modifica dell'algoritmo corrente del servizio time_zone_detector, time_zone_detector potrebbe già aver ricevuto suggerimenti per il nuovo algoritmo, pertanto l'ora del dispositivo potrebbe essere modificata in modo da corrispondere immediatamente all'opinione del servizio time_zone_detector.

Rilevamento del fuso orario per la telefonia

Il rilevamento del fuso orario tramite telefonia utilizza gli indicatori di telefonia per determinare il fuso orario corrente. Per ulteriori informazioni, vedi Rilevamento del fuso orario per la telefonia.

Rilevamento del fuso orario in base alla posizione

Il rilevamento del fuso orario in base alla posizione è disponibile su Android 12 o versioni successive. Si tratta di una funzionalità facoltativa di rilevamento automatico del fuso orario che consente ai dispositivi di utilizzare la loro posizione per determinare il fuso orario corrente.

Il servizio location_time_zone_manager, introdotto in Android 12, viene eseguito nel server di sistema e contiene il codice responsabile dell'invio di suggerimenti per gli algoritmi di geolocalizzazione al servizio time_zone_detector. Per ulteriori informazioni, consulta Rilevamento del fuso orario della posizione.

Considerazioni sull'adozione delle funzionalità

Questa sezione descrive alcuni aspetti della funzionalità di rilevamento del fuso orario in base alla posizione per aiutare un produttore di dispositivi a decidere se adottarla su un dispositivo.

Confrontare la telefonia e il rilevamento della posizione

La seguente tabella fornisce un confronto dei vantaggi e degli svantaggi dell'utilizzo della posizione anziché degli indicatori di telefonia per il rilevamento del fuso orario.

Privacy degli utenti

Il fuso orario preferito di un utente viene solitamente determinato dalla sua posizione geografica. La posizione è un dato sensibile. Gli utenti potrebbero essere preoccupati per la condivisione della conoscenza della loro posizione nell'ambito del rilevamento del fuso orario. Indipendentemente dal rilevamento del fuso orario, tutte le app in esecuzione su un dispositivo possono leggere il fuso orario corrente del dispositivo senza richiedere un'autorizzazione Android e possono dedurre un'idea imprecisa della posizione del dispositivo da queste informazioni.

Nello specifico, il rilevamento del fuso orario può avvenire tramite metodi passivi o attivi:

• Passivo: un elemento nell'ambiente del dispositivo indica al dispositivo il fuso orario da utilizzare in quell'ambiente.
• Attivo: il dispositivo deve calcolare autonomamente il fuso orario e, a seconda delle impostazioni della privacy e del consenso degli utenti, ottiene la posizione del dispositivo per farlo. Può quindi condividere la sua posizione con servizi esterni. Per maggiori dettagli sulla privacy e sul consenso dell'utente, consulta la sezione di seguito.

Il rilevamento passivo, ad esempio con l'algoritmo di telefonia, non ha implicazioni sulla privacy degli utenti.

Il rilevamento attivo, ad esempio con l'algoritmo di geolocalizzazione, prevede la determinazione della posizione del dispositivo, che gli utenti potrebbero non voler accettare, e la posizione potrebbe essere inviata tramite una rete per determinare l'ID fuso orario.

L'approccio di Android alla privacy degli utenti per il rilevamento del fuso orario offre all'utente la possibilità di disattivare singolarmente gli algoritmi che dovrebbero essere attivi. Inoltre, il codice della piattaforma AOSP non gestisce direttamente la posizione stessa: il rilevamento della posizione e la mappatura della posizione agli ID fuso orario sono lasciati ai componenti plug-in configurati dai produttori di dispositivi.

Per maggiori dettagli sulle funzionalità per la privacy degli utenti, vedi Rilevamento del fuso orario della posizione.

Configurazione

I produttori di dispositivi possono configurare il servizio time_zone_detector per modificarne il comportamento. Questa sezione descrive le opzioni di configurazione per il comportamento generale del servizio time_zone_detector. Per i dettagli di configurazione degli algoritmi di rilevamento della telefonia e del fuso orario, consulta Rilevamento del fuso orario in base alla telefonia e Rilevamento del fuso orario in base alla posizione.

La configurazione di base di AOSP si trova all'indirizzo frameworks/base/core/res/res/values/config.xml.

 Modificare il comportamento predefinito del dispositivo

In AOSP, il rilevamento automatico del fuso orario è abilitato per impostazione predefinita con l'impostazione auto_time_zone impostata su true. Per disattivare il rilevamento automatico dell'ora per impostazione predefinita, imposta il valore di def_auto_time_zone definito in frameworks/base/packages/SettingsProvider/res/values/defaults.xml su false.

Quando ripristini un backup da un altro dispositivo, il framework aggiorna il valore dell'impostazione auto_time_zone per impostazione predefinita. Se vuoi assicurarti che questa impostazione non venga ripristinata da un backup, includi auto_time_zone nell' array restore_blocked_global_settings definito in frameworks/base/packages/SettingsProvider/res/values/blocked_settings.xml.

Debug e test del fuso orario

Questa sezione fornisce informazioni su come eseguire il debug e testare il comportamento del servizio time_zone_detector e di altri componenti condivisi da tutti gli algoritmi.

Configurare un dispositivo utilizzando il servizio device_config

Il servizio device_config è un meccanismo utilizzato su Android per configurare un comportamento modificabile utilizzando valori che in genere vengono estratti da un server remoto tramite codice proprietario (non AOSP). Quando utilizzi i valori device_config per i test, soprattutto durante i test manuali di lunga durata, il dispositivo potrebbe sincronizzare i flag, che verranno reimpostati e i valori impostati per i test verranno cancellati.

In Android 12 o versioni successive, per impedire temporaneamente la sincronizzazione dei flag, utilizza:

adb shell cmd device_config set_sync_disabled_for_tests persistent

Per ripristinare la sincronizzazione dei flag dopo i test, utilizza:

adb shell cmd device_config set_sync_disabled_for_tests none

Dopo aver ripristinato la sincronizzazione degli indicatori, riavvia il dispositivo.

Per ulteriori informazioni, utilizza $ adb shell cmd device_config help.

Interagire con il servizio time_zone_detector

Per visualizzare la configurazione e lo stato del servizio time_zone_detector, utilizza:time_zone_detector

adb shell cmd time_zone_detector dump

Per visualizzare altri comandi per il debug e il test del rilevamento del fuso orario, utilizza:

adb shell cmd time_zone_detector help

L'output della guida descrive anche le proprietà del servizio device_config che possono essere utilizzate per influire sul comportamento del servizio device_config per i test o in produzione.time_zone_detector Per maggiori dettagli, vedi Configurare un dispositivo utilizzando il servizio device_config.

Per convalidare il rilevamento del fuso orario, i tester devono sapere quale algoritmo viene utilizzato da time_zone_detector. Per comprendere e influenzare l'algoritmo corrente del time_zone_detector, utilizza una delle seguenti opzioni:

• Controlla visivamente tramite l'interfaccia utente delle Impostazioni. Per ulteriori informazioni, consulta Impostazioni del fuso orario.

• Utilizza la riga di comando tramite adb:

  • Per eseguire il dump dello stato di time_zone_detector, utilizza adb shell cmd time_zone_detector dump
  • Per modificare l'impostazione del dispositivo, utilizza altri comandi time_zone_detector. Per ulteriori informazioni, utilizza adb shell cmd time_zone_detector help.

Di seguito è riportato un esempio dell'output del comando adb shell cmd time_zone_detector dump, con le informazioni sull'algoritmo e sullo stato del servizio correnti in grassetto:

$ adb shell cmd time_zone_detector dump
TimeZoneDetectorStrategy:
  mEnvironment.getCurrentUserId()=0
  mEnvironment.getConfiguration(currentUserId)=ConfigurationInternal{mUserId=0, mUserConfigAllowed=true, mTelephonyDetectionSupported=true, mGeoDetectionSupported=true, mAutoDetectionEnabled=true, mLocationEnabled=true, mGeoDetectionEnabled=true}
  [Capabilities=TimeZoneCapabilitiesAndConfig{mCapabilities=TimeZoneDetectorCapabilities{mUserHandle=UserHandle{0}, mConfigureAutoDetectionEnabledCapability=40, mConfigureGeoDetectionEnabledCapability=40, mSuggestManualTimeZoneCapability=30}, mConfiguration=TimeZoneConfiguration{mBundle=Bundle[{geoDetectionEnabled=true, autoDetectionEnabled=true}]}}]
  mEnvironment.isDeviceTimeZoneInitialized()=true
  mEnvironment.getDeviceTimeZone()=Europe/London
  Time zone change log:
  Manual suggestion history:
...
  Geolocation suggestion history:
...
  Telephony suggestion history:
...

Le informazioni possono essere interpretate come segue:

Le informazioni sulla cronologia dei suggerimenti indicano quali suggerimenti sono stati fatti tramite Impostazioni (manualmente) e dagli algoritmi di telefonia e posizione.