Durante la creazione di app per Wear OS per la Cina, devi tenere conto degli smartphone senza Google Play sono preinstallati. Questa pagina contiene modifiche comuni che gli sviluppatori potrebbero dover adottare mercato cinese.
Utilizzare la versione corretta di Google Play Services
La versione 10.2.0 di Google Play Services fornisce supporto mondiale per l'API Fused Location Provider e l'API . API Livello dati. Devi usare questa versione di Google Play Services se usi queste API per garantire il supporto di una gamma più ampia di dispositivi Wear OS in Cina. In altri casi, questa dipendenza facoltativo.
Nota:anche se Google Play Services contiene
Le API per le app per Wear OS, le app per Wear OS per la Cina dovrebbero continuare a
utilizzare API relative a GoogleApiClient
; vedi
Accedi all'API Wearable.
API Fused Location Provider
Se utilizzi l'API Fused Location Provider, includi la seguente dipendenza
il file build.gradle
del tuo modulo Wear OS:
Alla moda
dependencies { ... implementation 'com.google.android.gms:play-services-location:10.2.0' }
Kotlin
dependencies { ... implementation("com.google.android.gms:play-services-location:10.2.0") }
API Data Layer
Se la tua app utilizza l'API Data Layer, devi aggiungere la seguente riga alla
build.gradle
file del tuo modulo Wear OS. La riga richiede l'utilizzo della versione 10.2.0 di
nella libreria client.
Alla moda
dependencies { ... implementation 'com.google.android.gms:play-services-wearable:10.2.0' ... }
Kotlin
dependencies { ... implementation("com.google.android.gms:play-services-wearable:10.2.0") ... }
Aggiungi la seguente riga al file build.gradle
di
modulo sul tuo dispositivo mobile. Sostituisci la dipendenza di Google Play Services con un riferimento alla
Versione 10.2.0.
Alla moda
dependencies { ... implementation 'com.google.android.gms:play-services-wearable:10.2.0' }
Kotlin
dependencies { ... implementation("com.google.android.gms:play-services-wearable:10.2.0") }
Autenticazione
Prima di implementare l'autenticazione, esamina i tuoi casi d'uso per capire se l'autenticazione viene effettivamente necessaria. Ad esempio, per un'app che fornisce le previsioni meteo, probabilmente non è necessario all'accesso e quindi per l'autenticazione.
Se richiedi l'autenticazione, ti consigliamo di utilizzare Libreria Oauth AndroidX. Per questo è necessario utilizzare Concessione del codice di autorizzazione con PKCE. Puoi anche utilizzare uno degli altri metodi descritti in Autenticazione sugli indossabili. L'uso della libreria di supporto per dispositivi indossabili non è consigliato.
Per ulteriori informazioni, consulta Esempio di OAuth per Wear OS su GitHub.
Notifiche collegate
Le notifiche in modalità bridge non sono supportate in Cina. Le notifiche dello smartphone sono collegate a Wear OS solo se il dispositivo Wear OS è connesso al telefono tramite Bluetooth.
Compatibilità di località e coordinate di mappatura
Utilizza la
FusedLocationProvider
(FLP) per rilevare la posizione dell'utente in Cina, come si farebbe
per il resto del mondo. In questo modo ti assicuri che la tua app tenga conto delle migliori informazioni
a prescindere dall'hardware e dalla piattaforma dello smartphone a cui è associato.
L'utilizzo dell'FLP aggiunge anche l'ottimizzazione della batteria integrata nella piattaforma Wear OS.
Quando integri FusedLocationProvider
con SDK per le mappe di terze parti,
prendono in considerazione la compatibilità delle coordinate tra i provider.
FusedLocationProvider
segnala la località in base a
Standard WGS84.
Assicurati di convertire i sistemi di coordinate, se necessario.
Supporto di Google Fit
di Google Fit il contatore di passi accumulati, i minuti di movimento e i punti cardio sono supportati in Cina, con un massimo di sette giorni di storia. Puoi accedere senza fornire una credenziale utente.
Supporto per Azioni vocali
La piattaforma Wear OS fornisce diversi intent vocali basati sulle azioni dell'utente, ad esempio _"Mostra battito cardiaco"_ o _"Imposta una sveglia"_. In questo modo gli utenti possono dire cosa vogliono fare e il sistema a capire qual è l'attività migliore da iniziare.
Quando gli utenti pronunciano un'azione vocale, la tua app può filtrare in base all'intent che viene attivato per avviare
attività. Per avviare un servizio in background, mostra un'attività come suggerimento visivo e avvia la
servizio nell'attività. Assicurati di chiamare
finish()
per eliminare il segnale visivo.
Di seguito è riportato un elenco degli intent vocali supportati dalla piattaforma Wear OS:
Categoria | Esempio | Specifiche di intent |
Chiamate in auto | 打车去三里屯 | Azione
Extra
L'extra è facoltativo. |
Imposta sveglia | 设点的闹钟 | Azione
Extra
Questi extra sono facoltativi. Fornisci una di queste opzioni, entrambe o nessuna di queste. |
Imposta il timer | 设備三型钟的倒计时 | Azione
Extra
|
Avvia cronometro | 开始计时 | Azione
|
Iniziare o interrompere un giro in bici | 开始骑车 | Azione
Tipo MIME
Extra
|
Avviare o interrompere una corsa | 开始跑步 | Azione
Tipo MIME
Extra
|
Avviare o interrompere un esercizio | 开始锻炼 | Azione
Tipo MIME
Extra
|
Mostra battito cardiaco | 查看용率 | Azione
Tipo MIME
|
Mostra numero di passi | 查看步数 | Azione
Tipo MIME
|
Navigazione | 导航去三里屯 | Azione
Dati geo:latitudine,longitudine?q=融科资讯 impression型 |
L'assistente vocale può usare anche le estensioni Intenzioni comuni di Android per attivare determinati comportamenti, ove applicabile.
Supporto dell'emulatore
Puoi usare la versione cinese dell'immagine dell'emulatore Wear OS per testare le tue app. Questo è supportata da Android Studio 3.0 e versioni successive.
Per testare le tue app sulla versione cinese dell'emulatore, procedi nel seguente modo:
- Installa l'emulatore Android.
- Scarica le immagini per Wear OS per la Cina da SDK Manager. Utilizzare la versione per Wear OS 3.5 (livello API 30).
- Scegli l'immagine Wear OS per la Cina quando crei un profilo di visualizzazione di video.
- Esegui l'emulatore Wear OS per la Cina per lo sviluppo.
![](https://developer.android.com/static/wear/images/emulator-ch.png?authuser=8&hl=it)
![](https://developer.android.com/static/wear/images/emulator-screen.png?authuser=8&hl=it)
Figura 1. Esempi della versione cinese dell'emulatore Wear OS.
Questa versione dell'emulatore Wear OS include diverse app preinstallate:
- Modalità Ambient
- Contatti
- Google Scrittura a mano libera
- Google Play Services
- Servizi sanitari per Wear OS
- Riconoscimento hotword per dispositivi LE
- Pinyin
- Play Store (adattato per i dispositivi in Cina)
- Orologio da taschino
- TalkBack
- Quadranti (sia versioni analogiche che digitali)
- Servizi principali di Wear
Avviare un canale Bluetooth e Wi-Fi specifico dell'app
Wear OS instrada automaticamente le richieste di rete. Nella maggior parte dei casi, non c'è alcun requisito per aprire un canale Bluetooth e Wi-Fi specifico dell'app.
Se un'app richiede un canale Bluetooth e Wi-Fi specifico per l'app in Cina, la richiesta
in modo automatico. Viene invece visualizzata una finestra di dialogo
chiedendo conferma all'utente. Se l'utente conferma, il canale si apre. Ciò si verifica ogni
non solo al primo utilizzo. BluetoothAdapter.enable()
o
WifiManager.setEnabled(true)
è
chiamato.
Nota: per il targeting per app
Android 10 (livello API 29) o versioni successive per chiamare
WifiManager.setEnabled()
, deve essere un'app di sistema o un
controller dei criteri dei dispositivi (DPC).
Modalità di revisione delle autorizzazioni
In Cina, i dispositivi Wear OS per la Cina funzionano in modalità di revisione delle autorizzazioni, che
impone alcuni limiti sulle modalità di utilizzo delle app con un valore targetApiLevel
inferiore a 23. Esamina i seguenti limiti:
- Anche se le autorizzazioni vengono concesse al momento dell'installazione, quando un'app con un
targetApiLevel
inferiore a 23 inizia per la prima volta, viene visualizzata una finestra di dialogo che chiede all'utente di confermare le autorizzazioni per questa app. - Componenti dell'app, ad esempio broadcast receiver, servizi e attività non rispondono agli eventi corrispondenti prima che l'app venga usata per la prima volta.
Di conseguenza, ti consigliamo di usare targetApiLevel
23 o versioni successive
e adottare
autorizzazioni app
di Google Cloud.
Utilizzare altre API Google Play Services
Se la tua app utilizza API Google Play Services diverse dall'API Wearable, la tua app deve verificare se queste API possono essere usate durante il runtime e rispondono in modo appropriato. Esistono due modi per verificare la disponibilità delle API di Google Play Services:
- Utilizza un'istanza
GoogleApiClient
separata per connetterti ad altre API. Questa interfaccia contiene callback per avvisa la tua app dello operazione riuscita o errore della connessione. In caso di connessione non riuscita,ConnectionResult
mostraAPI_UNAVAILABLE
. Per informazioni su come gestire gli errori di connessione, consulta Accedi alle API di Google. - Utilizza la
addApiIfAvailable()
diGoogleApiClient.Builder
per connetterti alle API richieste. Dopo il Viene attivato il callbackonConnected()
, utilizzahasConnectedApi()
per garantire che ciascuna delle API richieste sia connessa correttamente.
Distribuire app in Cina
Per raggiungere efficacemente gli utenti di Wear OS per la Cina, puoi distribuire tramite store per Wear OS di terze parti come i seguenti:
- Galaxy Store per dispositivi Samsung
- Store Xiaomi per dispositivi Xiaomi
- Mobvoi per tutti gli altri dispositivi