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. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على الـ مشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

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

يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

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

الإصدار ‎1.0.0-alpha18

‫14 سبتمبر 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

‫31 أغسطس 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> في ملف XML <wearwidget-provider> للبيانات الوصفية للأداة بشكل صريح سمة نوع متوافقة ولا تحدّد أنواعًا مكرّرة. (I52c9a, b/464458215)

الإصدار ‎1.0.0-alpha16

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

الإصلاحات

• تم تعديل مستندات KDoc للإضافة التوضيحية AssociateWithGlanceWearWidget وفقًا لملاحظات المطوّرين.

الإصدار ‎1.0.0-alpha15

‫2 أغسطس 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. (Ic6475, b/529269573)

الإصدار ‎1.0.0-alpha14

‫19 يوليو 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

‫5 يوليو 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

‫21 يونيو 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. (I9a228, b/513481558)

• لقد طرحنا دالة مساعِدة @Composable، هي WearWidgetPreview، لتبسيط عملية تطوير أدوات Glance Wear من خلال إزالة التعليمات البرمجية المتكرّرة المطلوبة لمعاينات بيئة التطوير المتكاملة.

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

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

الإصدار ‎1.0.0-alpha11

‫8 يونيو 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)

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

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

الإصدار ‎1.0.0-alpha10

‫24 مايو 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

‫10 مايو 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

‫26 أبريل 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

‫12 أبريل 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)

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

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

الإصدار ‎1.0.0-alpha06

‫29 مارس 2026

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

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

• تحديد عمليات ملف شخصي لأدوات Wear مضمّنة.

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

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

الإصدار ‎1.0.0-alpha05

‫15 مارس 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

‫1 مارس 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

‫15 فبراير 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

‫31 يناير 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

‫18 يناير 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.