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 rapidamente le informazioni sui dispositivi Wear OS e introduce alcune best practice per lo sviluppo di app sulla piattaforma.

Questa guida si basa su alcune conoscenze preliminari sulla piattaforma Android e sull'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 per 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. Quindi, nel riquadro principale, seleziona Svuota app Wear.
3. Assegna un nome al progetto e fai clic su Fine. Android Studio scarica le dipendenze necessarie e compila la versione iniziale del progetto.

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

   • Android 15.0 ("VanillaIceCream") (livello API 35-ext15), che include Wear OS 5.1 ARM 64 v8a System Image e Wear OS 5.1 Intel x86 Atom_64 System Image.
   • Android 14.0 ("UpsideDownCake") (livello API 34), che include la Wear OS 5 ARM 64 v8a System Image e la Wear OS 5 Intel x86 Atom_64 System Image.
   • Android 13.0 ("Tiramisu") (livello API 33), che include la System Image Wear OS 4 ARM 64 v8a e la System Image Wear OS 4 Intel x86 Atom_64.
   Nota: la versione stabile più recente 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 funzionare.

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

Esegui un'app sull'emulatore

Il modo più semplice per eseguire la tua prima app per 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 la versione più recente di Android SDK Platform-Tools.
2. Vai a Strumenti > Gestione dispositivi.
3. Seleziona Crea (+). Viene visualizzata la configurazione guidata Virtual Device Configuration (Configurazione dispositivo virtuale).
4. Nel riquadro Categoria, seleziona Wear OS e scegli un profilo hardware, come 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 è rivolta ad Android 11.0 (Wear OS 3). Se non hai già installato un'immagine di sistema Wear OS 5 corrispondente alla definizione del tuo dispositivo, fai clic su Scarica accanto al Nome release per scaricarla. Fai clic su Avanti.

   Nota:le immagini di sistema per l'emulatore Wear OS includono notifiche di file e codice sorgente di terze parti. Puoi visualizzare le notifiche di terze parti per una determinata immagine di sistema 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 voglia personalizzare l'emulatore. Fai clic su Fine.

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

Apri l'app nell'emulatore

1. Vai a Esegui > Seleziona dispositivo. Scegli l'emulatore appena creato.
2. Nella barra degli strumenti di Android Studio, fai clic su Esegui . L'emulatore avvia e apre l'app.
3. Dopo alcuni istanti, dovresti vedere il messaggio "Un saluto da…" 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 simulato, che ti consente di testare l'audio Bluetooth in diversi casi d'uso.

Le immagini di sistema recenti supportano solo le 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 includa librerie native sia a 32 che a 64 bit.

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

(Facoltativo) Eseguire un'app su uno smartwatch

Eseguire ed eseguire il debug dell'app su uno smartwatch reale ti consente di valutare meglio l'esperienza utente complessiva. Questo è 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 i test, quindi connettilo alla tua macchina di sviluppo.

Preparare lo smartwatch per i test

Per preparare lo smartwatch per i 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 l'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 l'elemento Numero build e toccalo sette volte. Se lo smartwatch è protetto da un PIN o una sequenza, inseriscilo quando richiesto.
3. Nel menu Impostazioni, tocca Opzioni sviluppatore.
4. Attiva l'opzione Debug ADB.

Collega lo smartwatch alla macchina di sviluppo

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

Configurare una connessione cablata tramite USB

Per connettere lo smartwatch:

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

Configurare una connessione wireless

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

(Facoltativo) Installa una versione specifica di Wear OS

Se il test case della tua app dipende da una versione specifica di Wear OS, puoi eseguire il flashing di un'immagine software sugli orologi che supportano una connessione dati USB (con cavo). Ad esempio, puoi eseguire il flashing di un'immagine di fabbrica o di un'immagine OTA completa su un dispositivo Google Pixel Watch 3 o Google Pixel Watch 2.

Aprire l'app sullo smartwatch

1. Vai a Esegui > Seleziona dispositivo. Scegli lo smartwatch connesso alla macchina.
2. Nella barra degli strumenti di Android Studio, fai clic su Esegui . L'emulatore avvia e apre l'app.
3. Dopo alcuni istanti, sullo smartwatch dovrebbe apparire il messaggio "Un saluto da…".