Glance Wear

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

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

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

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

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

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

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

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

الملاحظات

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

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

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

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

الإصدار ‎1.0.0-alpha20

‫7 أكتوبر 2026

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

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

• تمت إضافة الثوابت CATEGORY_PROVIDER_CONFIG وEXTRA_CONFIG_WIDGET_ID وEXTRA_CONFIG_PROVIDER_COMPONENT إلى GlanceWearWidget للتعامل مع أغراض إعداد موفّر التطبيق المصغّر. (I32fa4)
• تمت إعادة تسمية المَعلمة useSafeFallbackRendererVersion في WearWidgetPreview إلى useBaselineHostVersion. (I07bca)

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

• تم إصلاح تحديثات التطبيقات المصغّرة في محاكي "درج التطبيقات المصغّرة" عند استدعاء triggerUpdateAll في الإصدارات التي يمكن تصحيح أخطائها. (I22d3f)
• تم تغيير القيمة التلقائية لـ useSafeFallbackRendererVersion في WearWidgetPreview من true إلى false حتى يتم عرض المعاينات باستخدام أحدث إصدار من أداة العرض تلقائيًا. (Ied6b9)

الإصدار ‎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 "الكتابة عن بُعد" لملف تعريف "التطبيقات المصغّرة على Wear". يتيح ذلك 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 من خلال عدم السماح بإرسال محور خط فارغ إلى Player for Glance Wear Widget.

الإصدار ‎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، وبالتالي لم يعُد الإصدار 37 هو الحد الأدنى لمتطلبات compileSdk في هذا الإصدار.

الإصدار ‎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 عندما يكون 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.