Eseguire il debug di un'app Wear OS

Per eseguire il debug dell'app Wear OS su uno smartwatch fisico, connetti la macchina di sviluppo allo smartwatch tramite Wi-Fi o Bluetooth. In alternativa, se lo smartwatch ha una porta USB, collegalo tramite USB.

Puoi anche testare flussi di lavoro che si estendono su più dispositivi, ad esempio uno smartwatch e uno smartphone, se la tua app richiede questo supporto. Per scoprire di più su come configurare una connessione per i test, visita Connettere uno smartwatch a uno smartphone.

Nota: se non hai uno smartwatch fisico, puoi anche testare ed eseguire la tua app su un emulatore in Android Studio.

Aggiornare all'ultima versione di Wear OS

Per verificare che la tua app si comporti come previsto con l'ultimo software, controlla che sul dispositivo di test sia in esecuzione la versione più aggiornata di Wear OS supportata dal dispositivo.

Per verificare la disponibilità di un aggiornamento di sistema sul dispositivo di test:

1. Connetti il dispositivo a una rete Wi-Fi.
2. Inizia a ricaricare il dispositivo.
3. Attendi che la batteria del dispositivo si carichi al 50% o più.

4. Sul dispositivo di test, vai a Impostazioni > Sistema > Aggiornamenti di sistema.

   Se è disponibile un aggiornamento di sistema, verrà scaricato e installato sul dispositivo di test.

(Facoltativo) Installa una versione specifica di Wear OS

Se lo scenario di test della tua app dipende da una versione specifica di Wear OS, puoi installare un'immagine software sugli smartwatch che supportano una connessione dati USB. Ad esempio, puoi installare un'immagine di fabbrica o un'immagine OTA completa su un dispositivo Google Pixel Watch 3 o Google Pixel Watch 2.

Attivare le opzioni sviluppatore sullo smartwatch

Prima di poter eseguire il debug sullo smartwatch, attiva le opzioni sviluppatore. Dovrai farlo solo una volta. Le opzioni sviluppatore rimangono attive finché non le disattivi. Per attivare le opzioni sviluppatore:

1. Apri le Impostazioni dello smartwatch.
2. Tocca Sistema > Informazioni > Versioni.
3. Tocca sette volte la voce Numero build.
4. Viene visualizzato un messaggio che conferma che ora sei uno sviluppatore.

Debug tramite Wi-Fi

Prima di iniziare, attiva le opzioni sviluppatore sullo smartwatch come descritto in precedenza.

Connettere lo smartwatch a una rete Wi-Fi

1. Apri le Impostazioni dello smartwatch.
2. Tocca Connettività > Wi-Fi.
3. Scegli una rete e, se necessario, inserisci la password.

   Nota: lo smartwatch e la macchina di sviluppo devono essere connessi alla stessa rete. Non tutti i punti di accesso sono adatti. Potresti dover utilizzare un punto di accesso il cui firewall è configurato correttamente per supportare adb.

Attiva debug Wi-Fi

1. Apri le Impostazioni dello smartwatch.
2. Tocca Opzioni sviluppatore > Debug tramite Wi-Fi.
3. Dopo qualche istante, sullo schermo viene visualizzato l'indirizzo IP dello smartwatch, ad esempio 192.168.1.100. Ti servirà per il passaggio successivo, quindi prendine nota.

Accoppia il debugger allo smartwatch

1. Sul dispositivo Wear OS, trova le opzioni di debug wireless nelle impostazioni di sistema. Seleziona Accoppia nuovo dispositivo.
2. Prendi nota del codice di accoppiamento Wi-Fi e dell'indirizzo IP e della porta.
3. In una finestra del terminale sulla macchina di sviluppo, digita il seguente comando:

   adb pair IP_ADDRESS:PORT

4. Quando richiesto, inserisci il codice di accoppiamento Wi-Fi del passaggio 2. Il terminale indicherà se l'accoppiamento è andato a buon fine. Ad esempio:

   Enter pairing code: 123456
   Successfully paired to 192.168.1.100:5555
   

Connetti il debugger allo smartwatch

1. Collega lo smartwatch e la macchina di sviluppo alla stessa rete.

2. Connetti il debugger allo smartwatch utilizzando l'indirizzo IP e un numero di porta dello smartwatch. Ad esempio, se l'indirizzo IP è 192.168.1.100 e il numero di porta è 5555, il comando adb connect e la relativa risposta hanno il seguente aspetto:

   adb connect 192.168.1.100:5555
   connected to 192.168.1.100:5555
   

Lo smartwatch è ora connesso al debugger e puoi iniziare il debug. Invia comandi adb all'orologio utilizzando il flag -s, specificando l'indirizzo IP dell'orologio e il numero di porta:

adb -s 192.168.1.100:5555 <command>

Se non utilizzi l'emulatore e hai un solo dispositivo connesso per il debug, non devi specificare l'indirizzo:

adb <command>

Debug tramite Bluetooth

Nota: il debug Bluetooth funziona solo per gli orologi accoppiati ad Android con Wear OS 2.

Prima di iniziare, accoppia lo smartwatch e lo smartphone e attiva le opzioni sviluppatore sullo smartwatch come descritto in precedenza. Verifica che le opzioni sviluppatore siano attive sullo smartphone aprendo il menu Impostazioni e cercando Opzioni sviluppatore. Se necessario, attiva le opzioni sviluppatore sullo smartphone.

Attivare il debug USB sullo smartphone

1. Apri il menu Impostazioni dello smartphone.
2. Seleziona Opzioni sviluppatore e attiva Debug USB.

Attivare il debug ADB o Bluetooth sullo smartwatch

1. Apri il menu Impostazioni dello smartwatch.
2. Scorri fino a Opzioni sviluppatore.
3. Verifica che il debug ADB sia abilitato.
4. Attiva Debug tramite Bluetooth.

Attivare il debug Bluetooth sullo smartphone

1. Apri l'app complementare Wear OS sullo smartphone.
2. Scorri fino a Impostazioni avanzate e tocca per visualizzare le opzioni Impostazioni avanzate.
3. Attiva Debug tramite Bluetooth. Sotto l'opzione viene visualizzato il seguente messaggio di stato:

   Host: disconnected
   Target: connected
   

A questo punto, la macchina di sviluppo, ovvero l'host, non comunica con lo smartwatch, ovvero il target. Devi completare il link.

Nota: puoi eseguire il debug con un solo dispositivo alla volta. Se hai associato più smartwatch, il debug Bluetooth viene attivato solo con il dispositivo selezionato nella schermata principale.

Connetti il debugger allo smartwatch

In questo passaggio finale, utilizzi tutto: il debugger, lo smartphone e lo smartwatch.

1. Collega lo smartphone alla macchina di sviluppo con un cavo USB.
2. Esegui questi due comandi nel debugger:

   adb forward tcp:4444 localabstract:/adb-hub
   adb connect 127.0.0.1:4444
   

   Nota: devi utilizzare l'indirizzo IP 127.0.0.1. Utilizza una porta disponibile sul computer di sviluppo e utilizza la stessa porta in entrambi i comandi. In questo esempio, la porta è 4444.

3. Dopo aver inserito il comando di connessione, lo smartwatch ti chiede di confermare che stai consentendo il debug ADB.
4. Sullo smartphone, controlla la visualizzazione dello stato nell'app complementare Wear OS per quanto segue:

   Host: connected
   Target: connected
   

Lo smartwatch è ora connesso al debugger e puoi iniziare il debug.

Quando esegui il debug di uno smartwatch utilizzando il Bluetooth, adb utilizza sempre l'indirizzo IP 127.0.0.1 più la porta che assegni. In questo esempio, la porta è 4444. Tutti i comandi adb utilizzano il seguente formato:

adb -s 127.0.0.1:4444 <command> 

Se non utilizzi l'emulatore e hai un solo dispositivo connesso per il debug, non devi specificare l'indirizzo:

adb <command>