Creare ed eseguire un'app su Wear OS

Questa pagina fornisce una guida per creare la tua prima app per Wear OS utilizzando un modello di Android Studio. L'app mostra i diversi modi per visualizzare le informazioni a colpo d'occhio sui dispositivi Wear OS e introduce alcune best practice per lo sviluppo di app sulla piattaforma.

Questa guida si basa su alcune conoscenze pregresse della piattaforma Android e dell'IDE Android Studio. Se non hai mai utilizzato Android, crea un'app utilizzando questo codelab. Per scoprire di più sulle funzionalità di Android Studio, visita la pagina Scopri Android Studio.

Nota :per utilizzare le immagini di sistema più recenti disponibili per l'emulatore, installa Android Studio Hedgehog o versioni successive.

Creare un'app Wear OS

Dopo aver scaricato e installato l'ultima versione di Android Studio, completa la procedura guidata "Nuovo progetto":

1. Apri Android Studio, quindi vai a File > Nuovo > Nuovo progetto. Viene visualizzata la finestra Nuovo progetto.
2. Nel riquadro Modelli, seleziona Wear OS. Poi, nel riquadro principale, seleziona App Wear vuota.
3. Assegna un nome al progetto, quindi fai clic su Fine. Android Studio scarica le dipendenze necessarie e crea la versione iniziale del progetto.

4. Vai a Strumenti > SDK Manager, fai clic su Mostra dettagli pacchetto e installa i seguenti pacchetti:

   • Android 15.0 ("VanillaIceCream") (livello API 35-ext15), che include l'immagine di sistema Wear OS 5.1 ARM 64 v8a e l'immagine di sistema Wear OS 5.1 Intel x86 Atom_64.
   • Android 14.0 ("UpsideDownCake") (livello API 34), che include l'immagine di sistema Wear OS 5 ARM 64 v8a e l'immagine di sistema Wear OS 5 Intel x86 Atom_64.
   • Android 13.0 ("Tiramisu") (livello API 33), che include l'immagine di sistema Wear OS 4 ARM 64 v8a e l'immagine di sistema Wear OS 4 Intel x86 Atom_64.
   Nota: l'ultima versione stabile di Wear OS, Wear OS 5.1, è basata su Android 15.

   Per chiudere SDK Manager, fai clic su Ok.

Ora puoi eseguire la tua prima app su Wear OS.

Nota: per impostazione predefinita, la procedura guidata Nuovo progetto crea un'app Wear OS autonoma e indipendente che non deve connettersi a un altro dispositivo per essere eseguita.

Un'app Wear OS deve funzionare indipendentemente da un'app per smartphone, offrendo agli utenti la massima flessibilità nella scelta degli smartphone. Se l'esperienza o la complessità della tua app richiede la connessione a uno smartphone, consulta la guida su come collegare uno smartwatch a uno smartphone.

Eseguire un'app sull'emulatore

Il modo più semplice per eseguire la prima app Wear OS è configurare un emulatore.

Nota: se prevedi di rendere disponibili le tue app per Wear OS in Cina, visita anche la pagina Creare app per Wear OS per la Cina.

Configurare un emulatore

Per configurare un emulatore in Android Studio:

1. In SDK Manager, apri la scheda Strumenti SDK. Verifica di avere l'ultima versione di Android SDK Platform-Tools. Chiudi SDK Manager.
2. Vai a Strumenti > Gestione dispositivi.
3. Seleziona Crea (+). Viene visualizzata la procedura guidata Configurazione dispositivo virtuale.
4. Nel riquadro Categoria, seleziona Wear OS e scegli un profilo hardware, ad esempio Wear OS rotondo piccolo. Fai clic su Avanti.

5. Per le immagini di sistema utilizzate al di fuori della Cina, seleziona il nome della release UpsideDownCake. Questa release ha come target Android 14.0 (Wear OS 5). Per le immagini di sistema utilizzate in Cina, seleziona il nome della release R. Questa release è destinata ad Android 11.0 (Wear OS 3). Se non hai già installato un'immagine sistema Wear OS 5 che corrisponda alla definizione del tuo dispositivo, fai clic su Download accanto a Nome release per scaricarla. Fai clic su Avanti.

   Nota:le immagini di sistema per l'emulatore Wear OS includono avvisi relativi a file e codice sorgente di terze parti. Puoi visualizzare le informative di terze parti per un'immagine di sistema specifica aprendo il file NOTICE.txt, che si trova in una delle seguenti directory:

   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI per gli emulatori utilizzati al di fuori della Cina.
   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI per gli emulatori utilizzati in Cina.

6. Puoi mantenere il valore predefinito per tutte le impostazioni in questa schermata, a meno che non vuoi personalizzare l'emulatore. Fai clic su Fine.

Per ulteriori informazioni sull'utilizzo degli emulatori, consulta la guida su come eseguire app sull'emulatore Android.

Aprire l'app nell'emulatore

1. Vai a Esegui > Seleziona dispositivo. Scegli l'emulatore che hai appena creato.
2. Nella barra degli strumenti di Android Studio, fai clic su Esegui . L'emulatore si avvia e apre la tua app.
3. Dopo qualche istante, dovresti vedere il messaggio "Hello..." nell'emulatore.

Testare l'audio Bluetooth utilizzando l'emulatore

Nelle immagini di sistema che eseguono Wear OS 4 o versioni successive, l'emulatore supporta il Bluetooth emulato, che ti consente di testare l'audio Bluetooth in diversi casi d'uso.

Le immagini di sistema recenti supportano solo architetture a 64 bit

Le immagini di sistema dell'emulatore per Wear OS 4 e versioni successive supportano solo queste architetture a 64 bit: x86-64 e arm64-v8a. Se sai o sospetti che la tua app utilizzi codice nativo (non scritto nei linguaggi di programmazione Kotlin o Java), verifica che la tua app includa librerie native a 32 e 64 bit.

Scopri di più su come supportare le architetture a 64 bit.

(Facoltativo) Eseguire un'app su uno smartwatch fisico

L'esecuzione e il debug dell'app su uno smartwatch reale ti consentono di valutare meglio l'esperienza utente complessiva. Ciò è particolarmente importante se la tua app si basa su hardware specifico, come sensori o una GPU.

Per eseguire un'app su uno smartwatch fisico, prepara il dispositivo per il test, quindi collegalo alla macchina di sviluppo.

Preparare lo smartwatch per il test

Per preparare lo smartwatch al test, attiva il debug ADB completando i seguenti passaggi.

1. Sullo smartwatch, apri il menu Impostazioni.
2. Vai alla fine del menu. Se non viene visualizzato alcun elemento Opzioni sviluppatore, completa i seguenti passaggi secondari. In caso contrario, vai al passaggio successivo.
   1. Tocca Sistema > Informazioni o Sistema > Informazioni > Versioni.
   2. Individua la voce Numero build e toccala sette volte. Se lo smartwatch è protetto da un PIN o una sequenza, inseriscili quando richiesto.
3. Nel menu Impostazioni, tocca Opzioni sviluppatore.
4. Attiva l'opzione Debug ADB.

Connetti lo smartwatch alla macchina di sviluppo

Alcuni smartwatch ti consentono di connetterti tramite USB. Altri richiedono una connessione wireless.

Configurare una connessione cablata tramite USB

Collega lo smartwatch seguendo questi passaggi:

1. Connetti lo smartwatch alla macchina di sviluppo con un cavo USB.
2. Sullo smartwatch, attiva Consenti sempre da questo computer, quindi tocca Ok.

Configurare una connessione wireless

Se lo smartwatch non ha una porta USB, scopri come connetterlo tramite Wi-Fi o Bluetooth.

(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 (cablata). 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.

Apri l'app sullo smartwatch.

1. Vai a Esegui > Seleziona dispositivo. Scegli lo smartwatch collegato alla tua macchina.
2. Nella barra degli strumenti di Android Studio, fai clic su Esegui . L'emulatore si avvia e apre la tua app.
3. Dopo qualche istante, dovresti vedere il messaggio "Hello…" apparire sullo smartwatch.