Glance Wear

  
‫Glance Wear هي مكتبة لإنشاء تطبيقات مصغّرة لنظام التشغيل Wear OS
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫23 سبتمبر 2026 - - - 1.0.0-alpha19

تحديد الاعتماديات

لإضافة اعتمادية على glance-wear، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

Groovy

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha19"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha19"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha19")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha19")
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.0 من Glance Wear

الإصدار ‎1.0.0-alpha19

‫23 سبتمبر 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha19 وandroidx.glance.wear:wear-core:1.0.0-alpha19 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha19. يتضمّن الإصدار ‎1.0.0-alpha19 هذه التعديلات.

تغييرات الاختبار الداخلي فقط

الإصدار ‎1.0.0-alpha18

‫9 سبتمبر 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha18 وandroidx.glance.wear:wear-core:1.0.0-alpha18 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha18. يتضمّن الإصدار ‎1.0.0-alpha18 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة المَعلمة useSafeFallbackRendererVersion إلى WearWidgetPreview للسماح بمعاينة التطبيقات المصغّرة باستخدام مجموعة احتياطية آمنة من العمليات المتوافقة مع المضيفين القدامى. (I9c324)

إصلاح الأخطاء

  • تم تعديل compileSdk لمكتبات Compose إلى الإصدار 37.1. سيتطلّب ذلك تعديل compileSdk بشكل متعدٍّ لجميع التطبيقات والمكتبات التي تستخدم Compose. (I05b0f)
  • تمت إضافة عملية فحص lint للتحذير من الاستخدامات المكرّرة للمَعلمة fontFamily في تطبيقات Wear المصغّرة. (I7730c)

الإصدار ‎1.0.0-alpha17

‫26 أغسطس 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha17 وandroidx.glance.wear:wear-core:1.0.0-alpha17 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha17. يتضمّن الإصدار ‎1.0.0-alpha17 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة عمليات التحقّق من الأخطاء في Glance Wear لفرض أنّ كل <container> في ملف <wearwidget-provider> XML الخاص بالبيانات الوصفية للتطبيق المصغّر يحدّد بشكل صريح سمة نوع متوافقة ولا يحدّد أنواعًا مكرّرة. (I52c9a، b/464458215)

الإصدار ‎1.0.0-alpha16

‫12 أغسطس 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha16 وandroidx.glance.wear:wear-core:1.0.0-alpha16 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha16. يتضمّن الإصدار ‎1.0.0-alpha16 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة عملية تدقيق Lint للبيانات الوصفية بتنسيق <wearwidget-provider> XML لضمان توفّر عناصر الإعداد المطلوبة (مثل container وpreviewImage). (Ia9983، b/464458215)
  • تمت إضافة تحذير خطأ Lint عند ضبط خلفية سوداء أو شفافة لأداة Wear (Idedb0، b/529269573)
  • تم تفعيل عملية CORE_TEXT Remote Compose لملف Wear Widgets الشخصي. يتيح ذلك RemoteText استخدام ميزات الخطوط المتغيرة، مثل محاور الخطوط وارتفاعات الأسطر وما إلى ذلك، على أدوات العرض المتوافقة مع Host، مع التراجع التلقائي عند عدم توفّرها.

الإصلاحات

  • تعديل مستندات KDoc الخاصة بالتعليق التوضيحي AssociateWithGlanceWearWidget استنادًا إلى ملاحظات المطوّرين

الإصدار ‎1.0.0-alpha15

‫29 يوليو 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha15 وandroidx.glance.wear:wear-core:1.0.0-alpha15 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha15. يتضمّن الإصدار ‎1.0.0-alpha15 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة تحذير Lint عند ضبط خلفية فارغة لمستند Wear Widget. (Ic6475، b/529269573)

الإصدار ‎1.0.0-alpha14

‫15 يوليو 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha14 وandroidx.glance.wear:wear-core:1.0.0-alpha14 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha14. يتضمّن الإصدار ‎1.0.0-alpha14 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • أضفنا موفّري مَعلمات المعاينة RoundAllWidgetPreviewParams وRoundSmallWidgetPreviewParams وRoundLargeWidgetPreviewParams لتوفير تطبيقات مصغّرة متكاملة في Glance Wear. (If5336، b/512405233)

الميزات الجديدة

  • لقد أعددنا وأضفنا مكتبة Linter إلى أدوات Glance Wear.(If4218، b/527402079)
    • تمت إضافة عملية فحص باستخدام أداة Lint للتأكّد من أنّ الفئات الفرعية من GlanceWearWidgetService تعرّف بوضوح فئة التطبيق المصغّر المرتبطة بها باستخدام التعليق التوضيحي @AssociateWithGlanceWearWidget. (Idc575، b/477024153)
  • لقد حسّنّا التوافق مع الإصدارات القديمة للأدوات التي تعمل على مضيفات أقدم من خلال نشر العمليات المتوافقة عبر WearWidgetParams وإضافة فلترة ملف العمليات المسموح بها إلى تلك العمليات. (Ib0a1b وI83cb1 و[b/526716195])

الإصدار ‎1.0.0-alpha13

‫01 يوليو 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha13 وandroidx.glance.wear:wear-core:1.0.0-alpha13 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha13. يتضمّن الإصدار ‎1.0.0-alpha13 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تمت إزالة عملية التحقّق من الأذونات من heartRateAccuracy (I14269، b/522444636)

إصلاح الأخطاء

  • عدّلنا مَعلمات أداة Wear على شكل دائرة مربّعة بناءً على ملاحظات تجربة المستخدم.

الإصدار ‎1.0.0-alpha12

‫17 يونيو 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha12 وandroidx.glance.wear:wear-core:1.0.0-alpha12 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha12. يتضمّن الإصدار ‎1.0.0-alpha12 هذه التعديلات.

الميزات الجديدة

  • تمت إضافة AssociateWithGlanceWearWidget التي يجب استخدامها في GlanceWearWidgetService لتحديد عملية تنفيذ GlanceWearWidget المرتبطة بها. (Ifcabb، b/514679763)

    • على سبيل المثال:
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • أضفنا أداة image إلى WearWidgetBrush لإتاحة استخدام خلفيات نقطية في تطبيقات Wear Widgets المصغّرة. (I9a228، b/513481558)

  • لقد أضفنا دالة مساعِدة @Composable، وهي WearWidgetPreview، لتبسيط عملية التطوير لتطبيقات Glance Wear المصغّرة من خلال إزالة الرمز النموذجي المطلوب لمعاينات IDE.

التغييرات في واجهة برمجة التطبيقات

  • تغيّر اسم androidx.glance.wear.health.DataType إلى androidx.glance.wear.health.HealthData (I4cb0b، b/516746689)
  • يتم عرض isHeartRateBpmAvailable لتحديد ما إذا كان heartRateBpm متاحًا على المضيف. (I5999d، b/514641567)
  • تم عرض عوامل تشغيل RemoteInt المقارنة. (I5fe3d، b/513228889)
  • تم عرض captureRemoteDocument Flow API وcaptureSingleRemoteDocument overload جديد (يستقبل RemoteCreationDisplayInfo) كواجهات برمجة تطبيقات عامة. (I87b0e، b/513228889)
  • أضفنا @CallSuper إلى طرق دورة الحياة GlanceWearWidgetService

الإصدار ‎1.0.0-alpha11

‫3 يونيو 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha11 وandroidx.glance.wear:wear-core:1.0.0-alpha11 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha11. يتضمّن الإصدار ‎1.0.0-alpha11 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • أضفنا WearWidgetPreview لمعاينة تطبيقات Wear المصغّرة في "استوديو Android". (I36504، b/485147770)
  • عرض المتغيّرات is*Available (isDailyStepsAvailable وما إلى ذلك) للتحقّق مما إذا كان نوع البيانات الصحية ذي الصلة متاحًا وصالحًا (Ib98a7، b/498179656)
  • تمت إضافة واجهة برمجة التطبيقات triggerUpdateAll إلى GlanceWearWidget لتفعيل التحديث على جميع التطبيقات المصغّرة للتطبيق المحدّد. (I6ab20، b/510896410)

إصلاح الأخطاء

  • أدرِج معلومات حول إصدار Renderer في WearWidgetParams كحقل داخلي لمنع حدوث مشاكل في المستند الذي تم إنشاؤه باستخدام الإصدار alpha10. (Idcf8e وb/511263591 وb/512830184)
  • تفعيل مسار التحديث الإجباري في وضع تصحيح الأخطاء أو المحاكي لتطبيقات Wear المصغّرة

الإصدار ‎1.0.0-alpha10

‫19 مايو 2026

تم طرح ميزات androidx.glance.wear:wear:1.0.0-alpha10 وandroidx.glance.wear:wear-core:1.0.0-alpha10 وandroidx.glance.wear:wear-tooling-preview:1.0.0-alpha10. يتضمّن الإصدار ‎1.0.0-alpha10 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • عرض واجهات برمجة التطبيقات glance.wear.health.DataType في تطبيق Wear Widget يمكن للمطوّرين استخدام واجهات برمجة التطبيقات هذه للوصول إلى بيانات صحة النظام.

إصلاح الأخطاء

  • تم إصلاح مشكلة تكرار الأعطال في الإصدار alpha09 على محاكي Wear 7 أو الأجهزة التي تستخدم أداة العرض 1.6 من خلال عدم السماح بإرسال محور خط فارغ إلى "مشغّل أدوات Glance Wear".

الإصدار ‎1.0.0-alpha09

‫6 مايو 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha09 وandroidx.glance.wear:wear-core:1.0.0-alpha09. يتضمّن الإصدار ‎1.0.0-alpha09 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • لقد أضفنا ExperimentalGlanceWearApi الذي سيتم استخدامه لميزات Glance Wear التجريبية. (Id2f76، b/498179813)

إصلاح الأخطاء

  • تم تعديل المحلّل الخاص بالبيانات الوصفية بتنسيق XML لتطبيق Wear المصغّر ليكون على دراية بالتطبيقات المصغّرة أثناء عملية التشغيل.

الإصدار ‎1.0.0-alpha08

‫22 أبريل 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha08 وandroidx.glance.wear:wear-core:1.0.0-alpha08. يتضمّن الإصدار ‎1.0.0-alpha08 هذه التعديلات.

إصلاح الأخطاء

  • تمت إضافة العلامة <queries> إلى بيان مكتبة glance:wear:wear للتأكّد من أنّ PackageManager يستعلم عن الخدمات الصحيحة للحصول على إشعارات فورية. (I192787)

غير ذلك

  • تمت إعادة الإصدار "تعديل compileSdk في Compose إلى 37" (I6007) الذي ينطبق أيضًا على glance-wear، وبالتالي لم يعُد الإصدار الحالي يتطلّب compileSdk 37.

الإصدار ‎1.0.0-alpha07

‫8 أبريل 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha07 وandroidx.glance.wear:wear-core:1.0.0-alpha07. يتضمّن الإصدار ‎1.0.0-alpha07 هذه التعديلات.

الميزات الجديدة

  • إضافة خلفية تلقائية لتطبيق Wear Widget المصغّر عندما يكون WearWidgetBrush فارغًا أو غير محدّد (I8300b)
  • تعديل واجهة برمجة التطبيقات getActiveWidgets لعرض نوع الحاوية الخاصة بالتطبيق المصغّر (2772eb1)

التغييرات في واجهة برمجة التطبيقات

  • تعديل واجهة برمجة التطبيقات Change Widget update API لتلقّي WidgetInstanceId وإضافة أداة مساعدة لاسترداد أرقام التعريف الخاصة بأداة معيّنة تعرض واجهة برمجة التطبيقات الجديدة الخطأ IllegalArgumentException إذا كان المعرّف المقدَّم غير صالح أو لا يملكه المتصل. (I6f3c5، b/446828899)
  • أضِف تدرّجًا عموديًا وأفقيًا في WearWidgetBrush. (If70ae، b/470080675)

الإصدار ‎1.0.0-alpha06

‫25 مارس 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha06 وandroidx.glance.wear:wear-core:1.0.0-alpha06. يتضمّن الإصدار ‎1.0.0-alpha06 هذه التعديلات.

الميزات الجديدة

  • تحديد العمليات لملف Wear Widgets الشخصي مضمّنًا

التغييرات في واجهة برمجة التطبيقات

  • لقد غيّرنا اسم CONTAINER_TYPE_FULLSCREEN إلى CONTAINER_TYPE_TILE_COMPAT لتمييز التطبيق المصغّر للتوافق مع وضع ملء الشاشة بشكل أفضل. ويشمل ذلك الرجوع عن ربط النوع FULLSCREEN سابقًا بالنوع LARGE في مَعلمات الأداة.

الإصدار ‎1.0.0-alpha05

‫11 مارس 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha05 وandroidx.glance.wear:wear-core:1.0.0-alpha05. يتضمّن الإصدار ‎1.0.0-alpha05 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • أضفنا WearWidgetBrushواجهة برمجة تطبيقات تستخدم طريقة color لاستخدامها في خلفية أداة Wear. (I66f54، b/464273091)
  • تمت إزالة طريقة fetchActiveWidgetsForProvider لأنّ fetchActiveWidgets متوفّرة حاليًا. (I85e4e، b/486197890)

الإصدار ‎1.0.0-alpha04

‫25 فبراير 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha04 وandroidx.glance.wear:wear-core:1.0.0-alpha04. يتضمّن الإصدار ‎1.0.0-alpha04 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة واجهة برمجة تطبيقات GlanceWearWidgetManager للسماح للتطبيقات بالبحث عن التطبيقات المصغّرة واللوحات النشطة. (I5be95)
  • لقد نقلنا واجهات برمجة التطبيقات من مكتبة glance:wear:wear-core إلى حزمة androidx.glance.wear.core. (I429cf)

إصلاح الأخطاء

  • عرض الأنواع الشائعة من Remote Composable وModifier (Id1d40)

الإصدار ‎1.0.0-alpha03

‫11 فبراير 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha03 وandroidx.glance.wear:wear-core:1.0.0-alpha03. يتضمّن الإصدار ‎1.0.0-alpha03 هذه التعديلات.

التغييرات في واجهة برمجة التطبيقات

  • إضافة إمكانية استخدام أحداث التفاعل في GlanceWearWidget (Ia4e28، b/469808447)

الإصدار ‎1.0.0-alpha02

‫28 يناير 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha02 وandroidx.glance.wear:wear-core:1.0.0-alpha02. يتضمّن الإصدار ‎1.0.0-alpha02 هذه التعديلات.

الميزات الجديدة

  • إعادة ربط FULLSCREEN بـ LARGE في مَعلمات التطبيق المصغّر (ad78d95)

إصلاح الأخطاء

  • تم إصلاح مشكلة استخدام DataStore التي كانت تمنع عرض عدة مثيلات للتطبيق المصغّر (474f3e4)

الإصدار ‎1.0.0-alpha01

‫14 يناير 2026

تم طرح androidx.glance.wear:wear:1.0.0-alpha01 وandroidx.glance.wear:wear-core:1.0.0-alpha01. يتضمّن الإصدار ‎1.0.0-alpha01 هذه التعديلات.

  • ‫Glance Wear هي مكتبة لإنشاء تطبيقات مصغّرة لنظام التشغيل Wear OS باستخدام RemoteCompose.