Configurazione delle opzioni per sviluppatori sul dispositivo

L'app Impostazioni su Android include una schermata chiamata Opzioni sviluppatore in cui puoi configurare i comportamenti del sistema che ti aiutano a profilare ed eseguire il debug delle prestazioni dell'app. Ad esempio, puoi attivare il debug tramite USB, acquisire una segnalazione di bug, attivare il feedback visivo per i tocchi, lampeggiare le superfici delle finestre quando si aggiornano, utilizzare la GPU per il rendering della grafica 2D e altro ancora.

Attiva Opzioni sviluppatore

Su Android 4.1 e versioni precedenti, la schermata Opzioni sviluppatore è disponibile per impostazione predefinita. Su Android 4.2 e versioni successive, devi attivare questa schermata.

Nota: su alcuni dispositivi, la schermata Opzioni sviluppatore potrebbe trovarsi o avere un nome diverso.

  1. Sul dispositivo, individua l'opzione Numero build. La tabella seguente mostra la posizione delle impostazioni del Numero build su vari dispositivi:

    Tabella 1. Posizione delle impostazioni del dispositivo per l'opzione Numero build

    Dispositivo Impostazione

    Google Pixel

    Impostazioni > Informazioni sul telefono > Numero build

    Samsung Galaxy S8 e modelli successivi

    Impostazioni > Informazioni sullo smartphone > Informazioni sul software > Numero build

    LG G6 e modelli successivi

    Impostazioni > Informazioni sul telefono > Informazioni sul software > Numero build

    HTC U11 e versioni successive

    Impostazioni > Informazioni > Informazioni sul software > Altro > Numero build oppure Impostazioni > Sistema > Informazioni sul telefono > Informazioni sul software > Altro > Numero build

    OnePlus 5T e modelli successivi

    Impostazioni > Informazioni sul telefono > Numero build

  2. Tocca l'opzione Numero build sette volte finché non viene visualizzato il messaggio You are now a developer!. Questa opzione abilita le opzioni sviluppatore sul tuo dispositivo.

  3. Torna alla schermata precedente per trovare le Opzioni sviluppatore in fondo.

Figura 1. Opzioni per sviluppatori on-device.

Nella parte superiore della schermata Opzioni sviluppatore, puoi attivare o disattivare le opzioni, come mostrato nella figura 1. Lascia attiva questa opzione. Quando l'opzione è disattivata, viene disattivata la maggior parte delle opzioni, ad eccezione di quelle che non richiedono la comunicazione tra il dispositivo e il computer di sviluppo.

Attiva il debug USB sul dispositivo

Prima di poter utilizzare il debugger e altri strumenti, devi attivare il debug USB, che consente ad Android Studio e ad altri strumenti SDK di riconoscere il dispositivo quando è collegato tramite USB.

Attiva Debug USB nelle impostazioni di sistema del dispositivo nella sezione Opzioni sviluppatore. Puoi trovare questa opzione in una delle seguenti posizioni, a seconda della versione di Android:

  • Android 9 (livello API 28) e versioni successive: Impostazioni > Sistema > Avanzate > Opzioni sviluppatore > Debug USB.
  • Android 8.0.0 (livello API 26) e Android 8.1.0 (livello API 27): Impostazioni > Sistema > Opzioni sviluppatore > Debug USB
  • Android 7.1 (livello API 25) e versioni precedenti: Impostazioni > Opzioni sviluppatore > Debug USB.

Opzioni generali

Tocca i Riquadri sviluppatore delle Impostazioni rapide per aggiungere le opzioni sviluppatore selezionate al riquadro Impostazioni rapide.

Dopo aver selezionato uno o più riquadri disponibili, mostrati nella figura 2, apri il riquadro Impostazioni rapide e tocca la matita per accedere alla modalità di modifica. Trascina quindi i riquadri sviluppatore dal riquadro dei riquadri al riquadro Impostazioni rapide e tocca di nuovo la matita per uscire dalla modalità di modifica.

Figura 2. Aggiungi opzioni al riquadro Impostazioni rapide.

Altre opzioni generali sono:

  • Memoria: mostra le statistiche della memoria, ad esempio l'utilizzo medio della memoria, le prestazioni della memoria, la memoria totale disponibile, la memoria media utilizzata, la quantità di memoria libera disponibile e la quantità di memoria utilizzata dalle app.
  • Apri segnalazione bug: ottiene una copia dei file di log attuali del dispositivo da condividere con qualcuno. Quando ricevi una notifica che ti informa che la segnalazione di bug è pronta, toccala per condividerla.
  • Modalità demo UI di sistema: semplifica l'acquisizione di screenshot puliti grazie alla visualizzazione di una barra di notifiche generica e preimpostata che non mostra notifiche o avvisi di batteria in esaurimento. Abilita modalità demo ti consente di modificare l'aspetto della barra di stato utilizzando i comandi della modalità demo di adb. In alternativa, puoi utilizzare Mostra modalità demo per nascondere le notifiche e visualizzare una barra di stato predefinita.
  • Password di backup del computer: imposta una password di backup in modo da poter utilizzare i comandi adb per eseguire il backup e il ripristino di app e dati del dispositivo soggetti alla protezione tramite password.
  • Rimani attivo: consente di impostare lo schermo in modo che rimanga attivo quando il dispositivo è collegato.
  • Abilita il log di snoop Bluetooth Host Controller Interface (HCI): acquisisce tutti i pacchetti HCI Bluetooth in un file archiviato in /sdcard/btsnoop_hci.log. Puoi recuperare i pacchetti e utilizzare un programma come Wireshark per analizzare le informazioni e risolvere i problemi.

Debug

Figura 3. Opzioni di debug abilitate.

Le opzioni di debug consentono di configurare il debug sul dispositivo e di stabilire una comunicazione tra il dispositivo e il computer di sviluppo.

Attiva il debug USB, come mostrato nella Figura 3, in modo che il tuo dispositivo Android possa comunicare con la tua macchina di sviluppo tramite Android Debug Bridge (adb). L'opzione Attendi per Debugger non è disponibile finché non utilizzi Seleziona app di debug per selezionare l'app di cui eseguire il debug. Se attivi Attendi per Debugger, l'app selezionata attende il collegamento del debugger prima dell'esecuzione.

Altre opzioni di debug includono:

  • Archivia i dati del logger in modo permanente sul dispositivo: seleziona il tipo di messaggi di log che vuoi archiviare in modo permanente sul dispositivo. Le opzioni sono disattivate, tutte, tutte tranne la radio o solo kernel.
  • Seleziona app di posizione simulata: utilizza questa opzione per simulare la posizione GPS del dispositivo e verificare se l'app si comporta allo stesso modo in altre località. Per utilizzare questa opzione, scarica e installa un'app di localizzazione GPS simulata.

    • Figura 4. Visualizza attributi.

  • Abilita ispezione degli attributi vista: salva le informazioni sugli attributi vista nella variabile membro mAttributes di un'istanza View in modo che possano essere utilizzate per il debug. Puoi accedere alle informazioni sugli attributi tramite l'interfaccia utente Layout Inspector, come mostrato nella Figura 4. Se questa opzione non è abilitata, l'elemento **Attributes** (Attributi) non è disponibile.
  • Attiva i livelli di debug GPU. Funzionalità disponibile sui dispositivi con Android 9 (livello API 28) e versioni successive. Attiva questa opzione per consentire il caricamento dei livelli di convalida Vulkan dallo spazio di archiviazione locale del dispositivo. Per scoprire di più, consulta la pagina Livelli di convalida Vulkan su Android.

Reti

Figura 5. Seleziona le opzioni di configurazione USB.

Le opzioni di networking forniscono modi per configurare le impostazioni Wi-Fi e DHCP.

Tocca Seleziona configurazione USB per specificare in che modo il computer deve identificare il dispositivo. Come mostrato nella figura 5, puoi configurare i dispositivi solo per la ricarica, per trasferire file (MTP), trasferire immagini (PTP), utilizzare internet mobile sul PC (RNDIS) o trasferire file audio o MIDI.

Tocca Versione AVRCP Bluetooth e seleziona la versione del profilo che vuoi utilizzare per controllare l'apparecchiatura A/V Bluetooth a cui ha accesso il tuo dispositivo.

Inoltre, per perfezionare la riproduzione audio sul dispositivo, tocca e imposta le seguenti opzioni:

  • Codec audio Bluetooth:regola la qualità audio (codec) dei dispositivi selezionando uno dei seguenti codec:
    • SBC: trasferisce i dati a dispositivi di output audio Bluetooth come cuffie e altoparlanti.
    • AAC: offre una migliore qualità audio dai dispositivi con cavo rispetto all'MP3 a velocità in bit simili.
    • aptX: fornisce un suono wireless su smartphone, speaker, soundbar, cuffie e tablet di alta qualità.
    • aptX HD: fornisce lo streaming ad alta risoluzione sui dispositivi Bluetooth.
    • LDAC: consente un ascolto di musica di alta qualità tramite connessioni wireless.
  • Abilita codec facoltativi e Disattiva codec facoltativi: se hai installato ulteriori implementazioni di codec, utilizza queste opzioni per attivarle e disattivarle.
  • Bluetooth Audio Sample Range:regola il numero di campioni audio al secondo selezionando una frequenza di campionamento del codec audio. Frequenza di campionamento più elevate utilizzano più risorse.
  • Bit audio Bluetooth per campione: imposta il numero di bit di informazioni in ogni campione audio. Con una velocità in bit maggiore, l'audio è migliore, ma il file di esempio è più grande.
  • Modalità canale audio Bluetooth: seleziona mono o stereo.
  • Codec LDAC audio Bluetooth:ottimizza il suono per aumentare la qualità audio, bilanciare l'audio e la qualità della connessione, aumentare la qualità della connessione oppure utilizzare una velocità in bit adattiva per bilanciare audio e qualità della connessione.

Il seguente elenco descrive altri modi per configurare la configurazione Wi-Fi e DHCP:

  • Certificazione per i display wireless: consente di attivare controlli e impostazioni di configurazione avanzati per la certificazione dei display wireless in base alle specifiche stabilite nelle specifiche stabilite nelle specifiche dei display Wi-Fi Wi-Fi Alliance.
  • Attiva il logging dettagliato per il Wi-Fi: aumenta il livello di logging del Wi-Fi per ogni rete wireless (SSID) a cui ti connetti in base alla relativa potenza del segnale ricevuto (RSSI). Per maggiori informazioni sui log, consulta Scrivere e visualizzare i log con Logcat.
  • Passaggio aggressivo da Wi-Fi a rete mobile: quando il segnale è basso, il Wi-Fi è più efficiente nel trasferire la connessione dati a una rete mobile.

Ingresso

Attiva Mostra tocchi per visualizzare i tocchi quando tocchi lo schermo. Sotto il dito o lo stilo viene visualizzato un cerchio che ti segue mentre ti muovi sullo schermo. Un tocco funziona come un puntatore quando registri un video sul dispositivo.

Figura 6. Barra della posizione del puntatore.

Attiva Posizione puntatore per mostrare la posizione del puntatore (tocco) sul dispositivo con mirino. Nella parte superiore dello schermo viene visualizzata una barra per tracciare le coordinate del mirino, come mostrato nella Figura 6. Quando sposti il puntatore, le coordinate nella barra tracciano la posizione del mirino e il percorso del puntatore viene disegnato sullo schermo.

Disegno

Figura 7. Creazione dell'interfaccia utente.

Le opzioni di disegno forniscono indicazioni visive sull'interfaccia utente dell'app e sul suo funzionamento.

Attiva Mostra limiti del layout per mostrare sul dispositivo i margini dei clip e i margini dell'app, nonché altre strutture dell'interfaccia utente, come mostrato nella figura 7.

Altre opzioni di disegno includono:

  • Forza la direzione del layout RTL: forza la direzione del layout dello schermo da destra a sinistra (RTL) o da sinistra a destra (impostazione predefinita).
  • Scala animazione finestra: imposta la velocità di riproduzione dell'animazione delle finestre in modo da poterne verificarne le prestazioni a velocità diverse. Una scala più bassa si traduce in una velocità maggiore.
  • Scala animazione di transizione: imposta la velocità di riproduzione dell'animazione di transizione per verificarne le prestazioni a velocità diverse. Una scala più bassa si traduce in una velocità maggiore.
  • Simula display secondari:crea un display secondario come overlay sul dispositivo. Questo è utile quando supporti display aggiuntivi con l'API Presentation. Per maggiori informazioni, consulta Display secondari.

Rendering con accelerazione hardware

Figura 8. Spazio colore deuteranomalia.

Le opzioni di rendering con accelerazione hardware offrono modi per ottimizzare la tua app per le sue piattaforme hardware di destinazione sfruttando opzioni basate su hardware come GPU, livelli hardware e anti-aliasing multicampione (MSAA).

Tocca Simula spazio colore per modificare la combinazione di colori dell'intera UI del dispositivo. Le opzioni si riferiscono ai tipi di daltonismo. Le opzioni sono:

  • Disabilitata (nessuna combinazione di colori simulata)
  • Monocromaticità (limita la combinazione di colori al nero, al bianco e al grigio)
  • Deuteranomalia (influenza la visualizzazione dei colori rosso e verde)
  • Protanomalia (interessa il colore rosso e verde)
  • Tritanomalia (influenza la visualizzazione dei colori blu e giallo)
La protanomalia si riferisce al daltonismo rosso-verde con debolezza nei colori rosso, mentre la deuteranomalia, mostrata nella figura 8, si riferisce al daltonismo rosso-verde con debolezza nei colori verdi.

Gli screenshot acquisiti in uno spazio colore simulato sembrano normali, come se non avessi modificato la combinazione di colori.

Ecco altri modi per sfruttare le opzioni basate su hardware:

  • Imposta il renderer GPU: modifica il motore grafico Open GL predefinito sul motore grafico Skia Open GL Skia.
  • Forza rendering GPU: per impostazione predefinita, le app devono utilizzare la GPU per i disegni 2D se sono state scritte senza rendering GPU.
  • Mostra aggiornamenti visualizzazione GPU: mostra tutti gli elementi sullo schermo tracciati con la GPU.
  • Debug overdraw GPU: mostra la codifica dei colori sul dispositivo in modo da poter visualizzare quante volte lo stesso pixel è stato disegnato nello stesso frame. La visualizzazione mostra dove la tua app potrebbe eseguire più rendering del necessario. Per ulteriori informazioni, consulta la sezione Visualizzare l'overdraw della GPU.
  • Debug delle operazioni di ritaglio non rettangolare: disattiva l'area di ritaglio sul canvas per creare aree di canvas insolite (non rettangolari). Generalmente, l'area di ritaglio impedisce di disegnare qualsiasi elemento al di fuori dei margini dell'area circolare.
  • Forza MSAA 4x: attiva l'anti-aliasing multicampione (MSAA) nelle app Open GL ES 2.0.
  • Disattiva overlay HW: disattiva l'overlay hardware. Tieni presente che l'utilizzo dell'overlay hardware consente alle app che mostrano qualcosa sullo schermo di utilizzare meno potenza di elaborazione. Senza l'overlay, le app condividono la memoria video e devono verificare costantemente collisioni e clip per visualizzare un'immagine corretta. Il controllo utilizza molta potenza di elaborazione.

Contenuti multimediali

Attiva l'opzione Disattiva routing audio USB per disattivare il routing automatico a dispositivi audio esterni collegati a un computer tramite una porta USB. Il routing automatico può interferire con le app compatibili con USB.

In Android 11 e versioni successive, quando un'applicazione senza autorizzazione RECORD_AUDIO utilizza UsbManager per richiedere l'accesso diretto a un dispositivo audio USB con funzionalità di acquisizione audio (ad esempio le cuffie USB), viene visualizzato un messaggio di avviso che chiede all'utente di confermare l'autorizzazione a utilizzare il dispositivo. Il sistema ignora qualsiasi opzione "Usa sempre", quindi l'utente deve confermare l'avviso e concedere l'autorizzazione ogni volta che un'app richiede l'accesso. Per evitare questo comportamento, la tua app deve richiedere l'autorizzazione RECORD_AUDIO.

Monitoraggio

Figura 9. Profilo di rendering GPU come rappresentazione a barre.

Le opzioni di monitoraggio forniscono informazioni visive sulle prestazioni dell'app, ad esempio le operazioni su thread lunghi e GPU.

Tocca Profilo GPU rendering, quindi Sullo schermo come barre per visualizzare il profilo di rendering GPU sotto forma di barre, come mostrato nella figura 9. Per maggiori informazioni, consulta Profilare la velocità di rendering della GPU.

App

Figura 10. Imposta limite processi in background.

Le opzioni app ti aiutano a capire come funziona sul dispositivo di destinazione.

Tocca Limite di processi in background per impostare il numero di processi che possono essere eseguiti in background contemporaneamente. Le possibili impostazioni sono mostrate nella Figura 10.

Tocca Reimposta limitazione di frequenza di ScorciatoiaManager durante il test per consentire alle app in background di continuare a chiamare le API scorciatoia fino a quando il limite di frequenza non viene raggiunto di nuovo. Per maggiori informazioni sulle scorciatoie e sui limiti di frequenza, consulta ShortcutManager.

Attiva l'opzione Non conservare le attività per aumentare la durata della batteria eliminando ogni attività non appena l'utente abbandona la visualizzazione principale dell'attività.