Presentare e distribuire app Wear

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

Piano per il Play Store

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

Per fare in modo che la tua app venga visualizzata nel Play Store sull'orologio, carica l'APK (Android Package Kit) dello smartwatch in Play Console proprio come faresti con qualsiasi altro APK. Se hai soltanto un APK per orologio e nessun APK per smartphone, non sono necessari altri passaggi.

Se hai un APK per telefono oltre a un APK per orologio, devi utilizzare il metodo di pubblicazione con APK multipli.

Distribuzione agli orologi Wear

Sui dispositivi con Wear OS, quando un utente installa un'app per telefono a cui è associata un'app dell'orologio, riceve una notifica dell'orologio relativa all'app dell'orologio disponibile. Toccando la notifica si apre il Play Store dello smartwatch, offrendo all'utente la possibilità di installare l'app dell'orologio.

Quando carichi l'APK di un orologio tramite Play Console, puoi aggiornarlo indipendentemente dall'APK del telefono. I tuoi utenti ricevono gli aggiornamenti tramite il Play Store dello smartwatch. Quando esegui il push di 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.

Specifica un codice di versione

Il codice di versione di un APK per smartwatch deve essere univoco per tutti i fattori di forma. Lo schema del codice di versione può essere indipendente dallo schema dell'APK di un telefono.

Se l'APK Wear e l'APK companion 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 Utilizzo di uno schema di codice di versione.

Ecco uno schema del codice di versione suggerito:

  • Imposta le prime due cifre del codice 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 release, ad esempio 01.
  • Prenota le ultime due cifre per una variante con più APK, ad esempio 00.

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

Per maggiori informazioni, consulta la sezione 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 ha l'impostazione uses-feature mostrata nel seguente esempio, Google Play fornisce l'APK solo alle visualizzazioni:

<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, ad esempio versione dell'SDK, risoluzione dello schermo e architettura della CPU. In questo modo, APK Wear diversi possono avere come target configurazioni hardware diverse.

Specificare l'impostazione autonoma di un'app

Wear richiede un elemento meta-data nel file manifest di Android delle app dell'orologio, in quanto elemento secondario dell'elemento <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 uno smartphone e le sue funzioni 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 telefono. Consulta la pagina App per Wear OS autonome e non per maggiori informazioni su come dichiarare l'impostazione autonoma e per ulteriori indicazioni sulla classificazione delle app sull'orologio.

Nota: se la tua app Wear è corredata di un'app per telefono, devi utilizzare lo stesso nome di pacchetto per le due app.

Usare Play Console

Puoi usare Play Console per caricare un APK Wear autonomo nella scheda di un'app.

Per ulteriori informazioni, consulta le pagine Supporto di più APK e Gestire l'app. Assicurati che l'APK sia firmato prima di caricarlo.

Carica e pubblica l'APK

Il caricamento e la pubblicazione dell'APK Wear tramite Play Console segue una procedura simile a quella degli APK per dispositivi mobili. Tuttavia, devi attivare 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 Wear OS e menziona Wear OS nella scheda del Google Play Store dell'app. Per ulteriori informazioni, consulta la sezione Distribuzione su Wear OS.

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

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

Non menziona "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 effettivo 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 per dispositivi mobili e può essere eseguita da Android Studio. Sono disponibili diverse skin per gli screenshot per Wear.

Formato non adatto ai display rotondi

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

Testa l'app su un emulatore o un dispositivo rotondo per assicurarti che i layout vengano visualizzati correttamente. Utilizza i layout Wear OS inclusi nello strumento Controllo layout in Android Studio. Per ulteriori informazioni, consulta Aprire Controllo layout.

Mancano requisiti relativi alla funzionalità

Un requisito di funzionalità mancante è comune quando le notifiche non vengono migliorate per Wear. Assicurati di seguire le norme sulla qualità delle app Wear OS e consenti agli utenti di rispondere utilizzando RemoteInput per le app di messaggistica.