Tworzenie aplikacji na Wear OS dla Chin

Podczas tworzenia aplikacji na Wear OS w Chinach musisz uwzględnić telefony bez zainstalowanych usług Google Play. Na tej stronie znajdziesz typowe zmiany, które deweloperzy mogą wprowadzić na potrzeby rynku chińskiego.

używać odpowiedniej wersji usług Google Play,

Usługi Google Play w wersji 10.2.0 zapewniają obsługę na całym świecie interfejsu Fused Location Provider API i  interfejsu Data Layer API. Jeśli używasz tych interfejsów API, musisz korzystać z tej wersji Usług Google Play, aby zapewnić obsługę większej liczby urządzeń z Wear OS w Chinach. W innych przypadkach ta zależność jest opcjonalna.

Uwaga: chociaż Usługi Google Play zawierają interfejsy API dla aplikacji na Wear OS, aplikacje na Wear OS w Chinach powinny nadal korzystać z interfejsów API związanych z GoogleApiClient. Więcej informacji znajdziesz w artykule Dostęp do interfejsu API Wearable.

Fused Location Provider API

Jeśli używasz interfejsu API dostawcy uśrednionej lokalizacji, dodaj do pliku build.gradle modułu Wear OS tę zależność:

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-location:10.2.0'
}

dependencies {
    ...
    implementation("com.google.android.gms:play-services-location:10.2.0")
}

Data Layer API

Jeśli Twoja aplikacja korzysta z interfejsu Data Layer API, musisz dodać ten wiersz do pliku build.gradle modułu Wear OS. Wymaga to użycia biblioteki klienta w wersji 10.2.0.

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
    ...
}

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
    ...
}

Dodaj ten wiersz do pliku build.gradle modułu mobilnego. Zastąp zależność od usług Google Play odwołaniem do wersji 10.2.0.

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
}

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
}

Uwierzytelnianie

Zanim wdrożysz uwierzytelnianie, sprawdź przypadki użycia, aby dowiedzieć się, czy jest ono rzeczywiście potrzebne. Na przykład w przypadku aplikacji dostarczającej prognozę pogody prawdopodobnie nie ma potrzeby logowania się, a tym samym uwierzytelniania.

Jeśli uwierzytelnianie jest wymagane, zalecamy użycie biblioteki AndroidX OAuth 2.0. Wymaga to użycia przepływu przyznawania kodu autoryzacji z PKCE. Możesz też użyć jednej z innych metod opisanych w sekcji Uwierzytelnianie na urządzeniach do noszenia. Nie zalecamy korzystania z biblioteki pomocy Wearable.

Więcej informacji znajdziesz w przykładowym kodzie OAuth na Wear OS w GitHubie.

Połączone powiadomienia

Powiadomienia pomostowe nie są obsługiwane w Chinach. Powiadomienia z telefonu są przekazywane na Wear OS tylko wtedy, gdy urządzenie z Wear OS jest połączone z telefonem przez Bluetooth.

Zgodność lokalizacji i współrzędnych mapowania

Użyj FusedLocationProvider (FLP), aby wykryć lokalizację użytkownika w Chinach, tak jak w przypadku reszty świata. Dzięki temu aplikacja będzie uwzględniać najlepsze informacje niezależnie od sprzętu zegarka i platformy telefonu, z którym jest on sparowany. Korzystanie z FLP zapewnia też optymalizację baterii wbudowaną w platformę Wear OS.

Podczas integrowania FusedLocationProvider z pakietami SDK map innych firm weź pod uwagę zgodność współrzędnych między dostawcami. FusedLocationProvider podaje lokalizację zgodnie ze standardem WGS84. W razie potrzeby przekonwertuj systemy współrzędnych.

Zespół pomocy Google Fit

W Chinach obsługiwane są licznik kroków, minuty ruchu i punkty kardio w Google Fit, z historią do 7 dni. Możesz uzyskać do niego dostęp bez podawania danych logowania.

Obsługa komend głosowych

Platforma Wear OS udostępnia kilka intencji głosowych opartych na działaniach użytkownika, takich jak „Pokaż tętno” lub „Ustaw alarm”. Dzięki temu użytkownicy mogą powiedzieć, co chcą zrobić, a system może wybrać najlepsze działanie do rozpoczęcia.

Gdy użytkownicy wypowiadają działanie głosowe, aplikacja może filtrować intencję, która jest uruchamiana w celu rozpoczęcia aktywności. Aby uruchomić usługę w tle, wyświetl aktywność jako wskazówkę wizualną i uruchom usługę w aktywności. Aby pozbyć się wskazówki wizualnej, wywołaj funkcję finish().

Oto lista intencji głosowych obsługiwanych przez platformę Wear OS:

Asystent głosowy może też używać istniejących zamiarów wspólnych Androida, aby w odpowiednich przypadkach wywoływać określone zachowania.

Obsługa emulatora

Do testowania aplikacji możesz używać chińskiej wersji obrazu emulatora Wear OS. Ta funkcja jest obsługiwana przez Androida Studio w wersji 3.0 i nowszej.

Aby przetestować aplikacje w chińskiej wersji emulatora, wykonaj te czynności:

1. Zainstaluj Android Emulator.
2. Pobierz obrazy Wear OS na rynek chiński z menedżera pakietu SDK. Używaj wersji na Wear OS 3.5 (poziom interfejsu API 30).
3. Podczas tworzenia profilu AVD wybierz obraz Wear OS w wersji na Chiny.
4. Uruchom emulator Wear OS w Chinach na potrzeby programowania.


Rysunek 1. Przykłady chińskiej wersji emulatora Wear OS.

Ta wersja emulatora Wear OS ma kilka wstępnie zainstalowanych aplikacji:

• Dźwięki otoczenia
• Kontakty
• Klawiatura Google – pismo odręczne
• Usługi Google Play
• Funkcje dotyczące zdrowia na Wear OS
• Rozpoznawanie słów kluczowych na urządzeniach LE
• Pinyin
• Sklep Play (dostosowany do urządzeń w Chinach)
• Zegarek kieszonkowy
• TalkBack
• Tarcze zegarka (wersje analogowe i cyfrowe)
• Usługi podstawowe Wear

Uruchamianie kanału Bluetooth i Wi-Fi w konkretnej aplikacji

Wear OS automatycznie kieruje żądania sieciowe. W większości przypadków nie ma wymogu, aby aplikacja otwierała kanał Bluetooth i Wi-Fi specyficzny dla aplikacji.

Jeśli aplikacja poprosi o kanał Bluetooth i Wi-Fi w Chinach, żądanie zakończy się niepowodzeniem bez powiadomienia. Zamiast tego wyświetla się okno dialogowe z prośbą o potwierdzenie. Jeśli użytkownik potwierdzi, kanał zostanie otwarty. Dzieje się tak za każdym razem, a nie tylko przy pierwszym użyciu. BluetoothAdapter.enable() lub WifiManager.setEnabled(true).

Uwaga: aby aplikacja kierowana na Androida 10 (poziom 29 interfejsu API) lub nowszego mogła wywoływać funkcję WifiManager.setEnabled(), musi być aplikacją systemową lub kontrolerem zasad dotyczących urządzeń (DPC).

Tryb sprawdzania uprawnień

W Chinach urządzenia z Wear OS działają w trybie sprawdzania uprawnień, który nakłada pewne ograniczenia na korzystanie z aplikacji z targetApiLevel poniżej 23. Sprawdź te limity:

• Mimo że uprawnienia są przyznawane podczas instalacji, gdy aplikacja z targetApiLevelniższym niż 23 poziomem interfejsu API zostanie uruchomiona po raz pierwszy, pojawi się okno z prośbą o potwierdzenie uprawnień dla tej aplikacji.
• Komponenty w aplikacji, takie jak odbiorniki transmisji, usługi i aktywności, nie reagują na odpowiednie zdarzenia, dopóki aplikacja nie zostanie użyta po raz pierwszy.

Dlatego zalecamy korzystanie z targetApiLevel w wersji 23 lub nowszej oraz stosowanie sprawdzonych metod dotyczących uprawnień aplikacji.

Korzystanie z innych interfejsów API Usług Google Play

Jeśli aplikacja korzysta z  interfejsów API Usług Google Play innych niż Wearable API, musi sprawdzać, czy te interfejsy API są dostępne do użycia w czasie działania, i odpowiednio reagować. Dostępność interfejsów API usług Google Play możesz sprawdzić na 2 sposoby:

1. Do łączenia się z innymi interfejsami API używaj osobnej instancji GoogleApiClient. Ten interfejs zawiera wywołania zwrotne, które powiadamiają aplikację o  powodzeniu lub niepowodzeniu połączenia. Jeśli nie uda się nawiązać połączenia, ikona ConnectionResult zmieni się na API_UNAVAILABLE. Aby dowiedzieć się, jak radzić sobie z błędami połączenia, przeczytaj artykuł Uzyskiwanie dostępu do interfejsów API Google.
2. Użyj metody addApiIfAvailable() interfejsu GoogleApiClient.Builder, aby połączyć się z wymaganymi interfejsami API. Po wywołaniu zwrotnej funkcji onConnected() użyj metody hasConnectedApi(), aby upewnić się, że każdy z żądanych interfejsów API jest prawidłowo połączony.

Dystrybucja aplikacji w Chinach

Aby skutecznie docierać do użytkowników Wear OS w Chinach, możesz rozpowszechniać aplikację w sklepach innych firm z aplikacjami na Wear OS, takich jak:

• Galaxy Store na urządzenia Samsung
• Xiaomi Store na urządzeniach Xiaomi
• Mobvoi w przypadku wszystkich innych urządzeń