Glance Wear

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

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

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

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

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

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

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

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

الملاحظات

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

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

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

الإصدار 1.0 من Glance 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 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 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 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.