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 presenta 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 pregresse della piattaforma Android e dell'IDE di Android Studio. Se è la prima volta che utilizzi Android, crea un'app utilizzando questo codelab. Per saperne di più sulle funzionalità di Android Studio, visita la pagina Meet 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 a 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 e 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 (Tiramisu) (livello API 33).

    Per chiudere SDK Manager, fai clic su OK.

Ora puoi eseguire la tua prima app su Wear OS.

Esegui un'app nell'emulatore

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

Configura un emulatore

Per configurare un emulatore in Android Studio, completa i seguenti passaggi:

  1. In SDK Manager, apri la scheda SDK Tools. Verifica di avere la versione più recente di Android Platform-Tools SDK.
  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 utilizzate al di fuori della Cina, seleziona il nome della release Tiramisù. Questa release è destinata ad Android 13.0 (Wear OS 4). Per le immagini di sistema utilizzate in Cina, seleziona il nome della release R. Questa release è destinata ad Android 11.0 (Wear OS 3). Fai clic su Avanti.

    Nota: le immagini di sistema per l'emulatore Wear OS includono notifiche relative a file e codice sorgente di terze parti. 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'uso 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 si avvia e apre l'app.
  3. Dopo qualche istante, nell'emulatore dovresti visualizzare il messaggio "Ciao...".

Prova l'audio Bluetooth utilizzando l'emulatore

Sulle immagini di sistema su cui è in esecuzione Wear OS 4 o versioni successive, l'emulatore supporta il Bluetooth emulato, che ti consente di testare l'audio Bluetooth per 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 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 sia librerie native a 32 bit sia a 64 bit.

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

Esegui un'app su un orologio fisico (facoltativo)

L'esecuzione e il debug della tua app su uno smartwatch ti consente 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 un orologio fisico, prepara il dispositivo per i test e poi connettilo alla macchina di sviluppo.

Prepara l'orologio per il 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 il tuo smartwatch è protetto da un PIN o da una sequenza, inseriscili quando richiesto.
  3. Nel menu Impostazioni, tocca Opzioni sviluppatore.
  4. Attiva l'opzione Debug ADB.

Connetti l'orologio 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.

Configurare una connessione wireless

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

Apri l'app sullo smartwatch.

  1. Vai a Esegui > Seleziona dispositivo. Scegli lo smartwatch che è connesso alla tua macchina.
  2. Nella barra degli strumenti di Android Studio, fai clic su Esegui . L'emulatore si avvia e apre l'app.
  3. Dopo qualche istante, sull'orologio dovrebbe essere visualizzato il messaggio "Ciao...".