Beim Erstellen von Wear OS-Apps für China musst du auch Mobilgeräte ohne Google Play berücksichtigen -Dienste vorinstalliert. Diese Seite enthält häufige Änderungen, die Entwickler möglicherweise für auf dem chinesischen Markt.
Die richtige Version der Google Play-Dienste verwenden
Version 10.2.0 der Google Play-Dienste bietet weltweit Unterstützung für <ph type="x-smartling-placeholder"></ph> Fused Location Provider API und die <ph type="x-smartling-placeholder"></ph> Data Layer API. Sie müssen diese Version der Google Play-Dienste verwenden, wenn Sie diese APIs für Folgendes nutzen: die Unterstützung einer breiteren Palette von Wear OS-Geräten in China. In anderen Fällen ist diese Abhängigkeit optional.
Hinweis:Die Google Play-Dienste enthalten zwar
APIs für Wear OS-Apps sollten Wear OS-Apps für China weiterhin
APIs zu GoogleApiClient
verwenden; Siehe
<ph type="x-smartling-placeholder"></ph>
Auf die Wearable API zugreifen
Fused Location Provider API
Wenn Sie die Fused Location Provider API verwenden, fügen Sie die folgende Abhängigkeit in
der Datei build.gradle
Ihres Wear OS-Moduls:
Cool
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") }
Data Layer API
Wenn Ihre Anwendung die Data Layer API verwendet, müssen Sie die folgende Zeile zur
build.gradle
-Datei deines Wear OS-Moduls. In der Zeile muss die Version 10.2.0 von
der Clientbibliothek.
Cool
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") ... }
Fügen Sie die folgende Zeile in die Datei build.gradle
von
Ihres mobilen Moduls. Ersetzen Sie die Abhängigkeit der Google Play-Dienste durch einen Verweis auf die
Version 10.2.0.
Cool
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") }
Authentifizierung
Bevor Sie die Authentifizierung implementieren, prüfen Sie Ihre Anwendungsfälle, um festzustellen, ob die Authentifizierung tatsächlich erfolgt erforderlich. Bei einer App, die die Wettervorhersage liefert, werden wahrscheinlich keine und damit zur Authentifizierung.
Wenn eine Authentifizierung erforderlich ist, empfehlen wir die Verwendung des AndroidX-OAuth-Bibliothek Dazu müssen die Ablauf Autorisierungscode mit PKCE gewähren. Sie können auch eine der anderen Methoden verwenden, die in diesem Artikel beschrieben werden: Authentifizierung auf Wearables Die Verwendung der Wearable-Supportbibliothek wird nicht empfohlen.
Weitere Informationen finden Sie in der OAuth-Beispiel für Wear OS auf GitHub.
Überbrückte Benachrichtigungen
<ph type="x-smartling-placeholder"></ph> Überbrückte Benachrichtigungen werden in China nicht unterstützt. Smartphone-Benachrichtigungen sind überbrückt zu Wear OS nur, wenn das Wear OS-Gerät über Bluetooth mit dem Smartphone verbunden ist.
Kompatibilität von Standort und Kartenkoordinaten
Verwenden Sie die Methode
FusedLocationProvider
(FLP), um den Standort des Nutzers in China zu ermitteln,
für den Rest der Welt. So sorgen Sie dafür, dass Ihre App die besten Informationen berücksichtigt.
unabhängig von der Hardware der Smartwatch und der Smartphone-Plattform, mit der die Smartwatch gekoppelt ist.
Bei Verwendung der Funktion „FLP“ wird auch die Akkuoptimierung hinzugefügt, die in die Wear OS-Plattform integriert ist.
Wenn du FusedLocationProvider
in Karten-SDKs von Drittanbietern einbindest,
die Kompatibilität der Koordinaten zwischen den Anbietern berücksichtigen.
FusedLocationProvider
meldet den Standort entsprechend dem
WGS84-Standard.
Achten Sie darauf, die Koordinatensysteme gegebenenfalls umzuwandeln.
Google Fit-Support
von Google Fit Schrittzähler, Bewegungsminuten und Kardiopunkte werden in China unterstützt, wobei bis zu 7 Tage Geschichte. Sie können darauf zugreifen, ohne Nutzeranmeldedaten anzugeben.
Unterstützung der Sprachbedienung
Die Wear OS-Plattform bietet mehrere Sprach-Intents, die auf Nutzeraktionen basieren, z. B. „Show“. Herzfrequenz"_ oder _"Wecker stellen"_. So können Nutzende sagen, was sie tun möchten, und das System die beste Aktivität zu ermitteln.
Wenn Nutzer einen Sprachbefehl sagen, kann Ihre App nach dem Intent filtern, der ausgelöst wird, um einen
Aktivitäten. Wenn Sie einen Dienst im Hintergrund starten möchten, zeigen Sie eine Aktivität als visuellen Hinweis an und starten Sie den
in der Aktivität. Rufen Sie unbedingt
finish()
auf, um den visuellen Hinweis zu entfernen.
Die folgenden Sprach-Intents werden von der Wear OS-Plattform unterstützt:
Category | Beispiel | Intent-Spezifikation |
Autoanruf | Aktion
Extra
Der Zusatz ist optional. |
|
Wecker stellen | Aktion
Weitere Funktionen
Diese Extras sind optional. Geben Sie eines, beide oder keine dieser Extras an. |
|
Timer gestellt | Aktion
Weitere Funktionen
|
|
Stoppuhr starten | 开始计时 | Aktion
|
Fahrradtour starten oder beenden | 开始骑车 | Aktion
MIME-Typ
Weitere Funktionen
|
Lauf starten oder beenden | 开始跑步 | Aktion
MIME-Typ
Weitere Funktionen
|
Training starten oder beenden | 开始锻炼 | Aktion
MIME-Typ
Weitere Funktionen
|
Herzfrequenz anzeigen | ??? | Aktion
MIME-Typ
|
Schrittzahl anzeigen | 查看步数 | Aktion
MIME-Typ
|
Navigation | 导航去里屯 | Aktion
Daten geo:latitude,length?q=融科资讯丠 |
Der Sprachassistent kann auch Häufige Android-Intents bestimmte Verhaltensweisen auslösen.
Emulator-Unterstützung
Sie können zum Testen Ihrer Apps die chinesische Version des Wear OS-Emulator-Images verwenden. Dieses wird von Android Studio 3.0 und höher unterstützt.
So testen Sie Ihre Apps mit der chinesischen Version des Emulators:
- Android-Emulator installieren
- Lade die Wear OS for China-Images im SDK-Manager herunter. Version für Wear OS 3.5 verwenden (API-Level 30).
- Wähle beim Erstellen eines AVD-Profils das Wear OS for China-Image aus.
- Führen Sie zur Entwicklung den Emulator für Wear OS for China aus.
![](https://developer.android.com/static/wear/images/emulator-ch.png?authuser=9&hl=de)
![](https://developer.android.com/static/wear/images/emulator-screen.png?authuser=9&hl=de)
Abbildung 1: Beispiele für die chinesische Version des Wear OS-Emulators.
Diese Version des Wear OS-Emulators enthält mehrere vorinstallierte Apps:
- Umgebungsmodus
- Kontakte
- Google Handschrifteingabe
- Google Play-Dienste
- Gesundheitsdienste für Wear OS
- Hotword-Erkennung für LE-Geräte
- Pinyin
- Play Store (angepasst für Geräte in China)
- Taschenuhr
- TalkBack
- Zifferblätter (sowohl analoge als auch digitale Versionen)
- Wear-Hauptdienste
App-spezifischen Bluetooth- und WLAN-Kanal starten
Wear OS leitet Netzwerkanfragen automatisch weiter. In den meisten Fällen besteht keine damit die App einen App-spezifischen Bluetooth- und WLAN-Kanal öffnet.
Wenn eine App einen app-spezifischen Bluetooth- und WLAN-Kanal in China anfordert,
und schlägt stumm fehl. Stattdessen wird ein Dialogfeld
der Nutzer um Bestätigung bittet. Wenn der Nutzer dies bestätigt, wird der Kanal geöffnet. Das passiert jeweils
und nicht nur bei der ersten Verwendung. BluetoothAdapter.enable()
oder
WifiManager.setEnabled(true)
ist
aufgerufen.
Hinweis : Bei einer Ausrichtung auf eine App
Android 10 (API-Level 29) oder höher
WifiManager.setEnabled()
muss es sich um eine System-App oder eine
Device Policy Controller (DPC)
Berechtigungsprüfungsmodus
In China werden Wear OS-Geräte für China im Modus „Berechtigungsprüfung“ ausgeführt,
Es gelten einige Einschränkungen für die Verwendung von Apps mit einer targetApiLevel
unter 23. Überprüfen Sie die folgenden Limits:
- Auch wenn Berechtigungen zum Zeitpunkt der Installation gewährt werden, gilt: Wenn eine App mit einer
targetApiLevel
weniger als 23 Starts erreicht hat, wird ein Dialogfeld angezeigt, in dem Sie gefragt werden, Nutzer, um die Berechtigungen zu bestätigen für diese App. - Komponenten der App, z. B. Übertragungsempfänger, Dienste und Aktivitäten nicht auf entsprechende Ereignisse reagieren, bevor die App zum ersten Mal verwendet wird.
Daher empfehlen wir Ihnen, targetApiLevel
23 oder höher zu verwenden
und die
App-Berechtigungen
Best Practices.
Andere APIs für Google Play-Dienste verwenden
Wenn Ihre App verwendet Google Play Services APIs eine andere als die Wearable API verwenden, muss deine App prüfen, können diese APIs während der Laufzeit verwendet und entsprechend reagieren. Es gibt zwei Möglichkeiten, die Verfügbarkeit von Google Play-Dienst-APIs zu prüfen:
- Verwenden Sie eine separate
GoogleApiClient
-Instanz, um eine Verbindung zu anderen APIs herzustellen. Diese Schnittstelle enthält Rückrufe benachrichtigen Sie Ihre App über den Erfolg oder Fehler der Verbindung. Wenn die Verbindung fehlschlägt, zeigtConnectionResult
API_UNAVAILABLE
an. Informationen zum Umgang mit Verbindungsfehlern finden Sie unter . Auf Google APIs zugreifen - Verwenden Sie den
addApiIfAvailable()
.GoogleApiClient.Builder
-Methode, um eine Verbindung zu den erforderlichen APIs herzustellen. Nach demonConnected()
-Callback ausgelöst wird, verwenden Sie diehasConnectedApi()
, um sicherzustellen, dass alle angeforderten APIs korrekt verbunden sind.
Apps in China vertreiben
Wenn Sie Nutzer von Wear OS in China effektiv erreichen möchten, können Sie Ihre App über Wear OS-App-Shops von Drittanbietern wie die folgenden:
- <ph type="x-smartling-placeholder"></ph> Galaxy Store für Samsung-Geräte
- Xiaomi Store für Xiaomi-Geräte
- <ph type="x-smartling-placeholder"></ph> Mobvoi für alle anderen Geräte