ننصح بأن تعمل تطبيقات Wear OS بشكل مستقل عن الهاتف حتى يتمكّن المستخدمون من إكمال المهام على الساعة بدون الحاجة إلى هاتف Android أو iOS. إذا كان تطبيق الساعة الذكية يتطلّب التفاعل مع الهاتف، يجب وضع علامة على تطبيق Wear OS بأنّه غير مستقل واتّخاذ الخطوات اللازمة لضمان توفّر تطبيق الهاتف للمستخدم.
التخطيط لتطبيقك
يمكنك استخدام مجموعة حزمات تطبيق Android لإنشاء حِزم APK محسّنة تلقائيًا لإعدادات جهاز كل مستخدم ضمن بطاقة بيانات التطبيق نفسها. يتيح ذلك للمستخدمين تنزيل الرموز والموارد التي يحتاجون إليها فقط لتشغيل تطبيقك.
للحصول على معلومات حول إعداد تطبيقك للتوزيع من خلال "متجر Google Play"، يُرجى الاطّلاع على تجميع تطبيقات Wear OS وتوزيعها ودليل بدء استخدام مجموعات حزمات تطبيق Android.
بالنسبة إلى التطبيقات الجديدة، يجب أن يكون مستوى واجهة برمجة التطبيقات المستهدف 34 أو أعلى. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استيفاء متطلبات مستوى واجهة برمجة التطبيقات المستهدَف في Google Play. يساعد استهداف أحدث مستوى متاح من واجهة برمجة التطبيقات في ضمان عمل تطبيقك بشكل جيد على إصدارات النظام الأساسي الحالية.
للحصول على معلومات حول طلبات الشبكة والوصول إلى الشبكة ذات معدل نقل البيانات العالي، يُرجى الاطّلاع على الوصول إلى الشبكة والمزامنة على Wear OS.
تحديد تطبيق على أنّه تطبيق Wear OS
يجب تحديد علامة
<uses-feature> في ملف بيان Android الخاص بتطبيقك.
للإشارة إلى أنّه تطبيق ساعة ذكية، أضِف إدخالاً مثل ما يلي:
<uses-feature android:name="android.hardware.type.watch" />
تحديد ما إذا كان التطبيق مستقلاً أو غير مستقل
يُعدّ تطبيق الساعة الذكية إما مستقلاً أو غير مستقل:
- مستقل: تطبيق مستقل تمامًا لا يتطلّب تطبيقًا على الهاتف لتشغيل الميزات الأساسية. على الرغم من أنّ طلبات "الفتح على الهاتف" مقبولة، يجب أن يوفّر التطبيق وسائل بديلة للمستخدمين لإكمال وظيفة التطبيق، مثل رابط قصير أو رمز استجابة سريعة، بدون الاعتماد على هاتف متصل.
- غير مستقل: تطبيق تابع يتطلّب تطبيقًا على هاتف أو جهاز آخر لتشغيل الميزات الأساسية هذا الخيار هو الأفضل للتطبيقات التي لا يمكنها بسهولة توفير وسيلة بديلة، مثل رمز الاستجابة السريعة أو رابط قصير، لإكمال وظيفة أساسية في التطبيق، مثل المصادقة.
ملاحظة: حتى بالنسبة إلى التطبيقات غير المستقلة، يمكن للمستخدمين تثبيت تطبيق Wear OS قبل تثبيت التطبيق على الأجهزة الجوّالة. لذلك، إذا رصد تطبيق Wear OS أنّ جهازًا محمولاً قريبًا لا يتضمّن التطبيق المصاحب اللازم، اطلب من المستخدم تثبيت التطبيق المصاحب.
تتحقّق Google من دقة حالة التطبيق المستقل أثناء عرض التطبيق. تؤثر هذه القيمة في ظهور التطبيقات في "متجر Google Play" على الأجهزة غير المقيَّدة، مثل أجهزة Wear OS غير المقترنة بأجهزة محمولة. لا تتوفّر التطبيقات غير المستقلة، وكذلك التطبيقات التي يصنّفها المطوّرون بشكل غير صحيح على أنّها "مستقلة"، للمستخدمين على هذه الأجهزة غير المقيّدة.
في تطبيق Wear OS، اضبط قيمة العنصر
meta-data com.google.android.wearable.standalone
في ملف بيان Android لتوضيح ما إذا كان تطبيقك مستقلاً أو غير مستقل.
إذا كان تطبيق ساعتك مستقلاً تمامًا، يمكنك الإشارة إلى ذلك في "متجر Google Play" من خلال ضبط قيمة com.google.android.wearable.standalone على true:
<meta-data android:name="com.google.android.wearable.standalone" android:value="true" />
إذا كان تطبيق الساعة الذكية غير مستقل ويعتمد على تطبيق آخر لتوفير الميزات الأساسية،
اضبط قيمة com.google.android.wearable.standalone على
false. يشير ذلك إلى أنّ تطبيق الساعة الذكية يتطلّب جهازًا آخر، ولكنّه لا يؤثر في ترويج تطبيقك على "متجر Google Play".
ملاحظة:
حتى إذا كانت قيمة com.google.android.wearable.standalone هي
false، يمكن تثبيت تطبيق الساعة الذكية
قبل تثبيت تطبيق الهاتف.
لذلك، إذا اكتشف تطبيق الساعة الذكية أنّ الهاتف المصاحب لا يتضمّن تطبيق الهاتف اللازم، كما هو موضّح في هذه الصفحة، اطلب من المستخدم تثبيت تطبيق الهاتف.
مساحة تخزين مشترَكة للرموز البرمجية والبيانات
يمكن مشاركة الرمز البرمجي بين تطبيق Wear OS وتطبيق الهاتف. على سبيل المثال، يمكن أن يكون الرمز البرمجي الشائع للشبكات في مكتبة مشتركة.
ويمكن اختياريًا أن يكون الرمز البرمجي الخاص بشكل جهاز معيّن في وحدة منفصلة.
يمكنك استخدام واجهات برمجة التطبيقات العادية لتخزين البيانات على Android لتخزين البيانات محليًا، كما تفعل على الهاتف. يمكنك استخدام DataStore لتخزين أزواج المفتاح/القيمة والعناصر المكتوبة، أو يمكنك استخدام مكتبة Room لاستدامة البيانات.
رصد تطبيقك على جهاز آخر
يمكن لكل من تطبيق الساعة الذكية وتطبيق الهاتف المقابل له رصد ما إذا كان التطبيق الآخر متاحًا.
يمكن لتطبيقات الهاتف وتطبيق الساعة الذكية استخدام
CapabilityClient للإعلان عن توفّرها
لجهاز مقترِن. ويمكنهم إجراء ذلك بشكل ثابت أو ديناميكي.
عندما يكون التطبيق
على عقدة في شبكة Wear OS الخاصة بالمستخدم، مثل الهاتف أو الساعة المقترنة أو
في السحابة الإلكترونية، تتيح CapabilityClient للتطبيقات الأخرى
رصده. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة اكتشاف أجهزة معيّنة باستخدام عميل إمكانات.
إذا لم يتمكّن أحد تطبيقاتك من رصد التطبيق الآخر، يمكنك أن تطلب من المستخدم فتح بطاقة بيانات "متجر Google Play" على الجهاز المتأثّر. هذا الحل مخصّص لتطبيقات الساعة الذكية التي تتطلّب تثبيت تطبيق الهاتف المصاحب لتعمل بشكل صحيح.
يجب التحقّق مما إذا كان "متجر Google Play" متاحًا على الجهاز، لأنّ بعض الهواتف، مثل هواتف iPhone، لا تتوافق مع "متجر Google Play".
توضّح الأقسام التالية أفضل الممارسات لسيناريوهَين:
- يتطلّب تطبيق الساعة الذكية المستقل استخدام تطبيق الهاتف.
- يحتاج تطبيق الهاتف إلى تطبيق الساعة الذكية المستقل.
يمكنك أيضًا مراجعة نموذج مساعدي Datalayer الذي يوضّح كيفية استخدام مكتبات مساعدي Datalayer، وهي جزء من Horologist. تتيح لك هذه الأدوات المساعدة مراقبة الاتصال بين جهاز محمول
وجهاز Wear OS.
لمزيد من المعلومات حول الفئات الموضّحة في القسم التالي، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات لنظام التشغيل Wear OS.
يتضمّن هذا المرجع أيضًا معلومات عن فئة PhoneTypeHelper التي تحتوي على طريقة getPhoneDeviceType() تتيح لتطبيق Wear OS التحقّق مما إذا كان الهاتف المصاحب هو جهاز Android أو iOS.
تحديد أسماء الإمكانات لرصد تطبيقاتك
بالنسبة إلى التطبيق المقابل لكل نوع جهاز، سواء كان ساعة أو هاتفًا، حدِّد سلسلة فريدة لاسم الإمكانية في ملف res/values/wear.xml.
على سبيل المثال، في وحدة الأجهزة الجوّالة، يمكن أن يتضمّن ملف wear.xml ما يلي:
<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@array/android_wear_capabilities"> <string-array name="android_wear_capabilities"> <item>verify_remote_example_phone_app</item> </string-array> </resources>
في وحدة Wear OS، يتضمّن ملف wear.xml
قيمة مختلفة لاسم الإمكانية،
مثل ما يلي:
<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@array/android_wear_capabilities"> <string-array name="android_wear_capabilities"> <item>verify_remote_example_wear_app</item> </string-array> </resources>
لمزيد من المعلومات، يُرجى الاطّلاع على اكتشاف أجهزة معيّنة باستخدام عميل إمكانات.
رصد التطبيق وفتح عنوان URL من ساعة
يمكن لتطبيق الساعة الذكية رصد ما إذا كان تطبيق الهاتف مثبّتًا على هاتف المستخدم المصاحب. اتّبِع الخطوات التالية:
-
استخدِم
CapabilityClientللتحقّق مما إذا كان تطبيق الهاتف مثبّتًا على الهاتف المقترن. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج مساعدي طبقة البيانات على GitHub. -
إذا لم يكن تطبيق الهاتف مثبّتًا على الهاتف، استخدِم طريقة
PhoneDeviceType.getPhoneDeviceType()للتحقّق من نوع الهاتف. يُرجى الاطّلاع على القسم التالي لمعرفة التفاصيل. -
إذا تم عرض
PhoneDeviceType.DEVICE_TYPE_ANDROID، يكون الهاتف من نوع Android. استدعِRemoteActivityHelper.startRemoteActivity()على جهاز Wear OS لفتح "متجر Google Play" على الهاتف. استخدِم معرّف الموارد المنتظم (URI) الخاص بالسوق لتطبيق الهاتف، والذي قد يختلف عن معرّف الموارد المنتظم (URI) الخاص بتطبيق Wear OS. على سبيل المثال، استخدِم عنوان URI للسوق مثل:market://details?id=com.example.android.wearable.wear.finddevices. -
إذا تم عرض
PhoneDeviceType.DEVICE_TYPE_IOS، فهذا يعني أنّ الهاتف يعمل بنظام التشغيل iOS ولا يتوفّر فيه "متجر Play". افتح متجر التطبيقات على هاتف iPhone من خلال طلبRemoteActivityHelper.startRemoteActivity()على جهاز Wear OS. يمكنك تحديد عنوان URL لتطبيقك على iTunes، مثلhttps://itunes.apple.com/us/app/yourappname.من خلال Wear OS، لا يمكنك تحديد ما إذا كان تطبيق الهاتف مثبّتًا على جهاز iOS أم لا. كأفضل ممارسة، يمكنك توفير آلية للمستخدم لتشغيل فتح متجر التطبيقات يدويًا.
ملاحظة: استخدِم واجهة برمجة التطبيقات RemoteActivityHelper كما هو موضّح في القسم السابق
لتحديد أنّه يمكن فتح أي عنوان URL على الهاتف من الساعة،
وأنّه لا يلزم استخدام تطبيق هاتف.
تفاصيل حول رصد نوع الهاتف المقترن
في ما يلي مقتطف يستخدم طريقة getPhoneDeviceType()
للتحقّق من نوع الهاتف الذي تم إقران الساعة به:
var phoneDeviceType: Int = PhoneTypeHelper.getPhoneDeviceType(this)
القيمة التي تعرضها الطريقة getPhoneDeviceType() هي إحدى القيم التالية:
| القيمة المعروضة | الوصف |
|---|---|
DEVICE_TYPE_ANDROID
|
الهاتف المرفق هو جهاز يعمل بنظام التشغيل Android. |
DEVICE_TYPE_IOS
|
الهاتف المصاحب هو جهاز iOS. |
DEVICE_TYPE_UNKNOWN
|
الهاتف المرفق هو جهاز غير معروف. |
DEVICE_TYPE_ERROR
|
حدث خطأ أثناء تحديد نوع الهاتف المقترن، لذا يجب إجراء عملية تحقّق أخرى لاحقًا. |
رصد التطبيقات بدءًا من هاتف Android
يمكن لهاتف Android رصد ما إذا كانت أجهزة Wear OS الخاصة بالمستخدم تتضمّن تطبيق الساعة الذكية، وذلك باتّباع الخطوات التالية:
-
باستخدام
NodeClient، يمكنك العثور على جميع الساعات المتصلة بهاتف المستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج مساعدي طبقة البيانات على GitHub. -
باستخدام
CapabilityClient، يمكنك التحقّق من ساعات المستخدم التي تم تثبيت تطبيقك عليها. -
إذا لم يكن تطبيقك مثبَّتًا على جميع ساعات المستخدم، يمكنك السماح للمستخدم بفتح "متجر Google Play" على أجهزة Wear OS المتبقية من الهاتف باستخدام طريقة
RemoteActivityHelper.startRemoteActivity(). استخدِم معرّف الموارد المنتظم (URI) الخاص بالسوق لتطبيق Wear OS، والذي قد يكون مختلفًا عن معرّف الموارد المنتظم (URI) الخاص بتطبيق الهاتف. على سبيل المثال، استخدِم معرّف موارد منتظم (URI) للسوق، مثل:market://details?id=com.example.android.wearable.wear.finddevices.
بيانات الموقع الجغرافي للساعات المقترنة بأجهزة iPhone
بالنسبة إلى الساعات المقترنة بهواتف iPhone، استخدِم موفِّر الموقع المدمج (FLP) للحصول على بيانات الموقع الجغرافي على الساعة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة رصد الموقع الجغرافي على Wear OS.
إذا كان الهاتف المقترن متاحًا، يستخدم موفِّر الموقع المدمج (FLP) الهاتف المقترن للحصول على بيانات الموقع الجغرافي.
الحصول على البيانات الضرورية فقط
بشكل عام، عند الحصول على البيانات من الإنترنت، احصل على البيانات الضرورية فقط. وإلا، قد يتسبب ذلك في حدوث وقت استجابة غير ضروري، واستخدام الذاكرة، واستخدام البطارية.
عندما تكون الساعة متصلة عبر اتصال بلوتوث منخفض الطاقة، قد يتمكّن تطبيقك من الوصول إلى معدل نقل بيانات يبلغ 4 كيلوبايت في الثانية فقط، وذلك حسب الساعة. لذلك، ننصحك باتّباع الخطوات التالية:
- راجِع طلبات الشبكة والردود عليها بحثًا عن بيانات إضافية لا يحتاج إليها سوى تطبيق الهاتف.
- تصغير الصور الكبيرة قبل إرسالها عبر شبكة إلى ساعة
في الحالات التي تتطلّب شبكة ذات معدل نقل بيانات مرتفع، يُرجى الاطّلاع على الوصول إلى شبكة ذات معدل نقل بيانات مرتفع.
عيّنات تعليمات برمجية إضافية
يوضّح نموذج مساعدي طبقة البيانات بشكل أكبر استخدام واجهات برمجة التطبيقات التي تتناولها هذه الصفحة.