Glance Wear

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

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

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

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

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

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

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

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

الملاحظات

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

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

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

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

الإصدار ‎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 هذه التعديلات.

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

• تمت إضافة عمليات فحص lint في 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 Widgets الشخصي. يتيح ذلك RemoteText استخدام ميزات الخطوط المتغيرة، مثل محاور الخطوط وارتفاعات الأسطر وما إلى ذلك، على أدوات العرض المتوافقة مع المضيف، مع التراجع التلقائي عند عدم توفّرها.

الإصلاحات

• تم تعديل مستندات 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 على شكل Squircle لتناسب المعاينة وفقًا لملاحظات تجربة المستخدم.

الإصدار ‎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 Widgets

الإصدار ‎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 المصغّر يمكن للمطوّرين استخدام واجهات برمجة التطبيقات هذه للوصول إلى بيانات صحة النظام.

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

• تم إصلاح مشكلة تكرار الأعطال في الإصدار 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 Widget ليكون على دراية بالتطبيقات المصغّرة أثناء عملية التشغيل.

الإصدار ‎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 Widget المصغّر عندما يكون WearWidgetBrush فارغًا أو غير محدّد (I8300b)
• تعديل واجهة برمجة التطبيقات getActiveWidgets لعرض نوع الحاوية الخاصة بالتطبيق المصغّر (2772eb1)

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

• تعديل واجهة برمجة التطبيقات الخاصة بتحديث أداة تغيير الخلفية لتلقّي 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.