Crea ed esegui la tua prima app per 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.

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 compila il progetto.

Ora puoi eseguire la tua prima app su Wear OS.

Eseguire un'app sull'emulatore

Un modo semplice per eseguire la tua app Wear OS è su un emulatore.

Configurare un emulatore

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

  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. A meno che tu non abbia bisogno di personalizzazioni specifiche, mantieni le impostazioni predefinite in questa schermata. Android Studio seleziona per impostazione predefinita l'ultima API e l'ultima immagine di sistema. 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. Nella barra degli strumenti principale, trova il widget Esegui. Nel menu a discesa del dispositivo, seleziona l'emulatore che hai creato e fai clic sul pulsante Esegui "Pulsante Corri" per avviare l'app.
  2. Dopo qualche istante, nell'emulatore viene visualizzato il messaggio "Hello…".

(Facoltativo) Eseguire un'app su uno smartwatch fisico

L'esecuzione e il debug dell'app su uno smartwatch fisico 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 i 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.

Per saperne di più, vedi Configurare le opzioni per sviluppatori sul dispositivo.

Connettere 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

Connetti 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 non è possibile eseguire il debug dello smartwatch tramite una porta USB, consulta Connettersi al dispositivo tramite Wi-Fi.

Apri l'app sullo smartwatch.

  1. Nel widget Esegui (parte della barra degli strumenti principale), utilizza il menu a discesa del dispositivo per selezionare il tuo dispositivo fisico.
  2. Fai clic sul pulsante Esegui "Pulsante Corri" nel widget Esegui.
  3. Dopo qualche istante, sul dispositivo viene visualizzato il messaggio "Hello…".

Pianificare l'architettura dell'app

Ora che hai un'app di base in esecuzione, puoi andare oltre il modello. Prima di iniziare ad aggiungere nuove funzionalità, è utile pensare alle decisioni architetturali chiave che daranno forma alla tua app. Le sezioni seguenti esplorano alcune domande importanti da considerare.

Modello di app: autonoma, non autonoma o ibrida

Considera quanto la tua app dipende da uno smartphone accoppiato:

  • Ibrido (consigliato per la maggior parte delle app): è l'approccio più comune e flessibile. Le funzionalità principali dell'app funzionano senza smartphone (ad esempio il monitoraggio di un allenamento), ma offre funzionalità avanzate quando uno smartphone è connesso, come la sincronizzazione dei dati o una configurazione più semplice.
  • Standalone:la tua app funziona completamente da sola, senza richiedere uno smartphone per le funzionalità di base. Questa opzione è ideale per le app che possono funzionare offline o utilizzare la propria connessione a internet. Il modello "Empty Wear App" crea un'app autonoma per impostazione predefinita.
  • Non autonoma:la tua app richiede uno smartphone per la sua funzionalità di base.

Per ulteriori informazioni e indicazioni su questa scelta, consulta App per Wear OS autonome e non autonome.

Creare l'interfaccia utente

Compose for Wear OS è un framework dichiarativo moderno che rappresenta il modo consigliato per creare UI per le app Wear OS. Il modello che hai utilizzato è creato con Compose, il che ti offre un ottimo punto di partenza.

Quando crei app con Compose, utilizza le librerie progettate specificamente per Wear OS. Questi forniscono componenti ottimizzati per gli smartwatch, essenziali per un'esperienza utente ottimale.

Ad esempio, anziché un LazyColumn standard, utilizza TransformingLazyColumn, che applica automaticamente effetti di scalabilità e trasparenza agli elementi sul bordo di uno schermo rotondo.

Analogamente, per la navigazione, utilizza SwipeDismissableNavHost dalla libreria di navigazione Wear OS per l'integrazione con il gesto di scorrimento per chiudere del sistema.

Archiviazione e sincronizzazione dei dati

Il modo in cui gestisci i dati è una scelta architettonica fondamentale. Per la persistenza sul dispositivo, le opzioni sono le stesse del mobile, con DataStore per i dati chiave-valore o gli oggetti digitati e Room per i dati strutturati più complessi, che sono le scelte moderne consigliate.

  • Memorizza prima i dati sul dispositivo:progetta la tua app in modo che sia offline-first, memorizzando i dati necessari direttamente sullo smartwatch in modo che rimanga funzionale senza una connessione allo smartphone.
  • Sincronizzare i dati con lo smartphone:quando devi sincronizzare o trasmettere in streaming dati (come le impostazioni utente o i dati di allenamento) con un'app per smartphone complementare, utilizza l'API Data Layer. Fornisce un canale di comunicazione che funziona tramite Bluetooth e Wi-Fi.

Gestire il lavoro a lunga esecuzione

Molte esperienze principali di Wear OS, come gli allenamenti o la riproduzione di contenuti multimediali, sono di lunga durata. È fondamentale gestire correttamente questo lavoro per mantenere l'affidabilità e preservare la batteria.

  • Per le attività di lunga durata avviate dall'utente:quando un utente avvia un'attività che deve continuare anche se esce dalla schermata (ad esempio il monitoraggio di una corsa), devi utilizzare un servizio in primo piano. Su Wear OS, associa questo servizio all'API Ongoing Activity. Vengono create una notifica persistente e un'icona toccabile sul quadrante, che consente all'utente di tornare alla tua app.
  • Per le attività in background differibili:per il lavoro che non deve essere eseguito immediatamente (come la sincronizzazione periodica dei dati), utilizza WorkManager. È consapevole della batteria e rispetta le ottimizzazioni del sistema come la modalità Doze, il che lo rende una buona scelta per l'elaborazione in background non urgente.

Vai oltre l'app: superfici e alimentazione

Infine, ricorda che l'esperienza Wear OS non si limita all'applicazione principale.

  • Supporta altre piattaforme: per creare un'app coinvolgente e di alta qualità, pianifica di supportare altre piattaforme ottimizzate per il polso. Valuta la possibilità di creare un riquadro per azioni rapide e informazioni e una complicazione per visualizzare dati importanti direttamente sul quadrante dell'utente.
  • Pianifica l'efficienza energetica: la durata della batteria è fondamentale su un dispositivo indossabile. Progetta la tua app in modo che sia efficiente dal punto di vista energetico fin dall'inizio. Ciò significa prestare attenzione a come recuperi i dati, utilizzi i sensori ed esegui le attività in background. Rimandare il lavoro fino a quando lo smartwatch non è in carica è spesso una buona strategia. Per saperne di più, consulta la guida al risparmio energetico.