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

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:

  1. Installa Docker Community Edition seguendo le istruzioni sul sito web di Docker.

  2. 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
    
  3. 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.

  4. 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
    Viene visualizzata la pagina iniziale dello storico delle batterie, in cui puoi caricare e visualizzare le statistiche sulla batteria.

    Pagina iniziale per lo storico della batteria
    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:

  1. Collega il dispositivo mobile al computer.

  2. In una finestra Terminale, arresta il server adb in esecuzione.

    adb kill-server
    
  3. Riavvia ADB e controlla i dispositivi connessi.

    adb devices
    

    Dovresti vedere il tuo dispositivo elencato, simile all'output di esempio riportato di seguito.

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

    Se non vedi nessun dispositivo, assicurati che il telefono sia connesso e che il debug USB sia attivo, quindi elimina e riavvia ADB.

  4. 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.

  5. Scollega il tuo dispositivo dal computer in modo da utilizzare corrente solo con la batteria del dispositivo.

  6. 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.

  7. Ricollega il telefono.

  8. Assicurati che il telefono sia riconosciuto:

    adb devices
    
  9. 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.

  10. 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'argomento path 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
    
  11. 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'indirizzo http://your_IP_address:port_number.

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

  13. 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.

Esempio di grafico storico batteria
Figura 3. Esempio di grafico storico a batteria

  1. Aggiungi altre metriche dall'elenco a discesa.
  2. Passa il mouse sopra le icone delle informazioni per visualizzare ulteriori informazioni su ciascuna metrica, inclusa una chiave per i colori utilizzati nel grafico.
  3. 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.

Nella sezione Statistiche di Batteria
Figura 4. Nella sezione Statistiche di Batteria

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.