إنشاء تطبيقات Wear OS في الصين

عند إنشاء تطبيقات Wear OS في الصين، عليك مراعاة الهواتف التي لم يتم تثبيت "خدمات Google Play" عليها مسبقًا. تحتوي هذه الصفحة على التغييرات الشائعة التي قد يحتاج المطوّرون إلى تطبيقها في السوق الصينية.

استخدام الإصدار الصحيح من "خدمات Google Play"

يوفّر الإصدار 10.2.0 من "خدمات Google Play" دعمًا عالميًا لكلٍّ من واجهة برمجة التطبيقات لموفِّر الموقع المدمج و واجهة برمجة التطبيقات لطبقة البيانات. عليك استخدام هذا الإصدار من "خدمات Google Play" إذا كنت تستخدم واجهات برمجة التطبيقات هذه لـ ضمان دعم مجموعة أوسع من أجهزة Wear OS في الصين. في حالات أخرى، تكون هذه التبعية اختيارية.

ملاحظة: على الرغم من أنّ "خدمات Google Play" تحتوي على واجهات برمجة تطبيقات لتطبيقات Wear OS، يجب أن تواصل تطبيقات Wear OS في الصين استخدام واجهات برمجة التطبيقات ذات الصلة بـ GoogleApiClient، يمكنك الاطّلاع على الوصول إلى Wearable API.

Fused Location Provider API

إذا كنت تستخدم Fused Location Provider API، عليك تضمين التبعية التالية في ملف build.gradle الخاص بوحدة Wear OS:

أنيق

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

إذا كان تطبيقك يستخدم واجهة برمجة التطبيقات Data Layer API، عليك إضافة السطر التالي إلى الـ build.gradle الخاص بوحدة Wear OS. يتطلّب هذا السطر استخدام الإصدار 10.2.0 من مكتبة العميل.

أنيق

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

أضِف السطر التالي إلى ملف build.gradle الخاص بوحدة الأجهزة الجوّالة. استبدِل تبعية "خدمات Google Play" بمرجع إلى الإصدار 10.2.0.

أنيق

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

المصادقة

قبل تنفيذ المصادقة، راجِع حالات الاستخدام لمعرفة ما إذا كانت المصادقة مطلوبة فعلاً. على سبيل المثال، بالنسبة إلى تطبيق يقدّم توقعات الطقس، من المحتمل ألا يكون هناك حاجة إلى تسجيل الدخول وبالتالي إلى المصادقة.

إذا كنت بحاجة إلى المصادقة، ننصحك باستخدام مكتبة AndroidX OAuth 2.0. يتطلّب ذلك استخدام منح رمز التفويض مع تدفق PKCE. يمكنك أيضًا استخدام إحدى الطرق الأخرى الموضّحة في المصادقة على الأجهزة القابلة للارتداء. لا ننصح باستخدام Wearable Support Library.

لمزيد من المعلومات، يمكنك الاطّلاع على نموذج OAuth في Wear OS على GitHub.

الإشعارات التي يتم إرسالها من الهاتف إلى الساعة

لا تتوفّر الإشعارات التي يتم إرسالها من الهاتف إلى الساعة في الصين. يتم إرسال إشعارات الهاتف إلى Wear OS فقط إذا كان جهاز Wear OS متصلاً بالهاتف باستخدام البلوتوث.

التوافق مع إحداثيات الموقع الجغرافي والخرائط

استخدِم FusedLocationProvider (FLP) لرصد موقع المستخدم في الصين، كما تفعل في بقية أنحاء العالم. يضمن ذلك أن يأخذ تطبيقك في الاعتبار أفضل المعلومات بغض النظر عن أجهزة الساعة ومنصة الهاتف التي تم إقران الساعة بها. يؤدي استخدام FLP أيضًا إلى توفير استهلاك البطارية المضمّن في منصة Wear OS.

عند دمج FusedLocationProvider مع حِزم تطوير برامج الخرائط التابعة لجهات خارجية، ضَع في الاعتبار توافق الإحداثيات بين مقدّمي الخدمة. FusedLocationProvider يُبلغ عن الموقع الجغرافي وفقًا لـ WGS84. احرِص على تحويل أنظمة الإحداثيات حسب الحاجة.

دعم Google Fit

يتوفّر في الصين عدّاد الخطوات المتراكمة ودقائق الحركة ونقاط القلب في Google Fit، مع ما يصل إلى سبعة أيام من السجلّ. يمكنك الوصول إلى هذه البيانات بدون تقديم بيانات اعتماد المستخدم.

دعم الإجراءات الصوتية

توفّر منصة Wear OS عدة أهداف صوتية تستند إلى إجراءات المستخدم، مثل _"عرض معدل نبضات القلب"_ أو _"ضبط منبّه"_. يسمح ذلك للمستخدمين بقول ما يريدون فعله ويسمح للنظام بتحديد أفضل نشاط لبدئه.

عندما يتحدث المستخدم عن إجراء صوتي، يمكن لتطبيقك فلترة الهدف الذي يتم تنشيطه لبدء نشاط. لبدء خدمة في الخلفية، اعرض نشاطًا كإشارة مرئية وابدأ الخدمة في النشاط. احرِص على استدعاء finish() للتخلص من الإشارة المرئية.

في ما يلي قائمة بالأهداف الصوتية التي تدعمها منصة Wear OS:

Category (الفئة) مثال مواصفات الهدف
طلب سيارة 打车去三里屯 الإجراء

com.google.android.gms.actions.RESERVE_TAXI_RESERVATION

بيانات إضافية

to: الوجهة التي تم التعرّف عليها

البيانات الإضافية اختيارية.
ضبط المنبّه 设置一个明早七点的闹钟

الإجراء

android.intent.action.SET_ALARM

البيانات الإضافية

android.provider.AlarmClock.EXTRA_HOUR: عدد صحيح يمثّل ساعة المنبّه

android.provider.AlarmClock.EXTRA_MINUTES: عدد صحيح يمثّل دقيقة المنبّه

هذه البيانات الإضافية اختيارية. يمكنك تقديم إحدى هذه البيانات الإضافية أو كلتيهما أو عدم تقديم أي منهما.
تعيين الموقت 设置一个三分钟的倒计时 الإجراء

android.intent.action.SET_TIMER

البيانات الإضافية

android.provider.AlarmClock.EXTRA_LENGTH: عدد صحيح يتراوح بين 1 و86400 (عدد الثواني في 24 ساعة)، ويمثّل مدة الموقت
بدء ساعة التوقيت 开始计时 الإجراء

com.google.android.wearable.action.STOPWATCH
بدء ركوب الدراجة أو إيقافه 开始骑车 الإجراء

vnd.google.fitness.TRACK

نوع MIME

vnd.google.fitness.activity/biking

البيانات الإضافية

actionStatus: سلسلة تتضمّن القيمة ActiveActionStatus عند البدء والقيمة CompletedActionStatus عند الإيقاف
بدء الجري أو إيقافه 开始跑步 الإجراء

vnd.google.fitness.TRACK

نوع MIME

vnd.google.fitness.activity/running

البيانات الإضافية

actionStatus: سلسلة تتضمّن القيمة ActiveActionStatus عند البدء والقيمة CompletedActionStatus عند الإيقاف
بدء التمرين أو إيقافه 开始锻炼 الإجراء

vnd.google.fitness.TRACK

نوع MIME

vnd.google.fitness.activity/other

البيانات الإضافية

actionStatus: سلسلة تتضمّن القيمة ActiveActionStatus عند البدء والقيمة CompletedActionStatus عند الإيقاف
عرض معدل نبضات القلب 查看心率 الإجراء

vnd.google.fitness.VIEW

نوع MIME

vnd.google.fitness.data_type/com.google.heart_rate.bpm
عرض عدد الخطوات 查看步数 الإجراء

vnd.google.fitness.VIEW

نوع MIME

vnd.google.fitness.data_type/com.google.step_count.cumulative
التنقل 导航去三里屯 الإجراء

android.intent.action.VIEW

البيانات

geo:latitude,longitude?q=融科资讯中心

يمكن للمساعد الصوتي أيضًا استخدام الأهداف الشائعة الحالية في Android لتفعيل سلوكيات معيّنة عند الاقتضاء.

دعم المحاكي

يمكنك استخدام الإصدار الصيني من صورة محاكي Wear OS لاختبار تطبيقاتك. يتوافق هذا الإصدار مع Android Studio 3.0 والإصدارات الأحدث.

لاختبار تطبيقاتك على الإصدار الصيني من المحاكي، اتّبِع الخطوات التالية:

  1. ثبِّت Android Emulator.
  2. نزِّل صور Wear OS في الصين من مدير SDK. استخدِم الإصدار المخصّص لنظام التشغيل Wear OS 3.5 (المستوى 30 من واجهة برمجة التطبيقات).
  3. اختَر صورة Wear OS في الصين عند إنشاء ملف شخصي لجهاز Android الظاهري.
  4. شغِّل محاكي Wear OS في الصين لأغراض التطوير.

    5. الشكل 1: أمثلة على الإصدار الصيني من محاكي Wear OS

يأتي هذا الإصدار من محاكي Wear OS مزوّدًا بعدة تطبيقات مثبّتة مسبقًا:

  • وضع الصوت المحيط
  • جهات الاتصال
  • الإدخال بخط اليد من Google
  • خدمات Google Play
  • خدمات الصحة على Wear OS
  • التعرّف على الكلمات الرئيسية لأجهزة LE
  • Pinyin
  • متجر Google Play (معدَّل للأجهزة في الصين)
  • Pocketwatch
  • Talkback
  • خلفيات الساعة (الإصداران التناظري والرقمي)
  • الخدمات الأساسية لنظام Wear

بدء قناة بلوتوث وWi-Fi خاصة بالتطبيق

توجِّه Wear OS تلقائيًا طلبات الشبكة. في معظم الحالات، ليس مطلوبًا من التطبيق فتح قناة بلوتوث وWi-Fi خاصة بالتطبيق.

إذا طلب تطبيق قناة بلوتوث وWi-Fi خاصة بالتطبيق في الصين، سيفشل الطلب تلقائيًا. بدلاً من ذلك، يظهر مربّع حوار يطلب من المستخدم التأكيد. إذا أكّد المستخدم، يتم فتح القناة. يحدث ذلك في كل مرة، وليس عند الاستخدام الأول فقط. BluetoothAdapter.enable() أو WifiManager.setEnabled(true) يتم استدعاؤه.

ملاحظة: لكي يتمكّن تطبيق يستهدف الإصدار 10 من Android (المستوى 29 من واجهة برمجة التطبيقات) أو إصدارًا أحدث من استدعاء WifiManager.setEnabled()، يجب أن يكون تطبيقًا على مستوى النظام أو وحدة تحكّم في سياسة الجهاز.

وضع مراجعة الأذونات

في الصين، تعمل أجهزة Wear OS في الصين في وضع مراجعة الأذونات، ما يفرض بعض القيود على كيفية استخدام التطبيقات التي تستهدف targetApiLevel أقل من 23. راجِع القيود التالية:

  • على الرغم من منح الأذونات في وقت التثبيت، عندما يبدأ تطبيق يستهدف targetApiLevel أقل من 23 للمرة الأولى، يظهر مربّع حوار يطلب من المستخدم تأكيد أذونات هذا التطبيق.
  • لا تستجيب المكوّنات في التطبيق، مثل أجهزة استقبال البث والخدمات والأنشطة، للأحداث المقابلة قبل استخدام التطبيق للمرة الأولى.

نتيجةً لذلك، ننصحك باستخدام targetApiLevel 23 أو إصدارًا أحدث واتّباع أفضل الممارسات المتعلّقة بأذونات التطبيقات.

استخدام واجهات برمجة تطبيقات أخرى من "خدمات Google Play"

إذا كان تطبيقك يستخدم واجهات برمجة تطبيقات "خدمات Google Play" غير Wearable API، يجب أن يتحقّق تطبيقك مما إذا كانت واجهات برمجة التطبيقات هذه متاحة للاستخدام أثناء وقت التشغيل وأن يستجيب بشكل مناسب. هناك طريقتان للتحقّق من مدى توفّر واجهات برمجة تطبيقات "خدمات Google Play":

  1. استخدِم مثيلاً منفصلاً من GoogleApiClient للاتصال بواجهات برمجة التطبيقات الأخرى. تحتوي هذه الواجهة على عمليات معاودة الاتصال لتنبيه تطبيقك بشأن نجاح الاتصال أو فشله. في حال فشل الاتصال، يعرض ConnectionResult الرمز API_UNAVAILABLE. لمعرفة كيفية التعامل مع حالات فشل الاتصال، يمكنك الاطّلاع على الوصول إلى واجهات برمجة تطبيقات Google.
  2. استخدِم طريقة addApiIfAvailable() في GoogleApiClient.Builder للاتصال بواجهات برمجة التطبيقات المطلوبة. بعد تنشيط عملية معاودة الاتصال onConnected()، استخدِم طريقة hasConnectedApi() للتأكّد من أنّ كل واجهة من واجهات برمجة التطبيقات المطلوبة متصلة بشكل صحيح.

توزيع التطبيقات في الصين

للوصول بفعالية إلى مستخدمي Wear OS في الصين، يمكنك التوزيع من خلال متاجر تطبيقات Wear OS التابعة لجهات خارجية، مثل: