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

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

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

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

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

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

  4. انتقِل إلى الأدوات > مدير حزمة SDK، وانقر على عرض تفاصيل الحزمة، ثم ثبِّت الحِزم التالية:

    • ‫Android 15.0‏ (VanillaIceCream) (المستوى 35 لواجهة برمجة التطبيقات-ext15)، والذي يتضمّن صورة نظام Wear OS 5.1 ARM 64 v8a و صورة نظام Wear OS 5.1 Intel x86 Atom_64.
    • ‫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. أغلِق "مدير حزمة تطوير البرامج (SDK)".
  2. انتقِل إلى الأدوات > إدارة الأجهزة.
  3. انقر على إنشاء (+). سيظهر معالج إعداد الجهاز الافتراضي.
  4. في لوحة الفئة، اختَر Wear OS واختَر ملفًا شخصيًا للأجهزة، مثل Wear OS Small Round. انقر على التالي.

  5. بالنسبة إلى صور النظام المستخدَمة خارج الصين، اختَر اسم الإصدار UpsideDownCake. يستهدف هذا الإصدار نظام التشغيل Android 14.0 (Wear OS 5). بالنسبة إلى صور النظام المستخدَمة في الصين، اختَر اسم الإصدار R. يستهدف هذا الإصدار نظام التشغيل Android 11.0 (Wear OS 3). إذا لم يكن لديك صورة نظام 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 أو الإصدارات الأحدث، يتيح المحاكي استخدام البلوتوث المحاكى، ما يسمح لك باختبار الصوت عبر البلوتوث في العديد من حالات الاستخدام.

لا تتوافق صور النظام الحديثة إلا مع بنى 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 (سلكي). على سبيل المثال، يمكنك تثبيت صورة المصنع أو صورة OTA الكاملة على ساعة Google Pixel Watch 3 أو Google Pixel Watch 2.

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

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