Questa procedura dettagliata mostra i passaggi di base per la configurazione e il flusso di lavoro dello strumento Batterystats e dello script Historian della batteria. Per scoprire come utilizzare lo storico della batteria per controllare i modelli di consumo della batteria, consulta la pagina Analizzare il consumo energetico con lo storico della batteria.
Batterystats è uno strumento incluso nel framework Android che raccoglie i dati sulla batteria sul tuo dispositivo. Puoi utilizzare adb per eseguire il dump dei dati sulla batteria raccolti sulla tua macchina di sviluppo e creare un report che puoi analizzare utilizzando lo storico delle batterie. Lo storico delle batterie converte il report di Statistiche batteria in una visualizzazione HTML che puoi visualizzare nel browser.
A cosa serve:
- Mostrarti dove e come vengono assorbiti i processi dalla batteria.
- Identificare le attività della tua app che potrebbero essere differite o persino rimosse per aumentare la durata della batteria.
Installa Storico batteria
Il modo più semplice per installare Storico batteria è utilizzare Docker. Per metodi di installazione alternativi, tra cui la creazione dall'origine, consulta Leggimi nella pagina GitHub del progetto. Per eseguire l'installazione con Docker, procedi nel seguente modo:
Installa Docker Community Edition seguendo le istruzioni sul sito web di Docker.
Per confermare che Docker sia installato correttamente, apri la riga di comando e inserisci il comando seguente:
docker run hello-world
Se Docker è installato correttamente, vedrai un output simile al seguente:
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
Esegui l'immagine storico della batteria utilizzando il seguente comando:
docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.0 --port 9999
Lo storico della batteria utilizzerà la porta di tua scelta, come specificato tramite
port_number
.Vai a Storico batteria nel browser per verificare che sia in esecuzione. L'indirizzo varia a seconda del sistema operativo:
- Per Linux e Mac
- Storico della batteria è disponibile in
http://localhost:port_number
. - Per Windows
- Una volta avviato Docker, ti comunica l'indirizzo IP della macchina che sta utilizzando. Quindi, ad esempio, se l'indirizzo IP è 123.456.78.90, lo storico delle batterie è disponibile all'indirizzo
http://123.456.78.90:port_number
Figura 1. La pagina iniziale di Storia della batteria
Raccogli dati con Batterie
Per raccogliere dati dal tuo dispositivo usando Batteriestat e aprire il valore nella sezione Cronologia batteria, procedi nel seguente modo:
Collega il dispositivo mobile al computer.
In una finestra Terminale, arresta il server adb in esecuzione.
adb kill-server
Riavvia ADB e controlla i dispositivi connessi.
adb devices
Dovresti vedere il tuo dispositivo elencato, simile all'output di esempio riportato di seguito.
Figura 2. L'output di adb devices
, che mostra un dispositivo connessoSe non vedi nessun dispositivo, assicurati che il telefono sia connesso e che il debug USB sia attivo, quindi elimina e riavvia ADB.
Reimpostare la raccolta dei dati della batteria.
adb shell dumpsys batterystats --reset
Il dispositivo raccoglie sempre statistiche di batteria e altre informazioni di debug in background. La reimpostazione cancella i dati precedenti sulla raccolta della batteria. Se non lo reimposti, i risultati saranno enormi.
Scollega il tuo dispositivo dal computer in modo da utilizzare corrente solo con la batteria del dispositivo.
Gioca con l'app ed esegui azioni per le quali vuoi dati, ad esempio scollegati dalla rete Wi-Fi e invia i dati al cloud.
Ricollega il telefono.
Assicurati che il telefono sia riconosciuto:
adb devices
Scarica tutti i dati della batteria. L'operazione può richiedere alcuni minuti:
adb shell dumpsys batterystats > [path/]batterystats.txt
Il file
batterystats.txt
viene creato nella directory specificata utilizzando l'argomento del percorso facoltativo. Se non specifichi un percorso, il file viene creato nella directory home.Crea un report a partire dai 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 potrebbe richiedere diversi minuti. Non scollegare il dispositivo e non annullare il processo finché non è completo.
Come nel caso di
batterystats.txt
, i file vengono creati nella directory specificata utilizzando l'argomentopath
facoltativo. Se non specifichi un percorso, vengono creati nella directory home.Se non è già in esecuzione, esegui Storico batteria utilizzando il seguente comando:
docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.0 --port 9999
Per visualizzare i dati in storico della batteria, apri la cronologia della batteria nel tuo browser. Per Mac e Linux, la cronologia della batteria viene eseguita all'indirizzo
http://localhost:port_number
. Per Windows, Battery Historian è in esecuzione all'indirizzohttp://your_IP_address:port_number
.Fai clic su Sfoglia, quindi scegli il file della segnalazione di bug creato in precedenza.
Fai clic su Invia. Lo storico delle batterie aprirà un grafico creato con i dati delle batterie.
Visualizza i dati con i grafici storici della batteria
Il grafico sullo storico delle batterie traccia gli eventi relativi all'alimentazione nel tempo.
Ogni riga mostra un segmento della barra colorata quando un componente del sistema è attivo e preleva quindi la corrente dalla batteria. Il grafico non mostra la quantità di batteria utilizzata dal componente, ma solo che l'app era attiva. I grafici sono organizzati per categoria, mostrando una barra per ogni categoria nel tempo, come visualizzato sull'asse X del grafico.

- Aggiungi altre metriche dall'elenco a discesa.
- Passa il mouse sopra le icone delle informazioni per visualizzare ulteriori informazioni su ciascuna metrica, inclusa una chiave per i colori utilizzati nel grafico.
- Passa il mouse sopra una barra per visualizzare informazioni più dettagliate sulla metrica e le statistiche sulla batteria in un punto specifico della sequenza temporale.
Output statistiche statistiche aggiuntive
Puoi visualizzare ulteriori informazioni dal file batterystats.txt
nella sezione delle statistiche sotto il grafico sullo storico delle batterie.

La scheda 1 Statistiche di sistema include statistiche a livello di sistema, come livelli di segnale cellulare e luminosità dello schermo. Queste informazioni forniscono un quadro complessivo di ciò che sta accadendo con il dispositivo. Ciò è particolarmente utile per assicurarti che nessun evento esterno influisca sul test.
La scheda 2 Statistiche app include informazioni su app specifiche. Ordina l'elenco di app utilizzando l'elenco a discesa 3 Ordina app per nel riquadro Selezione app a sinistra. Puoi selezionare un'app specifica per visualizzare le statistiche sull'utilizzo dell'elenco a discesa 4 app di seguito.