Presentare e distribuire app Wear

Con Wear OS, l'utente può visitare il Play Store da un orologio e scaricare un'app Wear direttamente lì. Inoltre, un utente può installare un'app direttamente sul proprio orologio utilizzando il Play Store basato sul web.

Piano per il Play Store

Non è possibile creare un singolo APK che funzioni sia su uno smartphone sia su un orologio.

Per mostrare la tua app nel Play Store sull'orologio, carica l'APK (Android Package Kit) dell'orologio in Play Console come faresti con qualsiasi altro APK. Se hai soltanto un APK per orologi e nessun APK per smartphone, non sono necessari altri passaggi.

Se hai un APK per smartphone oltre a un APK per orologi, devi utilizzare il metodo di pubblicazione dell'APK multiplo.

Distribuire su orologi Wear

Sui dispositivi con Wear OS, quando un utente installa un'app per smartphone a cui è associata un'app dell'orologio, riceve una notifica sull'orologio relativa all'app disponibile. Quando si tocca la notifica, si apre il Play Store dell'orologio, che offre all'utente la possibilità di installare l'app dell'orologio.

Se carichi un APK per orologi tramite Play Console, puoi aggiornare l'APK Wear indipendentemente dall'APK per smartphone. I tuoi utenti ricevono gli aggiornamenti tramite il Play Store dell'orologio. Quando trasferisci un aggiornamento a Play Console, l'app viene aggiornata automaticamente, a meno che l'utente non abbia disattivato gli aggiornamenti automatici nelle impostazioni del Play Store sull'orologio. Gli utenti possono anche aggiornare le app manualmente nel Play Store.

Specificare un codice di versione

Il codice di versione di un APK per orologi deve essere univoco per tutti i fattori di forma. Il suo schema di codice di versione può essere indipendente da quello di un APK per smartphone.

Se l'APK Wear e l'APK complementare condividono il codice e richiedono release coordinate, riserva le ultime due cifre del codice di versione per le varianti dell'APK. Un esempio di variante dell'APK è l'architettura della CPU; per un esempio, vedi Utilizzare uno schema di codice di versione.

Ecco uno schema di codice di versione suggerito:

  • Imposta le prime due cifre del codice di versione su targetSdkVersion, ad esempio 28.
  • Imposta le tre cifre successive sulla versione del prodotto, ad esempio 152 per una versione del prodotto 1.5.2.
  • Imposta le due cifre successive sul numero di build o di release, ad esempio 01.
  • Riserva le ultime due cifre per una variante dell'APK multiplo, ad esempio 00.

Ad esempio, i valori di esempio qui (28, 152, 01 e 00) generano un codice versione 281520100.

Per maggiori informazioni, vedi Impostare le informazioni sulla versione dell'app.

Configurare il targeting per un orologio

Nel file manifest Android, devi impostare l'elemento uses-feature su android.hardware.type.watch. Non impostare l'attributo required su false; la creazione di un singolo APK per dispositivi Wear e non Wear non è supportata.

Ad esempio, se un APK presenta l'impostazione uses-feature mostrata nell'esempio che segue, Google Play fornisce l'APK soltanto agli orologi:

<manifest package="com.example.standalone"
    xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-feature
        android:name="android.hardware.type.watch"/>
    ...
</manifest>

Combina l'impostazione android.hardware.type.watch nell'esempio di codice precedente con altri criteri, come la versione dell'SDK, la risoluzione dello schermo e l'architettura della CPU. In questo modo, diversi APK Wear possono avere come target configurazioni hardware diverse.

Specificare l'impostazione autonoma di un'app

Wear richiede un elemento meta-data nel file manifest Android delle app dell'orologio, come elemento secondario di <application>. Il nome dell'elemento meta-data è com.google.android.wearable.standalone e il valore deve essere true o false. L'elemento indica se l'app dell'orologio è un'app _standalone_, il che significa che è utilizzabile senza smartphone e le sue funzionalità di base, inclusa l'autenticazione, non richiedono un altro dispositivo.

Anche se il valore di com.google.android.wearable.standalone è false, l'app dell'orologio può essere installata prima dell'installazione dell'app per smartphone. Vedi App per Wear OS autonome e non autonome per maggiori informazioni sulla dichiarazione dell'impostazione autonoma e per ulteriori indicazioni sulla classificazione delle app dell'orologio.

Nota: se l'app Wear è associata a un'app per smartphone, devi utilizzare lo stesso nome di pacchetto per le due app.

Usare Play Console

Puoi utilizzare Play Console per caricare un APK Wear autonomo in una scheda dell'app.

Per maggiori informazioni, vedi Supporto di più APK e Gestire l'app. Assicurati che l'APK sia firmato prima di caricarlo.

Caricare e pubblicare l'APK

Il caricamento e la pubblicazione dell'APK Wear tramite Play Console segue una procedura simile a quella per gli APK per dispositivi mobili. Tuttavia, devi fare l'opt-in per Wear OS in Play Console, come descritto nei seguenti passaggi:

  1. In Play Console, vai a Configurazione e fai clic per aprire altre opzioni.
  2. Scegli Impostazioni avanzate, seleziona la scheda Fattori di forma e fai clic su Aggiungi fattore di forma.
  3. Fai clic su Wear OS.

Carica uno screenshot della tua app per Wear OS e menziona Wear OS nella scheda del Google Play Store dell'app. Per maggiori informazioni, vedi Distribuire su Wear OS.

Motivi principali per cui le app per Wear OS vengono rifiutate dal Play Store

Consulta l'elenco che segue per ridurre le probabilità che la tua app venga rifiutata dal Play Store. Inoltre, consulta la pagina Qualità delle app per Wear OS per assicurarti che la tua app sia conforme a queste linee guida.

Nessuna menzione di "Wear OS" nella scheda dello Store

Devi menzionare "Wear OS" nella scheda dello Store dell'app Wear o dell'orologio.

La funzionalità di base non funziona

Si tratta di una categoria generica, ma le app vengono rifiutate se non funzionano correttamente. Assicurati di testare accuratamente la tua app sull'emulatore e su un dispositivo fisico.

Inoltre, assicurati che gli screenshot dell'app riflettano l'aspetto reale dell'app. Se gli screenshot non sono accurati, l'app viene considerata "non funzionante come pubblicizzato" e viene rifiutata.

Nessuno screenshot di Wear

Devi includere uno screenshot di Wear. La procedura per acquisire uno screenshot è simile all'acquisizione di uno screenshot di un'app mobile e può essere eseguita da Android Studio. Sono disponibili diverse skin per Wear per gli screenshot.

Formato non adatto ai display rotondi

Assicurati di specificare nella descrizione del Play Store se l'app non supporta i display rotondi. Altrimenti, se il rendering del layout dell'app non viene eseguito correttamente su un display rotondo, l'app viene rifiutata.

Testa la tua app su un emulatore o un dispositivo rotondo per assicurarti che il rendering dei layout venga eseguito correttamente. Utilizza i layout Wear OS inclusi in Layout Inspector in Android Studio. Per maggiori informazioni, vedi Aprire Layout Inspector.

Mancano requisiti relativi alla funzionalità

Un requisito di funzionalità mancante viene comunemente segnalato quando le notifiche non vengono migliorate per Wear. Assicurati di rispettare le Norme sulla qualità delle app per Wear OS e consenti agli utenti di rispondere utilizzando RemoteInput per le app di messaggistica.