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

Questo documento mostra i passaggi di configurazione di base e il flusso di lavoro per lo strumento Batterystats. e lo script storico della batteria. Per imparare a utilizzare Battery History per esamina gli schemi di consumo della batteria; consulta l'articolo Analizzare l'utilizzo della batteria con la batteria Storico.

Batterystats è uno strumento incluso nel framework Android che raccoglie la batteria sul tuo dispositivo. Puoi utilizzare adb per eseguire il dump raccolto i dati della batteria nel computer di sviluppo e creare un report l'analisi utilizzando Battery Historian. Lo storico della batteria converte il report da Batterystats in una visualizzazione HTML che puoi visualizzare nel tuo browser.

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

  • Mostrandoti dove e come i processi attingono corrente dalla batteria.
  • Identificare le attività nella tua app che possono essere differite o rimosse per migliorare della batteria.
di Gemini Advanced.

Installazione storico batteria

Puoi utilizzare Docker per installare Battery History. Per installazione alternativa tra cui la creazione dall'origine, vedi README sul pagina GitHub del progetto. Per eseguire l'installazione con Docker, segui questi passaggi:

  1. Installa Docker seguendo le istruzioni nella Sito web Docker. Qualsiasi il tipo di abbonamento funziona, incluso un abbonamento personale senza costi.

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

    docker run hello-world
    

    Se Docker è installato correttamente, viene visualizzato 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. Avvia l'app Docker Desktop, che è un frontend GUI per Docker, prima esegui l'immagine Battery Historian. L'esecuzione di questo comando inizializza i nostri strumenti. Battery Storico non funziona finché non esegui questa operazione almeno una volta.

  4. Esegui Battery History dalla riga di comando durante la prima esecuzione nel tempo. L'app Docker Desktop non consente di specificare la porta per eseguire il web che il server web sia attivato. Puoi eseguire questa operazione solo dalla riga di comando. Tuttavia, dopo aver il container dalla riga di comando, viene creata una voce Docker Desktop, quindi puoi avviarlo utilizzando la stessa porta listener da Docker Desktop.

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

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

    Battery Historian utilizza la porta di tua scelta, come specificato port_number.

  6. Vai a Battery Historian nel browser per verificare che sia in esecuzione. La varia a seconda del sistema operativo:

    Per Linux e Mac

    Battery Historian è disponibile su http://localhost:port_number.

    Per Windows

    Dopo aver avviato Docker, ti viene comunicato l'indirizzo IP della macchina in uso. Ad esempio, se l'indirizzo IP è 123.456.78.90, Lo storico è disponibile su http://123.456.78.90:port_number.

    Viene quindi visualizzata la pagina iniziale di Battery Historian, dove è possibile caricare visualizzare le statistiche sulla batteria.

    Pagina iniziale di Battery Historian
    Figura 1. Pagina iniziale di Batteria Storico.
    .

Raccogli dati con Batterystats

Per raccogliere dati dal tuo dispositivo usando Batterystats e aprirlo in Batteria Storico, procedi nel seguente modo:

  1. Collega il dispositivo mobile al computer.

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

    adb kill-server
    
  3. Riavvia adb e controlla la presenza di dispositivi connessi eseguendo questo comando .

    adb devices
    

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

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

    Se non compare alcun dispositivo, assicurati che lo smartphone sia connesso e USB debug sia attivato e quindi arresta e riavvia adb.

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

    adb shell dumpsys batterystats --reset
    

    Il dispositivo raccoglie sempre statistiche sulla batteria e altre informazioni di debug in background. La reimpostazione cancella i dati raccolti in precedenza sulla batteria. Se non vengono reimpostate, l'output può essere molto grande.

  5. Scollega il tuo dispositivo dal computer in modo da disegnare solo corrente della batteria del dispositivo.

  6. Utilizza la tua app ed esegui le azioni per le quali vuoi raccogliere dati. Per ad esempio scollegati dalla rete Wi-Fi e invia dati al cloud.

  7. Riconnetti lo smartphone.

  8. Assicurati che il tuo smartphone sia riconosciuto ed esegui questo comando:

    adb devices
    
  9. Esegui il comando seguente per scaricare tutti i dati della batteria. L'operazione può richiedere nel frattempo.

    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 tua home directory.

  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 scollegare il tuo dispositivo o annulla il processo fino al suo completamento.

    Come nel caso di batterystats.txt, questi file vengono creati nella directory specifica utilizzando l'argomento facoltativo path. Se non specificano un percorso, vengono creati nella home directory.

    Se non è già in esecuzione, esegui Battery Storico utilizzando quanto segue. :

    docker run -p port_number:9999 gcr.io/android-battery-historian/stable:3.1 --port 9999
    
  11. Per visualizzare i dati in Cronologia batteria, apri Cronologia batteria nel del browser. Per Mac e Linux, Battery Historian viene eseguita su http://localhost:port_number. Per Windows, batteria Lo storico corre a http://your_IP_address:port_number.

  12. Fai clic su Sfoglia e scegli il file di segnalazione di bug che hai creato.

  13. Fai clic su Invia. Battery Historian apre un grafico creato da Dati statistici sulla batteria.

Visualizzare i dati con i grafici Storico della batteria

Il grafico Storico della batteria mostra un grafico degli eventi legati all'energia nel tempo.

Ogni riga mostra un segmento a barre colorate quando un componente del sistema è attivo; pertanto, assorbindo corrente dalla batteria. Il grafico non mostra il livello di carica della batteria utilizzato dal componente, solo se l'app è attiva. I grafici sono organizzati per categoria, mostrando una barra per ogni categoria nel tempo, come visualizzato x del grafico.

Esempio di grafico Storico della batteria
Figura 3. Esempio di storico della batteria grafico.
  1. Aggiungi altre metriche dall'elenco a discesa.
  2. Tieni il puntatore sopra il 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 al riguardo. e le statistiche della batteria in un punto specifico della sequenza temporale.

Output aggiuntivo Batterystats

Puoi visualizzare ulteriori informazioni dal file batterystats.txt nel statistiche dopo il grafico Storico della batteria.

Sezione delle statistiche di Storico della batteria
Figura 4. Sezione delle statistiche della batteria Storico.

La scheda 1 Statistiche di sistema include l'intero sistema quali i livelli del segnale della cella e la luminosità dello schermo. Queste informazioni offre un quadro generale di ciò che accade con il dispositivo. Questo è particolarmente utile per assicurarsi che nessun evento esterno influenzi il test.

La scheda 2 Statistiche per app include informazioni su app specifiche. Ordina l'elenco delle app usando il 3 Elenco a discesa Ordina le app per nel riquadro Selezione app. Tu puoi selezionare un'app specifica per visualizzare le statistiche relative all'utilizzo Elenco a discesa 4 app.