Wear OS 5.1

يتوفّر نظام التشغيل Wear OS 5.1 على أجهزة محدّدة وفي المحاكي الرسمي في استوديو Android. يُرجى التأكّد من أنّ تطبيقك يعمل على النحو المتوقّع بعد أن تعدّل إصدار حزمة تطوير البرامج (SDK) المستهدَف.

يستند نظام التشغيل Wear OS 5.1 إلى Android 15 (المستوى 35 لواجهة برمجة التطبيقات)، ما يتطلّب اختبار تطبيقاتك التي تستهدف حاليًا المستوى 34 لواجهة برمجة التطبيقات في Wear OS 5.

إعداد جهاز متوافق للاختبار

يمكن تشغيل نظام التشغيل Wear OS 5.1 على الأجهزة التالية:

• ‫Google Pixel Watch 3
• ‫Google Pixel Watch 2
• Google Pixel Watch

من المفترض أن يتلقّى جهازك تحديثًا للبرامج عبر اتصال لاسلكي. يمكنك أيضًا تحديث جهازك يدويًا باتّباع أحد الإجراءَين التاليَين:

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

إعداد المحاكي للاختبار

لتشغيل نظام التشغيل Wear OS 5.1 في المحاكي الرسمي، عليك أولاً تنزيل صورة النظام التي يتم تشغيلها على المحاكي وتثبيتها. بعد ذلك، عليك إنشاء جهاز افتراضي يشغّل صورة النظام هذه.

تنزيل صورة النظام وتثبيتها

لتنزيل صورة النظام الصحيحة وتثبيتها، يُرجى اتّباع الخطوات التالية:

1. نزِّل أحدث إصدار من استوديو Android Ladybug Feature Drop أو إصدارًا أحدث وثبِّته إذا لم يسبق لك إجراء ذلك.
2. في استوديو Android، انتقِل إلى الأدوات (Tools) > مدير حزمة تطوير البرامج (SDK Manager).

3. في علامة التبويب منصّات حزمة تطوير البرامج (SDK Platforms)، انقر على عرض تفاصيل الحزمة (Show Package Details) ووسِّع القسم Android 15.0 ‏("VanillaIceCream") الذي يحتوي على البيانات الاصطناعية للمستوى 35 لواجهة برمجة التطبيقات (API level 35-ext15). بعد ذلك، اختَر إما صورة نظام Wear OS 5.1 ARM 64 v8a أو صورة نظام Wear OS 5.1 Intel x86_64 Atom:

   

4. انقر على حسنًا. عند ظهور النافذة تأكيد التغيير (Confirm Change) ، انقر على حسنًا مرة أخرى.

5. انتظِر إلى أن ينتهي استوديو Android من تنزيل صورة النظام وتثبيتها، ثم انقر على إنهاء (Finish).

إنشاء جهاز افتراضي

لإنشاء جهاز افتراضي يشغّل صورة النظام هذه في المحاكي الرسمي، يُرجى اتّباع الخطوات التالية:

1. في استوديو Android، افتح أداة إدارة الأجهزة من خلال النقر على الأدوات (Tools) > مدير الأجهزة (Device Manager). يظهر جزء مدير الأجهزة.
2. في شريط الأدوات ضمن جزء أداة إدارة الأجهزة ، انقر على إضافة جهاز جديد > إنشاء جهاز افتراضي.
3. في جزء شكل الجهاز (Form Factor) ، انقر على Wear OS واختَر ملفًا شخصيًا للأجهزة. وبعد ذلك، انقر على التالي (Next).
4. اختَر صورة نظام Wear OS 5.1 لاستخدامها. يجب أن يكون مستوى واجهة برمجة التطبيقات (API Level) لصورة النظام هو 35.
5. انقر على التالي (Next) ، ثم على إنهاء (Finish).

اختبار تطبيقك على المحاكي

لاختبار تطبيقك على هذا الجهاز الافتراضي الذي أنشأته، يُرجى اتّباع الخطوات التالية:

1. انتقِل إلى شريط أدوات استوديو Android واختَر الجهاز الافتراضي.
2. انقر على تشغيل (Run) .
3. ثبِّت تطبيقك على الجهاز الافتراضي وتنقَّل بين سير العمل المختلفة التي تظهر للمستخدمين في تطبيقك.

التغييرات التي تؤثر في جميع التطبيقات

أثناء اختبار تطبيقك على Wear OS 5.1، تحقَّق من كيفية تعامُل تطبيقك مع التغييرات في سلوك النظام التي تؤثر في جميع التطبيقات في Android 15، الذي يستخدم مستوى واجهة برمجة التطبيقات نفسه الذي يستخدمه Wear OS 5.1.

لا تسري عدة تغييرات في السلوك في Wear OS 5.1:

• المساحات الخاصة غير مدعومة في Wear OS 5.1.
• قد لا تظهر إيماءة إظهار شاشة الرجوع التنبؤية.

تعديل إصدار حزمة تطوير البرامج (SDK) المستهدَف في تطبيقك

يمكنك تحسين توافق تطبيقك مع Wear OS 5.1 من خلال تعديل إصدار حزمة تطوير البرامج (SDK) المستهدَف في تطبيقك إلى المستوى 35 لواجهة برمجة التطبيقات. (هذا هو مستوى واجهة برمجة التطبيقات نفسه الذي يستخدمه Android 15).

لإجراء ذلك، افتح ملف build.gradle أو build.gradle.kts على مستوى الوحدة وعدِّلهما باستخدام قيم Wear OS 5.1.

تعتمد طريقة تنسيق القيم في ملف الإصدار على إصدار مكوّن إضافي لنظام Gradle المتوافق مع Android (AGP) الذي تستخدمه.

الإصدار 7.0.0 من Android Gradle Plugin أو إصدار أحدث

إذا كنت تستخدم الإصدار 7.0.0 من Android Gradle Plugin أو إصدارًا أحدث، عدِّل ملف build.gradle أو build.gradle.kts في تطبيقك باستخدام القيم التالية لنظام التشغيل Wear OS 5.1:

أنيق

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

Kotlin

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

الإصدار 4.2.0 من Android Gradle Plugin أو إصدار أقدم

إذا كنت تستخدم الإصدار 4.2.0 من Android Gradle Plugin أو إصدارًا أقدم، عدِّل ملف تطبيقك build.gradle أو build.gradle.kts باستخدام القيم التالية لنظام التشغيل Wear OS 5.1:

أنيق

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

Kotlin

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

التغييرات التي تؤثر فقط في التطبيقات التي تستهدف المستوى 35 لواجهة برمجة التطبيقات

بعد تعديل إصدار حزمة تطوير البرامج (SDK) المستهدَف إلى المستوى 35 لواجهة برمجة التطبيقات، عليك التعامل مع التغييرات التي تطرأ على التطبيقات التي تستهدف Android 15، الذي يستخدم مستوى واجهة برمجة التطبيقات نفسه الذي يستخدمه Wear OS 5.1.

ميزات جديدة بانتظارك

يقدّم نظام التشغيل Wear OS 5.1 عدة ميزات للمساعدة في تحسين تجربة استخدام تطبيق Wear OS.

**ملاحظة:** قبل إضافة هذه الميزات إلى تطبيقك، عليك إعداده للتعامل مع التغييرات في السلوك التي يقدّمها نظام التشغيل Wear OS 5.1.

تشمل الميزات البارزة التي يمكنك استكشافها ما يلي:

• دعم "مدير بيانات الاعتماد": توفّر واجهة برمجة التطبيقات Credential Manager API حلاً موحّدًا للمصادقة، ما يتيح سير عمل تسجيل الدخول باستخدام كلمات المرور، مفاتيح المرور والهوية الموحّدة (مثل "تسجيل الدخول باستخدام حساب Google"). يتم تخزين بيانات اعتماد المستخدم في موفّر بيانات الاعتماد الذي يزامِن معلومات الحساب على جميع الأجهزة.
• تشغيل الصوت على مكبّر صوت الساعة: على الأجهزة التي تتيح تشغيل الوسائط من خلال مكبّر صوت الساعة، يمكن للمستخدمين اختيار هذا المكبّر كخيار إخراج الوسائط المفضّل إذا كان تطبيقك متكاملاً مع أداة تبديل الإخراج في Wear.

ملاحظات الإصدار

تتّسم أحدث صورة نظام لنظام التشغيل Wear OS 5.1، المتوفّرة على الأجهزة المتوافقة وعلى المحاكي، بالخصائص التالية:

تاريخ الإصدار	18 مارس 2025 لأجهزة Google Pixel Watch 3 LTE وGoogle Pixel Watch 2 LTE وGoogle Pixel Watch (الإصدارَين Bluetooth/Wi-Fi وLTE) ‫4 مارس 2025 لأجهزة Google Pixel Watch 3 Bluetooth/Wi-Fi و Google Pixel Watch 2 Bluetooth/Wi-Fi
الإصدار	‫BP1A.250305.019.W3 على Google Pixel Watch 3 و Google Pixel Watch 2 ‫BP1A.250305.019.W2 على Google Pixel Watch ‫AP4A.241205.004.F4 على المحاكي
دعم المحاكي	‫x86 (64 بت)، ARM (الإصدار v8-A)

المشاكل المعروفة

تحتوي صورة النظام التي تتضمّن نظام التشغيل Wear OS 5.1 على المشاكل المعروفة التالية:

• لا يسمح المحاكي للمستخدم دائمًا بإضافة حساب أثناء سير عمل الإعداد بعد إعادة ضبط الجهاز.
• عند النقر على إشعار، لا يتم فتح التطبيق الذي أرسل الإشعار إلا بعد أن يمرّر المستخدم الشاشة.
• في بعض الأحيان، يتعذّر على "خدمات Wear الصحية" بدء تمرين.
• إذا وصلت إلى مكتبتَي androidx.wear.tiles أو androidx.wear:wear-phone-interactions ضمن تطبيق يستهدف المستوى 35 لواجهة برمجة التطبيقات، قد يحدث خطأ SecurityException. لحلّ هذه المشكلة، يمكنك الترقية إلى androidx.wear.tiles 1.5.0-alpha05 أو إصدار أحدث، أو androidx.wear:wear-phone-interactions 1.1.0 أو إصدار أحدث.