إنشاء تطبيق وتشغيله على Wear OS

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

يستند هذا الدليل إلى بعض المعلومات السابقة حول نظام Android الأساسي وبيئة تطوير البرامج (IDE) من "استوديو Android". إذا كنت مبتدئًا تمامًا في استخدام Android، يمكنك إنشاء تطبيق باستخدام هذا الدرس التطبيقي حول الترميز. للاطّلاع على مزيد من المعلومات حول إمكانات "استوديو Android"، يُرجى الانتقال إلى صفحة التعرّف على "استوديو Android".

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

بعد تنزيل أحدث إصدار من "استوديو Android" وتثبيته، أكمِل معالج "مشروع جديد":

  1. افتح Android Studio، ثم انتقِل إلى ملف > جديد > مشروع جديد. تظهر نافذة مشروع جديد.
  2. في لوحة النماذج، اختَر Wear OS. بعد ذلك، في اللوحة الرئيسية، اختَر إفراغ تطبيق Wear App.
  3. أدخِل اسمًا لمشروعك، ثم انقر على إنهاء. يقوم Android Studio بتنزيل التبعيات اللازمة وإنشاء الإصدار الأولي لمشروعك.

  4. انتقِل إلى الأدوات > مدير حِزم تطوير البرامج (SDK)، ثبِّت كل من الحِزم التالية:

    • Android 14.0 ("UpsideDownCake) (المستوى 34 لواجهة برمجة التطبيقات)، والذي يتضمّن صورة نظام Wear OS 5‏ - ARM 64 v8a و صورة نظام Wear OS 5‏ - Intel x86 Atom_64
    • ‫Android 13.0 ("Tiramisu") (المستوى 33 لواجهة برمجة التطبيقات)، والذي يتضمّن صورة نظام Wear OS 4 ARM 64 v8a وصورة نظام Wear OS 4 Intel x86 Atom_64

    لإغلاق أداة إدارة حِزم SDK، انقر على حسنًا.

يمكنك الآن تشغيل تطبيقك الأول على Wear OS.

تشغيل تطبيق على المحاكي

إنّ أسهل طريقة لتشغيل تطبيق Wear OS الأول هو ضبط المحاكي.

ضبط محاكي

لضبط المحاكي في Android Studio، أكمِل الخطوات التالية:

  1. في "مدير حِزم تطوير البرامج (SDK)"، افتح علامة التبويب أدوات حِزم تطوير البرامج (SDK). تأكَّد من تثبيت أحدث إصدار من أدوات حزمة تطوير البرامج (SDK) لنظام Android.
  2. انتقِل إلى الأدوات > مدير الأجهزة.
  3. انقر على إنشاء (+). سيظهر معالج إعداد الجهاز الظاهري.
  4. في لوحة الفئة، اختَر Wear OS واختَر ملف تعريف الجهاز، مثل Wear OS Small Round. انقر على Next (التالي).

  5. بالنسبة إلى صور النظام المستخدمة خارج الصين، اختَر اسم إصدار UpsideDownCake. يستهدف هذا الإصدار الإصدار 14.0 من نظام التشغيل Android (الإصدار 5 من نظام التشغيل Wear OS). بالنسبة إلى صور النظام المستخدَمة في الصين، اختَر اسم الإصدار R. يستهدف هذا الإصدار الإصدار 11.0 من نظام التشغيل Android (الإصدار 3 من Wear OS). إذا لم يكن لديك صورة نظام Wear OS 5 مثبّتة متطابقة مع تعريف جهازك، انقر على تنزيل بجانب اسم الإصدار للحصول عليها. انقر على التالي.

    ملاحظة: تتضمّن صور النظام الخاصة بمحاكي Wear OS إشعارات بشأن الملفات ورمز المصدر التابعَين لجهات خارجية. يمكنك الاطّلاع على إشعارات الجهات الخارجية بصورة معيّنة من النظام من خلال فتح ملف NOTICE.txt، الموجود في أحد الأدلة التالية:

    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI المحاكيات المستخدَمة خارج الصين
    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI لبرامج المحاكاة المستخدَمة في الصين

  6. يمكنك الاحتفاظ بالقيمة التلقائية لجميع الإعدادات على هذه الشاشة، ما لم يكن لديك رغبة في تخصيص المحاكي. انقر على إنهاء.

ولمزيد من المعلومات عن استخدام أدوات المحاكاة، يمكنك الاطّلاع على الدليل حول كيفية تشغيل التطبيقات على "محاكي Android".

افتح التطبيق في المحاكي.

  1. انتقِل إلى تشغيل > اختيار جهاز. اختَر المحاكي الذي أنشأته للتو.
  2. في شريط أدوات Android Studio، انقر على تشغيل . يبدأ المحاكي تطبيقك ويفتحه.
  3. بعد بضع لحظات، من المفترض أن تظهر رسالة "مرحبًا..." في المحاكي.

اختبار الصوت عبر البلوتوث باستخدام المحاكي

في صور النظام التي تعمل بنظام التشغيل Wear OS 4 أو إصدار أحدث، يتيح المحاكي استخدام تقنية emulated Bluetooth، ما يتيح لك اختبار الصوت عبر البلوتوث في العديد من حالات الاستخدام.

لا تتوافق صور النظام الحديثة إلا مع البنى الأساسية التي تعمل بنظام 64 بت.

لا تتوافق صور نظام المحاكاة لنظام التشغيل Wear OS 4 والإصدارات الأحدث إلا مع بنيةَي 64 بت التاليتَين: x86-64 وarm64-v8a. إذا كنت تعرف أو تشتبه في أنّ تطبيقك يستخدم رمزًا برمجيًا أصليًا (غير مكتوب بلغات برمجة Kotlin أو Java)، تأكَّد من أنّ تطبيقك يتضمّن مكتبات برمجية أصلية لكل من نظامَي 32 بت و64 بت.

مزيد من المعلومات حول كيفية توفير التوافق مع البنى الأساسية 64 بت

تشغيل تطبيق على ساعة فعلية (اختياري)

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

لتشغيل تطبيق على ساعة، عليك تحضير الجهاز للاختبار ثم ربطه بجهاز التطوير.

تجهيز الساعة للاختبار

لإعداد ساعتك للاختبار، فعِّل ميزة "تصحيح الأخطاء عبر ADB" من خلال إكمال الخطوات التالية:

  1. على الساعة، افتح قائمة الإعدادات.
  2. انتقِل إلى أسفل القائمة. إذا لم يظهر لك خيار خيارات المطوّر، أكمِل الخطوات الفرعية التالية. أو يمكنك المتابعة إلى الخطوة التالية.
    1. انقر على النظام > لمحة أو النظام > لمحة > الإصدارات.
    2. ابحث عن العنصر رقم الإصدار وانقر عليه سبع مرات. إذا كانت ساعتك محمية برقم تعريف شخصي أو نقش، أدخِلها عندما يُطلب منك ذلك.
  3. من قائمة الإعدادات، انقر على خيارات المطوّرين.
  4. فعِّل خيار تصحيح الأخطاء عبر ADB.

توصيل الساعة بجهاز التطوير

تتيح لك بعض الساعات الاتصال عبر USB. وتتطلّب بعض الوظائف الأخرى اتصالاً لاسلكيًا.

إعداد اتصال سلكي عبر USB

اربط الساعة باتّباع الخطوات التالية:

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

إعداد اتصال لاسلكي

إذا لم تتضمّن ساعتك منفذ USB، تعرَّف على كيفية ربط الساعة باستخدام Wi-Fi أو البلوتوث.

تثبيت إصدار معيّن من Wear OS (اختياري)

إذا كان نموذج اختبار تطبيقك يعتمد على إصدار معيّن من Wear OS، يمكنك برمجة صورة برنامج على الساعات التي تتيح الاتصال ببيانات USB (سلكي). مثلاً، يمكنك إعادة تحميل صورة المصنع أو صورة كاملة للتحديث عبر الهواء على ساعة Google Pixel Watch 3 أو Google Pixel Watch 2.

افتح التطبيق على الساعة.

  1. انتقِل إلى تشغيل > اختيار جهاز. اختَر الساعة المتصلة بجهازك.
  2. في شريط أدوات Android Studio، انقر على تشغيل . يبدأ المحاكي ويفتح تطبيقك.
  3. بعد بضع لحظات، من المفترض أن ترى رسالة "مرحبًا..." على الساعة.