Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire il debug di un'app Wear OS

Per eseguire il debug dell'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, collegalo tramite USB.

Puoi anche testare flussi di lavoro che coprono più dispositivi, ad esempio un orologio 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 un orologio a un telefono.

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 più aggiornata di Wear OS 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 caricare 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, questo verrà scaricato e installato sul dispositivo di test.

(Facoltativo) Installare 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 del 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 sullo smartwatch

Per poter eseguire il debug sullo smartwatch, devi attivare le Opzioni sviluppatore. Devi eseguire questa operazione una sola volta. Le Opzioni sviluppatore rimangono attive finché non le disabiliti. Per attivare le Opzioni sviluppatore, procedi nel seguente modo:

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.

Collega 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: l'orologio e la macchina di sviluppo devono essere connessi alla stessa rete. Non tutti i punti di accesso sono adatti. Potrebbe essere necessario utilizzare un punto di accesso il cui firewall sia 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. Prendi nota di questa informazione nel prossimo passaggio.

Connessione del debugger all'orologio

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 relativa 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 sei pronto per 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 accoppiati Android con Wear OS 2.

Prima di iniziare, accoppia l'orologio e lo smartphone e attiva le opzioni sviluppatore sull'orologio come descritto in precedenza. Verifica che le opzioni sviluppatore siano attive sul telefono aprendo il menu Impostazioni dello smartphone e cercando Opzioni sviluppatore. Se necessario, attiva le opzioni sviluppatore sul telefono.

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 sullo smartwatch

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 sul telefono

Apri l'app complementare Wear OS sul telefono.
Scorri fino a Impostazioni avanzate e tocca per visualizzare le opzioni di Impostazioni avanzate.
Attiva il 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, ovvero la destinazione. Devi completare il collegamento.

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

Connessione del debugger all'orologio

In questo passaggio finale, utilizzerai tutto: il debugger, il telefono e l'orologio.

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. Usa 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.
Sul telefono, 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 un orologio tramite Bluetooth, adb utilizza sempre l'indirizzo IP 127.0.0.1 più la porta che hai assegnato. 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 procedendo nel seguente modo:

Registra fotogrammi non elaborati sullo smartwatch:

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

Copia il file non elaborato nella 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: fai riferimento al sito web FFmpeg per le istruzioni di download e installazione.

Consulta le seguenti risorse correlate: