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

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

Crea un'app Wear OS

Dopo aver scaricato e installato la versione più recente di Android Studio, completa la procedura guidata "nuovo progetto":

1. Apri Android Studio e vai su File > Nuovo > Nuovo progetto. Viene visualizzata la finestra Nuovo progetto.
2. Nel riquadro Modelli, seleziona Wear OS. Quindi, nel riquadro principale, seleziona Vuota l'app Wear.
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 e installa sia Android 11.0 ("R") (livello API 30) sia Android 13.0 (Tiramisù) (livello API 33).

   Nota: l'ultima versione stabile di Wear OS, Wear OS 3, è basata su Android 11. L'ultima versione di anteprima di Wear OS, Wear OS 4 Anteprima per sviluppatori, è basata su Android 13.

   Per chiudere SDK Manager, fai clic su OK.

Ora è tutto pronto per 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 richiede la connessione a un altro dispositivo per l'esecuzione.

Un'app Wear OS dovrebbe funzionare indipendentemente da un'app per telefono, offrendo agli utenti la maggiore flessibilità nella scelta dei telefoni. Se l'esperienza o la complessità della tua app richiede la connessione a un telefono, consulta la guida su come connettere l'orologio a un telefono.

Esegui un'app nell'emulatore

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

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

Configura un emulatore

Per configurare un emulatore in Android Studio, procedi nel seguente modo:

1. In SDK Manager, apri la scheda SDK Tools (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 procedura guidata Configurazione dispositivo virtuale.
4. Nel riquadro Categoria, seleziona Wear OS e scegli un profilo hardware, ad esempio Wear OS Small Round. Fai clic su Avanti.

5. Per le immagini di sistema, seleziona il nome della release R o Tiramisù. Queste release hanno come target rispettivamente Android 11.0 (Wear OS 3) e Android 13.0 (Anteprima per gli sviluppatori Wear OS 4). Fai clic su Avanti.

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

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

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 la tua app.
3. Dopo qualche istante, nell'emulatore dovrebbe essere visualizzato il messaggio "Ciao...".

Eseguire un'app su un orologio fisico (facoltativo)

L'esecuzione e il debug della tua app su un orologio vero e proprio ti consente di valutare meglio l'esperienza utente totale. Ciò è particolarmente importante se la tua app si basa su hardware specifico, come sensori o una GPU.

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

Prepara lo smartwatch per i test

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

1. Apri il menu Impostazioni sullo smartwatch.
2. Scorri fino in fondo al menu. Se non viene visualizzata alcuna voce Opzioni sviluppatore, completa i seguenti passaggi secondari. In caso contrario, vai al passaggio successivo.
   1. Tocca Sistema > Informazioni o Sistema > Informazioni > Versioni.
   2. Trova l'elemento Numero build e toccalo sette volte. Se l'orologio è protetto da un PIN o una sequenza, inseriscilo quando ti viene 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. Altre richiedono una connessione wireless.

Configurare una connessione cablata tramite USB

Collega l'orologio procedendo nel seguente modo:

1. Utilizzando un cavo USB, collega lo smartwatch alla macchina di sviluppo.
2. Sull'orologio, attiva Consenti sempre da questo computer, quindi tocca OK.

Configura una connessione wireless

Se l'orologio non ha una porta USB, scopri come connetterlo tramite Wi-Fi o Bluetooth.

Apri l'app sull'orologio

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 la tua app.
3. Dopo qualche istante, sullo smartwatch dovrebbe apparire il messaggio "Ciao...".