Profilo di utilizzo della batteria con Statistiche statistiche batteria e Storico batteria

Avviso: la funzionalità Storico della batteria non viene più gestita attivamente. Se possibile, valuta la possibilità di utilizzare il tracciamento del sistema, la metrica dell'alimentazione di Macrobenchmark o il Power Profiler per ottenere informazioni sulle prestazioni della batteria.

Questo documento mostra i passaggi di configurazione di base e il flusso di lavoro per lo strumento Batterystats e lo script Battery Historian. Per informazioni su come utilizzare la funzionalità Storico della batteria per controllare i modelli di consumo della batteria, consulta Analizzare il consumo di energia con Battery Historian.

Le statistiche sulla batteria sono uno strumento incluso nel framework Android che raccoglie i dati della batteria sul dispositivo. Puoi utilizzare adb per scaricare i dati sulla batteria raccolti nella tua macchina di sviluppo e creare un report da analizzare utilizzando Battery Historian. Battery Historian converte il report da Batterystats in una visualizzazione HTML che puoi visualizzare nel browser.

Le statistiche sulla batteria e la cronologia della batteria sono utili per:

• Visualizzazione di dove e come i processi assorbono corrente dalla batteria.
• Identificare le attività nella tua app che possono essere differite o rimosse per aumentare la durata della batteria.

Nota: per utilizzare le statistiche della batteria e la cronologia della batteria, devi avere un dispositivo mobile in cui sia attivo il debug USB.

Installa Storico batteria

Puoi utilizzare Docker per installare la cronologia della batteria. Per metodi di installazione alternativi, tra cui la creazione dal codice sorgente, consulta il file README nella pagina GitHub del progetto. Per eseguire l'installazione con Docker, segui questi passaggi:

1. Installa Docker seguendo le istruzioni sul sito web di Docker. È valido qualsiasi tipo di abbonamento, incluso un abbonamento personale senza costi.

2. Per confermare che Docker è installato correttamente, apri la riga di comando e inserisci questo comando:

   docker run hello-world
   

   Se Docker è installato correttamente, visualizza un output come questo:

   Unable to find image 'hello-world:latest' locally
   latest: Pulling from library/hello-world
   78445dd45222: Pull complete
   Digest:
   sha256:c5515758d4c5e1e838e9cd307f6c6a0d620b5e07e6f927b07d05f6d12a1ac8d7
   Status: Downloaded newer image for hello-world:latest
   
   Hello from Docker!
   This message shows that your installation appears to be working correctly.
   
   To generate this message, Docker took the following steps:
   1. The Docker client contacted the Docker daemon.
   2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
   3. The Docker daemon created a new container from that image which runs the
   executable that produces the output you are currently reading.
   4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal
   

3. Avvia l'app Docker per desktop, che è un frontend GUI per Docker, prima di eseguire l'immagine Battery Historian. L'esecuzione di questo comando inizializza gli strumenti Docker. La funzionalità Storico della batteria non funziona finché non esegui questa operazione almeno una volta.

4. Esegui Battery Historian dalla riga di comando quando lo utilizzi per la prima volta. L'app Docker desktop non consente di specificare la porta su cui eseguire il server web. Puoi eseguire questa operazione solo dalla riga di comando. Tuttavia, dopo aver eseguito correttamente il container dalla riga di comando, viene creata una voce in Docker Desktop e quindi puoi avviarla utilizzando la stessa porta listener di Docker Desktop.

5. Esegui l'immagine Battery Historian utilizzando questo comando:

   docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
   

   Battery Historian utilizza la porta che preferisci, come specificato utilizzando port_number.

   Nota: se utilizzi un computer Windows, potrebbe essere necessario abilitare la virtualizzazione nel BIOS. Controlla la documentazione relativa alla scheda madre per saperne di più su come abilitare la virtualizzazione. Se puoi eseguire l'emulatore Android, la virtualizzazione è già abilitata.

6. Vai a Battery Historian nel browser per verificare che il dispositivo sia in esecuzione. L'indirizzo varia a seconda del sistema operativo:

   Per Linux e Mac

   Battery Historian è disponibile all'indirizzo http://localhost:port_number.

   Per Windows

   Dopo aver avviato Docker, il sistema indica l'indirizzo IP della macchina in uso. Ad esempio, se l'indirizzo IP è 123.456.78.90, Battery Historian è disponibile all'indirizzo http://123.456.78.90:port_number.

   Viene visualizzata la pagina iniziale di Battery Historian, dove puoi caricare e visualizzare le statistiche sulla batteria.

   

   Figura 1. La pagina iniziale di Battery Historian.

Raccogli dati con le statistiche della batteria

Per raccogliere dati dal dispositivo usando le statistiche della batteria e aprirli in Storico della batteria, procedi nel seguente modo:

1. Collega il dispositivo mobile al computer.

2. Da una finestra del terminale, arresta il server adb in esecuzione eseguendo questo comando:

   adb kill-server
   

3. Riavvia adb e verifica la presenza di dispositivi connessi eseguendo il comando seguente.

   adb devices
   

   Elenca il tuo dispositivo, come nell'output di esempio che segue.

   

   Figura 2. L'output di adb devices, che mostra un dispositivo connesso

   Se non sono elencati dispositivi, assicurati che il tuo telefono sia connesso e che il debug USB sia attivo, quindi interrompi e riavvia adb.

4. Reimposta la raccolta dei dati della batteria eseguendo questo comando:

   adb shell dumpsys batterystats --reset
   

   Il dispositivo raccoglie sempre le statistiche della batteria e altre informazioni di debug in background. Il ripristino cancella i dati di raccolta della batteria precedenti. Se non lo reimposti, l'output può essere molto grande.

5. Scollega il dispositivo dal computer in modo da attingere solo corrente dalla batteria del dispositivo.

6. Utilizza la tua app ed esegui le azioni per le quali vuoi raccogliere i dati. Ad esempio, disconnettiti dalla rete Wi-Fi e invia dati al cloud.

7. Ricollega il telefono.

8. Assicurati che il telefono venga riconosciuto ed esegui questo comando:

   adb devices
   

9. Esegui il dump di tutti i dati della batteria eseguendo il comando seguente. L'operazione può richiedere qualche minuto.

   adb shell dumpsys batterystats > [path/]batterystats.txt
   

   Il file batterystats.txt viene creato nella directory specificata utilizzando l'argomento facoltativo del percorso. Se non specifichi un percorso, il file viene creato nella directory home.

10. Crea un report a partire da dati non elaborati.

    Per i dispositivi con Android 7.0 e versioni successive:

    adb bugreport [path/]bugreport.zip

    Per i dispositivi con Android 6.0 e versioni precedenti:

    adb bugreport [path/]bugreport.txt

    Il completamento della segnalazione di bug può richiedere diversi minuti. Non disconnettere il dispositivo o annullare il processo fino al termine dell'operazione.

    Come per batterystats.txt, questi file vengono creati nella directory da te specificata utilizzando l'argomento facoltativo path. Se non specifichi un percorso, vengono creati nella directory home.

    Se non è già in esecuzione, esegui Battery Historian utilizzando questo comando:

    docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
    

11. Per visualizzare i dati in Battery Historian, apri Battery Historian nel browser. Per Mac e Linux, Battery Historian è in funzione a http://localhost:port_number. Per Windows, la cronologia della batteria è in esecuzione a http://your_IP_address:port_number.

12. Fai clic su Sfoglia, quindi scegli il file della segnalazione di bug che hai creato.

13. Fai clic su Invia. Storico della batteria apre un grafico creato a partire dai dati delle tue statistiche sulla batteria.

Visualizzare i dati con i grafici di Storico della batteria

Il grafico relativo alla cronologia della batteria mostra gli eventi rilevanti per l'alimentazione nel tempo.

Ogni riga mostra un segmento di una barra colorata quando un componente di sistema è attivo e che, in questo modo, sta prelevando la corrente dalla batteria. Il grafico non mostra la quantità di batteria utilizzata dal componente, ma solo se l'app è attiva. I grafici sono organizzati per categoria, con una barra per ciascuna categoria nel tempo, come mostrato sull'asse x del grafico.

Figura 3. Esempio di grafico sulla cronologia della batteria.

1. Aggiungi altre metriche dall'elenco a discesa.
2. Tieni il puntatore del mouse sul nome della metrica per visualizzare ulteriori informazioni su ogni metrica, inclusa una chiave per i colori utilizzati nel grafico.
3. Tieni il puntatore sopra una barra per visualizzare informazioni più dettagliate sulla metrica e sulle statistiche della batteria in un punto specifico della sequenza temporale.

Dati sulle statistiche della batteria aggiuntive

Puoi visualizzare ulteriori informazioni dal file batterystats.txt nella sezione delle statistiche dopo il grafico della cronologia della batteria.

Figura 4. La sezione delle statistiche di Battery Historian.

La scheda 1 Statistiche del sistema include statistiche a livello di sistema, ad esempio i livelli di segnale della rete e la luminosità dello schermo. Queste informazioni forniscono un quadro generale di ciò che accade con il dispositivo. Ciò è particolarmente utile per assicurarsi che nessun evento esterno influisca sul test.

La scheda 2 Statistiche app include informazioni su app specifiche. Ordina l'elenco delle app utilizzando l'elenco a discesa 3 Ordina app per nel riquadro Selezione app. Puoi selezionare un'app specifica per visualizzare le statistiche utilizzando l'elenco a discesa delle 4 app.