Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire il debug di un'app Wear OS

Per eseguire il debug della tua app Wear OS su un orologio fisico, connetti la macchina di sviluppo all'orologio tramite Wi-Fi o Bluetooth. In alternativa, se l'orologio ha una porta USB, connettiti tramite USB.

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

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

Esegui l'aggiornamento all'ultima versione di Wear OS

Per verificare che la tua app funzioni come previsto sul software più recente, controlla che sul dispositivo di test sia in esecuzione la versione di Wear OS più aggiornata supportata dal tuo dispositivo.

Per verificare la disponibilità di un aggiornamento di sistema sul dispositivo di test, segui questi passaggi:

Collega il dispositivo a una rete Wi-Fi.
Inizia a ricaricare il dispositivo.
Attendi che la batteria del dispositivo si carichi almeno al 50%.
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 eseguire il flashing di un'immagine software su smartwatch che supportano una connessione dati USB. Ad esempio, puoi eseguire il flashing di un'immagine di fabbrica o di un'immagine OTA completa su Google Pixel Watch 2.

Attiva le Opzioni sviluppatore sull'orologio

Per poter eseguire il debug sull'orologio, devi prima attivare le Opzioni sviluppatore. Devi eseguire questa operazione una sola volta. Le opzioni sviluppatore rimangono attive finché non le disattivi. Per attivare le opzioni sviluppatore:

Apri le Impostazioni dello smartwatch.
Tocca Sistema > Informazioni > Versioni.
Tocca l'elemento Numero build sette volte.
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

Apri le Impostazioni dello smartwatch.
Tocca Connettività > Wi-Fi.
Scegli una rete e inserisci la relativa password, se necessario.
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

Apri le Impostazioni dello smartwatch.
Tocca Opzioni sviluppatore > Debug tramite Wi-Fi.
Dopo un istante, sullo schermo viene visualizzato l'indirizzo IP dello smartwatch, ad esempio 192.168.1.100. Nel prossimo passaggio ti serve, quindi prendine nota.

Accoppia il debugger allo smartwatch

Sul tuo dispositivo Wear OS, trova le opzioni di debug wireless nelle impostazioni di sistema. Seleziona Accoppia nuovo dispositivo.
Prendi nota del codice di accoppiamento del Wi-Fi, nonché dell'indirizzo IP e della porta.
In una finestra del terminale sulla macchina di sviluppo, digita il seguente comando:
```
adb pair IP_ADDRESS:PORT
```
Quando richiesto, inserisci il codice di accoppiamento Wi-Fi del passaggio 2. Il terminale ti comunicherà se l'accoppiamento è riuscito. Ad esempio:
```
Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
```

Dopo l'accoppiamento, il computer host viene visualizzato nell'elenco di Dispositivi accoppiati nella schermata Debug wireless del dispositivo Wear OS.

Connetti il debugger allo smartwatch

Connetti il tuo smartwatch e il computer di sviluppo alla stessa rete.
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 sua risposta avranno 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 i comandi adb all'orologio utilizzando il flag -s, specificando l'indirizzo IP e il numero di porta dell'orologio:

adb -s 192.168.1.100:5555 <command>

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

adb <command>

Debug tramite Bluetooth

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

Prima di iniziare, accoppia lo smartwatch e lo smartphone e attiva le opzioni per sviluppatori sull'orologio come descritto in precedenza. Per verificare che le opzioni sviluppatore siano attive sullo smartphone, apri il menu Impostazioni dello smartphone e cerca Opzioni sviluppatore. Se necessario, attiva le opzioni sviluppatore sullo smartphone.

Attiva il debug USB sul telefono

Apri il menu Impostazioni del telefono.
Seleziona Opzioni sviluppatore e attiva Debug USB.

Attiva il debug ADB o Bluetooth sull'orologio

Apri il menu Impostazioni dello smartwatch.
Scorri fino a Opzioni sviluppatore.
Verifica che il debug ADB sia attivo.
Attiva Debug tramite Bluetooth.

Attiva il debug Bluetooth sullo smartphone

Apri l'app complementare Wear OS sullo smartphone.
Scorri fino a Impostazioni avanzate e tocca per visualizzare le opzioni di Impostazioni avanzate.
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 (l'host) non comunica con lo smartwatch, l'obiettivo. Devi completare il collegamento.

Nota: puoi eseguire il debug su un solo dispositivo alla volta. Se hai accoppiato più smartwatch, il debug Bluetooth è attivato solo con il dispositivo selezionato sulla schermata principale.

Connetti il debugger allo smartwatch

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

Collega il telefono alla macchina di sviluppo con un cavo USB.
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 qualsiasi porta disponibile sulla tua macchina di sviluppo e usa la stessa porta in entrambi i comandi. In questo esempio la porta è 4444.
Dopo aver inserito il comando di connessione, lo smartwatch ti chiede di confermare che stai consentendo il debug ADB.
Sullo smartphone, controlla la visualizzazione dello stato nell'app complementare Wear OS per verificare quanto segue:
```
Host: connected
Target: connected
```

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

Quando esegui il debug di un orologio tramite Bluetooth, adb utilizza sempre l'indirizzo IP 127.0.0.1 e la porta assegnata. 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 collegato un solo dispositivo per il debug, non devi specificare l'indirizzo:

adb <command>

Usa la registrazione dello schermo per Wear OS

Se sviluppi su macOS, puoi utilizzare il progetto GitHub strumento Android per Mac per registrare un video dal tuo dispositivo Wear OS.

In alternativa, registra un video dal dispositivo Wear OS svolgendo i seguenti passaggi:

Registra frame non elaborati sullo smartwatch:

adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

Copia il file non elaborato sulla macchina di sviluppo:
```
adb pull /sdcard/video.raw video.raw
```
Utilizza ffmpeg per convertire il file non elaborato in MP4:
```
ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4
```
Nota: consulta il sito web di FFmpeg per le istruzioni di download e installazione.

Fai riferimento alle seguenti risorse correlate: