Çin için Wear OS uygulamaları oluşturma

Çin için Wear OS uygulamaları oluştururken Google Play Hizmetleri önceden yüklenmemiş telefonları da hesaba katmanız gerekir. Bu sayfada, geliştiricilerin Çin pazarı için benimsemesi gereken yaygın değişiklikler yer almaktadır.

Google Play Hizmetleri'nin doğru sürümünü kullanma

Google Play Hizmetleri 10.2.0 sürümü, Çok Kaynaklı Konum Sağlayıcı API'si ve Veri Katmanı API'si için dünya çapında destek sağlar. Çin'de daha fazla Wear OS cihazının desteklenmesini sağlamak için bu API'leri kullanıyorsanız Google Play Hizmetleri'nin bu sürümünü kullanmanız gerekir. Diğer durumlarda bu bağımlılık isteğe bağlıdır.

Not: Google Play Hizmetleri, Wear OS uygulamalarına yönelik API'ler içerse de Çin'e yönelik Wear OS uygulamalarının, GoogleApiClient ile ilgili API'leri kullanmaya devam etmesi gerekir. Giyilebilir API'ye erişme bölümüne bakın.

Çok Kaynaklı Konum Sağlayıcı API'sı

Fused Location Provider API'yi kullanıyorsanız Wear OS modülünüzün build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

Modern

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")
}

Veri Katmanı API'sı

Not: Data Layer API, yalnızca Android telefonlar ve Wear OS saatlerle mesaj gönderebilir ve verileri senkronize edebilir. Wear OS cihazınız bir iOS cihazla eşlendiyse Data Katman API çalışmaz.

Bu nedenle, Veri Katmanı API'sini bir ağla iletişim kurmanın birincil yolu olarak kullanmayın. Bunun yerine, Wear OS uygulamanızda mobil uygulamadakiyle aynı kalıbı uygulayın, ancak Wear OS'te ağ erişimi ve senkronizasyon bölümünde açıklanan bazı küçük farklılıkları da göz önünde bulundurun.

Uygulamanız Veri Katmanı API'sini kullanıyorsa Wear OS modülünüzün build.gradle dosyasına aşağıdaki satırı eklemeniz gerekir. Satır, istemci kitaplığının 10.2.0 sürümünün kullanılmasını gerektirir.

Modern

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")
    ...
}

Aşağıdaki satırı mobil modülünüzün build.gradle dosyasına ekleyin. Google Play hizmetleri bağımlılığını 10.2.0 sürümüne referans vererek değiştirin.

Modern

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")
}

Kimlik doğrulama

Kimlik doğrulamasını uygulamadan önce, kimlik doğrulamasının gerçekten gerekli olup olmadığını görmek için kullanım alanlarınızı inceleyin. Örneğin, hava durumu tahminini yayınlayan bir uygulamada oturum açmaya ve dolayısıyla kimlik doğrulama işlemine gerek yoktur.

Kimlik doğrulama gerektirecekseniz AndroidX Oauth kitaplığını kullanmanızı öneririz. Bunun için PKCE ile Yetkilendirme Kodu Verme akışının kullanılması gerekir. Giyilebilir cihazlarda kimlik doğrulama bölümünde açıklanan diğer yöntemlerden birini de kullanabilirsiniz. Giyilebilir Cihaz Destek Kitaplığı'nın kullanılması önerilmez.

Daha fazla bilgi edinmek için GitHub'daki Wear OS OAuth Örneği'ne göz atın.

Köprü modundaki bildirimler

Köprülü bildirimler Çin'de desteklenmez. Telefon bildirimleri yalnızca Wear OS cihaz telefona Bluetooth ile bağlanmışsa Wear OS'e köprü görevi görür.

Konum ve eşleme koordinatlarının uyumluluğu

Dünyanın geri kalanında olduğu gibi, kullanıcının Çin'deki konumunu tespit etmek için FusedLocationProvider (FLP) özelliğini kullanın. Bu sayede uygulamanız, saatin donanımından ve saatin eşlendiği telefon platformundan bağımsız olarak en iyi bilgileri dikkate alır. FLP kullanıldığında, Wear OS platformunda yerleşik olarak bulunan pil optimizasyonu özelliği de eklenir.

FusedLocationProvider öğesini üçüncü taraf harita SDK'larıyla entegre ederken sağlayıcılar arasındaki koordinat uyumluluğunu dikkate alın. FusedLocationProvider, konumu WGS84 standardına göre bildirir. Koordinat sistemlerini uygun şekilde dönüştürdüğünüzden emin olun.

Google Fit desteği

Google Fit'in birikmiş adım sayacı, hareket dakikaları ve kardiyo puanları, yedi güne kadar geçmişi olan Çin'de desteklenmektedir. Bu sayfaya kullanıcı kimlik bilgisi sağlamadan erişebilirsiniz.

Sesli işlem desteği

Wear OS platformu, _"Nabzı göster"_ veya _"Alarm kur"_ gibi kullanıcı işlemlerine dayalı çeşitli ses amaçları sağlar. Bu, kullanıcıların ne yapmak istediklerini söylemelerine ve sistemin başlamak için en iyi etkinliği bulmasına olanak tanır.

Kullanıcılar sesli işlem yaptığında uygulamanız bir etkinliği başlatmak için tetiklenen amaca göre filtre uygulayabilir. Arka planda bir hizmet başlatmak için bir etkinliği görsel bir işaret olarak gösterin ve hizmeti etkinlikte başlatın. Görsel işaretten kurtulmak için finish() yöntemini çağırdığınızdan emin olun.

Wear OS platformu tarafından desteklenen ses amaçlarının listesini burada bulabilirsiniz:

Kategori	Örnek	Amaç özellikleri
Araç çağırma	打车去里屯	İşlem com.google.android.gms.actions.RESERVE_TAXI_RESERVATION Ekstra to: tanınan hedef Ekstra isteğe bağlıdır.
Alarm kurma	设置苯明早七点苯闹钟	İşlem android.intent.action.SET_ALARM Ekstralar android.provider.AlarmClock.EXTRA_HOUR: alarmın saatini içeren bir tam sayı android.provider.AlarmClock.EXTRA_MINUTES: alarmın dakikasını içeren bir tam sayı Bu ek özellikler isteğe bağlıdır. Bu ekstra özelliklerden birini veya ikisini birden sağlayın ya da hiçbirini sunun.
Zamanlayıcıyı ayarla	设置苯ง苯钟한倒计时	İşlem android.intent.action.SET_TIMER Ekstralar android.provider.AlarmClock.EXTRA_LENGTH: Zamanlayıcının uzunluğunu temsil eden 1 ile 86.400 (24 saatteki saniye sayısı) aralığında bir tam sayı
Kronometreyi başlat	开始计时	İşlem com.google.android.wearable.action.STOPWATCH
Bisiklet yolculuğu başlatma veya durdurma	开始骑车	İşlem vnd.google.fitness.TRACK MIME türü vnd.google.fitness.activity/biking Ekstralar actionStatus: başlangıçta ActiveActionStatus, durdurmada ise CompletedActionStatus değerine sahip bir dize
Koşu başlatma veya durdurma	开始跑步	İşlem vnd.google.fitness.TRACK MIME türü vnd.google.fitness.activity/running Ekstralar actionStatus: başlangıçta ActiveActionStatus, durdurulduğunda ise CompletedActionStatus değerine sahip bir dize
Antrenman başlatma veya durdurma	开始锻炼	İşlem vnd.google.fitness.TRACK MIME türü vnd.google.fitness.activity/other Ekstralar actionStatus: başlangıçta ActiveActionStatus, durdurulduğunda ise CompletedActionStatus değerine sahip bir dize
Nabzı göster	查看率	İşlem vnd.google.fitness.VIEW MIME türü vnd.google.fitness.data_type/com.google.heart_rate.bpm
Adım sayısını göster	查看步数	İşlem vnd.google.fitness.VIEW MIME türü vnd.google.fitness.data_type/com.google.step_count.cumulative
Navigasyon	导航去社里屯	İşlem android.intent.action.VIEW Veri coğrafi:enlem,boylam?q=融科资讯 tavsiye edilemedi

Sesli Asistan, uygun durumlarda belirli davranışları tetiklemek için mevcut Android ortak amaçlarını da kullanabilir.

Emülatör desteği

Uygulamalarınızı test etmek için Wear OS emülatör görüntüsünün Çin sürümünü kullanabilirsiniz. Bu, Android Studio 3.0 ve sonraki sürümler tarafından desteklenir.

Uygulamalarınızı emülatörün Çin sürümünde test etmek için şu adımları uygulayın:

1. Android Emülatör'ü yükleyin.
2. SDK yöneticisinden Çin için Wear OS görüntülerini indirin. Wear OS 3.5 sürümünü kullanın (API düzeyi 30).
3. AVD profili oluştururken Çin için Wear OS görüntüsünü seçin.
4. Geliştirme amacıyla Çin için Wear OS emülatörünü çalıştırın.


Şekil 1. Wear OS emülatörünün Çin sürümüne örnekler.

Wear OS emülatörünün bu sürümü, önceden yüklenmiş çeşitli uygulamalarla birlikte gelir:

• Ambiyans modu
• Kişiler
• Google El Yazısı Girişi
• Google Play hizmetleri
• Wear OS için Sağlık Hizmetleri
• LE cihazları için özel kelime tanıma
• Pinyin
• Play Store (Çin'deki cihazlar için uyarlanmıştır)
• Cep Saati
• TalkBack
• Kadranlar (hem analog hem de dijital versiyonlar)
• Wear Temel Hizmetleri

Uygulamaya özel bir Bluetooth ve kablosuz ağ kanalı başlatın

Wear OS, ağ isteklerini otomatik olarak yönlendirir. Çoğu durumda, uygulamanın uygulamaya özel bir Bluetooth ve kablosuz ağ kanalı açması gerekmez.

Bir uygulama, Çin'de uygulamaya özgü bir Bluetooth ve kablosuz ağ kanalı isteğinde bulunursa istek sessizce başarısız olur. Bunun yerine, kullanıcıdan onay isteyen bir iletişim kutusu görüntülenir. Kullanıcı onaylarsa kanal açılır. Bu durum yalnızca ilk kullanımda değil, her seferinde gerçekleşir. BluetoothAdapter.enable() veya WifiManager.setEnabled(true) çağrılır.

Not: Android 10 (API düzeyi 29) veya sonraki sürümleri hedefleyen bir uygulamanın WifiManager.setEnabled() araması yapabilmesi için bir sistem uygulaması veya cihaz politikası denetleyici (DPC) olması gerekir.

İzin inceleme modu

Çin'de Wear OS, Çin'deki cihazlar için İzin İnceleme Modu'nda çalışmaktadır. İzin İnceleme Modu, targetApiLevel 23'ün altında olan uygulamaların kullanımına bazı sınırlamalar getirir. Aşağıdaki sınırları inceleyin:

• İzinler yükleme sırasında verilmiş olsa bile targetApiLevel değeri 23'ten düşük olan bir uygulama ilk kez başlatıldığında, kullanıcıdan bu uygulamaya ilişkin izinleri onaylamasını isteyen bir iletişim kutusu görüntülenir.
• Uygulamanın içindeki yayın alıcıları, hizmetler ve etkinlikler gibi bileşenler, uygulama ilk kez kullanılmadan karşılık gelen etkinliklere yanıt vermiyor.

Sonuç olarak, targetApiLevel 23 veya sonraki bir sürümü kullanmanızı ve uygulama izinleri en iyi uygulamalarını benimsemenizi öneririz.

Diğer Google Play Hizmetleri API'lerini kullanma

Uygulamanız, Wearable API dışında Google Play Services API'lerini kullanıyorsa, uygulamanızın bu API'lerin çalışma zamanında kullanılabilir olup olmadığını kontrol etmesi ve gereken şekilde yanıt vermesi gerekir. Google Play hizmeti API'lerinin kullanılabilirliğini kontrol etmenin iki yolu vardır:

1. Diğer API'lere bağlanmak için ayrı bir GoogleApiClient örneği kullanın. Bu arayüzde, bağlantının başarılı veya başarısız olduğu konusunda uygulamanızı uyarmak için geri çağırmalar bulunur. Bağlantı başarısız olursa ConnectionResult sütununda API_UNAVAILABLE gösterilir. Bağlantı hatalarını nasıl ele alacağınızı öğrenmek için Google API'lerine erişme başlıklı makaleye bakın.
2. Gerekli API'lere bağlanmak için GoogleApiClient.Builder addApiIfAvailable() yöntemini kullanın. onConnected() geri çağırma işlemi tetiklendikten sonra, istenen API'lerin her birinin doğru şekilde bağlandığından emin olmak için hasConnectedApi() yöntemini kullanın.

Uygulamaları Çin'de dağıtma

Çin için Wear OS kullanıcılarına etkili bir şekilde ulaşmak için aşağıdakiler gibi üçüncü taraf Wear OS uygulama mağazaları üzerinden dağıtım yapabilirsiniz:

• Samsung cihazlar için Galaxy Store
• Xiaomi cihazlar için Xiaomi Store
• Diğer tüm cihazlar için Mobvoi