Configurazione delle opzioni per sviluppatori sul dispositivo

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

Attivare le 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 essere posizionata o denominata in modo diverso.

1. Sul tuo dispositivo, trova 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 sullo smartphone > Numero build
   Samsung Galaxy S8 e modelli successivi	Impostazioni > Informazioni sullo smartphone > Informazioni sul software > Numero build
   LG G6 e modelli successivi	Impostazioni > Informazioni sullo smartphone > Informazioni sul software > Numero build
   HTC U11 e modelli successivi	Impostazioni > Informazioni > Informazioni sul software > Altro > Numero build o Impostazioni > Sistema > Informazioni sul telefono > Informazioni sul software > Altro > Numero build
   OnePlus 5T e modelli successivi	Impostazioni > Informazioni sullo smartphone > Numero build

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

3. Torna alla schermata precedente per trovare Opzioni sviluppatore in basso.

Nella parte superiore della schermata Opzioni sviluppatore, puoi attivare e disattivare le opzioni, come mostrato nella figura 1. Non disconnetterti. In questo caso, la maggior parte delle opzioni viene disattivata, tranne quelle che non richiedono la comunicazione tra il dispositivo e il computer di sviluppo.

Attivare 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 è connesso tramite USB.

Attiva il debug USB nelle impostazioni di sistema del dispositivo in 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 Riquadri sviluppatore Impostazioni rapide per aggiungere le opzioni sviluppatore selezionate al riquadro Impostazioni rapide.

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

Ecco altre opzioni generali:

• Memoria: visualizza le statistiche sulla 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: consente di acquisire una copia dei file di log del dispositivo correnti da condividere con qualcuno. Quando ricevi una notifica che ti informa che la segnalazione di bug è pronta, toccala per condividerla.
• Modalità demo dell'interfaccia utente di sistema:semplifica la realizzazione di screenshot nitidi mostrando una barra di notifica generica preimpostata che non mostra notifiche o avvisi di batteria in esaurimento. Attiva modalità demo ti consente di modificare l'aspetto della barra di stato utilizzando adb i comandi della modalità demo. In alternativa, puoi utilizzare Mostra modalità demo per nascondere le notifiche e visualizzare una barra di stato preimpostata.
• Password di backup del computer:imposta una password di backup per poter utilizzare i comandi adb per eseguire il backup e il ripristino delle app e dei dati del dispositivo protetti da password.
• Resta attivo:imposta lo schermo in modo che rimanga attivo quando il dispositivo è collegato alla corrente.
• Attiva il log di analisi dell'interfaccia Host Controller (HCI) Bluetooth: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 e risolvere i problemi relativi alle informazioni.

Debug…

Le opzioni di debug consentono di configurare il debug on-device e di stabilire la comunicazione tra il dispositivo e il computer di sviluppo.

Abilita il debug USB, come mostrato nella figura 3, in modo che il tuo dispositivo Android possa comunicare con la macchina di sviluppo tramite Android Debug Bridge (adb). L'opzione Attendi debugger non sarà disponibile finché non utilizzi Seleziona app di debug per selezionare l'app di cui eseguire il debug. Se attivi l'opzione Attendi debugger, l'app selezionata attende l'attacco del debugger prima di eseguire.

Altre opzioni di debug sono:

• Salva i dati del logger in modo permanente sul dispositivo:seleziona il tipo di messaggi di log da memorizzare in modo permanente sul dispositivo. Le opzioni sono off, all, all but radio o only kernel.
• Seleziona l'app di geolocalizzazione simulata:utilizza questa opzione per simulare la posizione GPS del dispositivo per verificare se la tua app si comporta allo stesso modo in altre posizioni. Per utilizzare questa opzione, scarica e installa un'app di simulazione della posizione GPS.


Figura 4. Visualizza gli attributi.

• Attiva l'ispezione degli attributi della vista:salva le informazioni sugli attributi della 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 di Layout Inspector, come mostrato nella figura 4. Se questa opzione non è attivata, l'elemento Attributi non è disponibile.
• Attiva livelli debug GPU: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 di Vulkan su Android.

Reti

Le opzioni di networking consentono di configurare le impostazioni Wi-Fi e DHCP.

Tocca Seleziona configurazione USB per specificare in che modo vuoi che il computer identifichi il dispositivo. Come mostrato nella figura 5, puoi configurare i dispositivi solo per la ricarica, per trasferire file (MTP), per trasferire foto (PTP), per utilizzare la rete mobile sul PC (RNDIS) o per 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 regolare con precisione la riproduzione audio sul dispositivo, tocca e imposta le seguenti opzioni:

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

L'elenco seguente descrive altri modi per configurare il Wi-Fi e il DHCP:

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

Input

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

Attiva Posizione cursore per mostrare la posizione del cursore (tocco) sul dispositivo con una croce. Nella parte superiore dello schermo viene visualizzata una barra per monitorare le coordinate del mirino, come mostrato nella figura 6. Mentre sposti il puntatore, le coordinate nella barra tengono traccia della posizione del mirino e il percorso del puntatore viene tracciato sullo schermo.

Disegno

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

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

Altre opzioni di disegno sono:

• Forza direzione layout RTL: forza la direzione del layout dello schermo da destra verso sinistra (RTL) o da sinistra verso destra (predefinita).
• Scala animazione finestra:imposta la velocità di riproduzione dell'animazione della finestra in modo da poterne verificare il rendimento a velocità diverse. Una scala più bassa comporta una velocità maggiore.
• Scala animazione transizione:imposta la velocità di riproduzione dell'animazione transizione in modo da poterne verificare il funzionamento a velocità diverse. Una scala più bassa comporta una maggiore velocità.
• Simula display secondari:crea un display secondario come overlay sul dispositivo. Questo è utile quando supporti display aggiuntivi con l'API Presentation. Per ulteriori informazioni, consulta Display secondari.

Rendering con accelerazione hardware

Le opzioni di rendering con accelerazione hardware consentono di ottimizzare l'app per le 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:

• Disattivata (nessuna combinazione di colori simulata)
• Monocromatica (limita la combinazione di colori a nero, bianco e grigio)
• Deuteranomalìa (influisce sulla visualizzazione di rosso e verde)
• Protanomalìa (influisce sulla visualizzazione di rosso e verde)
• Tritanomalìa (influisce sulla visualizzazione del blu e del giallo)

Il protanomalia si riferisce alla daltonismo rosso-verde con debolezza nei colori rossi, mentre la deuteranomalia, mostrata nella Figura 8, si riferisce alla daltonismo rosso-verde con debolezza nei colori verdi.

Se acquisisci screenshot in uno spazio colore simulato, questi appaiono normali, come se non avessi modificato la combinazione di colori.

Ecco alcuni altri modi per sfruttare le opzioni basate sull'hardware:

• Imposta il rendering GPU:modifica il motore grafico Open GL predefinito in quello Open GL Skia.
• Forza rendering GPU: obbliga le app a utilizzare la GPU per i disegni 2D se sono state scritte senza rendering GPU per impostazione predefinita.
• Aggiornamenti visualizz. GPU:mostra tutti gli elementi sullo schermo disegnati con la GPU.
• Debug del sovradisegno della GPU: vengono visualizzati codici a colori sul dispositivo per consentirti di 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 Visualizzare l'overdraw della GPU.
• Esegui il debug delle operazioni di ritaglio non rettangolare:disattiva l'area di ritaglio sulla tela per creare aree della tela insolite (non rettangolari). Normalmente, l'area di ritaglio impedisce di disegnare elementi al di fuori dei confini dell'area di ritaglio 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 controllare costantemente la presenza di collisioni e clip per visualizzare un'immagine corretta. Il controllo utilizza molta potenza di elaborazione.

Contenuti multimediali

Imposta Disattiva routing audio USB su On per disattivare il routing automatico ai dispositivi audio esterni collegati a un computer tramite una porta USB. Il routing automatico può interferire con le app che supportano la tecnologia 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", pertanto 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

App

Le opzioni dell'app ti aiutano a capire come funziona la tua app sul dispositivo di destinazione.

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

Tocca Reimposta il limite di frequenza di ShortcutManager durante il test in modo che le app in background possano continuare a chiamare le API di scorciatoia finché non viene raggiunto di nuovo il limite di frequenza. Per ulteriori informazioni sulle scorciatoie e sui limiti di frequenza, consulta ShortcutManager.

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