نظرة سريعة

إنشاء تصاميم لمساحات عرض عن بُعد باستخدام واجهة برمجة تطبيقات بتصميم Jetpack Compose
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫01 يوليو 2026 1.1.1 1.2.0-rc01 - 1.3.0-alpha02

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

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

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

Groovy

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.3.0-alpha02"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.3.0-alpha02"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha07"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    // For Glance support
    implementation("androidx.glance:glance:1.3.0-alpha02")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.3.0-alpha02")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha07")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

الملاحظات

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

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

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

الإصدار 1.3

الإصدار 1.3.0-alpha02

‫01 يوليو 2026

تم طرح androidx.glance:glance-*:1.3.0-alpha02. يتضمّن الإصدار 1.3.0-alpha02 هذه التعديلات.

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

  • لدى "androidx.benchmark" الآن minSdk يبلغ 24. (Ic2a85)
  • إزالة عملية التحقّق من الأذونات من heartRateAccuracy (I14269، b/522444636)
  • إعادة تسمية "androidx.glance.wear.health.DataType" إلى "androidx.glance.wear.health.HealthData" (I4cb0b، b/516746689)
  • تمت إضافة AssociateWithGlanceWearWidget التي يجب استخدامها في GlanceWearWidgetService لتحديد عملية تنفيذ GlanceWearWidget المرتبطة بها. على سبيل المثال: @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)\n class MyGlanceWearWidgetService : GlanceWearWidgetService() {\n override val widget = MyGlanceWearWidget()\n } (Ifcabb، b/514679763)
  • أضِف فرشاة image إلى WearWidgetBrush لتوفير إمكانية استخدام خلفيات نقطية في "تطبيقات Wear المصغّرة". (I9a228، b/513481558)
  • عرض isHeartRateBpmAvailable لتحديد ما إذا كان heartRateBpm متاحًا على المضيف (I5999d، b/514641567)
  • عرض عوامل تشغيل RemoteInt المقارنة (I5fe3d، b/513228889)
  • تم عرض captureRemoteDocument Flow API وcaptureSingleRemoteDocument overload جديد (يستقبل RemoteCreationDisplayInfo) كواجهات برمجة تطبيقات عامة. (I87b0e، b/513228889)
  • تمت إتاحة معاينات PendingIntentAction في بيئات التطوير المتكاملة (IDE) من خلال تأجيل الوصول إلى PendingIntent باستخدام تعبير lambda وإرجاع إجراء لا يؤدي إلى أي عملية في وضع المعاينة. (I43b37، b/512403924)
  • إزالة الثابت غير المستخدَم للتمرير السريع (Ib6df6)
  • إضافة WearWidgetPreview لمعاينة تطبيق Wear المصغّر في "استوديو Android" (I36504 وb/485147770)
  • عرض متغيرات is*Available للتحقّق مما إذا كان نوع البيانات ذي الصلة متاحًا وصالحًا. (Ib98a7، b/498179656)
  • تمت إضافة واجهة برمجة التطبيقات triggerUpdateAll إلى GlanceWearWidget. (I6ab20، b/510896410)

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

  • نقل LocalInspectionMode إلى مرحلة الالتقاط عن بُعد في Compose (I6a56b، b/512403924)
  • تضمين معلومات إصدار مخطط العرض في WearWidgetParams (Idcf8e، b/511263591، b/512830184)

الإصدار 1.3.0-alpha01

‫19 مايو 2026

تم طرح androidx.glance:glance-*:1.3.0-alpha01. يتضمّن الإصدار 1.3.0-alpha01 هذه التعديلات.

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

  • عرض واجهات برمجة التطبيقات glance.wear.health.DataType في تطبيق Wear Widget (Id0d4b، b/498179813)
  • إضافة معاينة جديدة لأدوات Wear في المجموعة androidx.glance.wear (Ibdc9c، b/485147770)
  • ‫Expose ExperimentalGlanceWearApi الذي سيتم استخدامه لميزات Glance Wear التجريبية (Id2f76، b/498179813)
  • زيادة رقم إصدار واجهة برمجة التطبيقات وCompose عن بُعد بمقدار 1 في Glance (Ia4ea3)
  • تعديل واجهة برمجة التطبيقات الخاصة بتحديث أداة تغيير الخلفية لتلقّي WidgetInstanceId وإضافة أداة مساعدة لاسترداد أرقام التعريف الخاصة بأداة معيّنة تعرض واجهة برمجة التطبيقات الجديدة الخطأ IllegalArgumentException إذا كان المعرّف المقدَّم غير صالح أو لا يملكه المتصل. (I6f3c5، b/446828899)
  • أضِف تدرّجًا عموديًا وأفقيًا في WearWidgetBrush. (If70ae، b/470080675)
  • تمّت إعادة تسمية CONTAINER_TYPE_FULLSCREEN إلى CONTAINER_TYPE_TILE_COMPAT. (I6c1dd)
  • استبدِل WearWidgetBrush بخلفية تطبيق Wear Widget. (I66f54، b/464273091)
  • غيِّر محاذاة RemoteBox لقبول RemoteAlignment واحد. (I0bfbf، b/471212869)
  • إزالة واجهة برمجة التطبيقات fetchActiveWidgetsForProvider (I85e4e، b/486197890)
  • عرض GlanceWearWidgetManager للسماح للتطبيقات بالبحث عن التطبيقات المصغّرة واللوحات النشطة (I5be95، b/429980862)
  • عرض الأنواع الشائعة من Remote Composable وModifier (Id1d40)
  • انقل واجهات برمجة التطبيقات في glance:wear:wear-core إلى الحزمة androidx.glance.wear.core. (I429cf)
  • إضافة إمكانية استخدام "أحداث التفاعل" في GlanceWearWidget (Ia4e28، b/469808447)
  • إضافة إمكانية التمرير السريع عند استخدام ميزة "إنشاء عن بُعد" (I0ca9d)
  • عرض الحد الأدنى من واجهة برمجة التطبيقات العامة لبنية Glance Wear الأساسية (I7b4b9، b/467532762)
  • إرجاع CapturedDocument من captureSingleRemoteDocument (I5a283، b/467532762)
  • إضافة واجهة برمجة تطبيقات للون خلفية التطبيق المصغّر على Wear وتحديد محتوى التطبيق المصغّر على أنّه خاص (I98d9a، b/449785790)
  • إتاحة واجهة برمجة تطبيقات أساسية لإنشاء المستندات (I755a2)
  • عرض أنواع الحاويات كموارد عامة (Iff47f)
  • أضِف تعليقًا توضيحيًا @Throws غير متوفّر. (Id20f3)
  • تقديم WidgetInstanceId (I14375)
  • أضِف تعليقًا توضيحيًا إلى دوال الحصول على WearWidgetParams. (I78c01، b/449785790)
  • إعادة تسمية WearWidgetRequest إلى WearWidgetParams (I2d4e0، b/462031396)
  • تمّت إعادة تسمية WearWidgetContent إلى WearWidgetDocument. (Ifa006، b/462031396)

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

  • تم تعديل Compose compileSdk إلى الإصدار 37 من واجهة برمجة التطبيقات. وهذا يعني أنّه يجب توفُّر الإصدار 9.2.0 أو إصدار أحدث من "مكوّن Android الإضافي" عند استخدام Compose. (Id45cd، b/413674743)
  • إضافة خلفية تلقائية لتطبيق Wear Widget المصغّر عندما يكون WearWidgetBrush فارغًا أو غير محدّد (I8300b)
  • إضافة واجهة برمجة تطبيقات لرسم خلفية التطبيق المصغّر على Wear OS (Id883e، b/449785790)

الإصدار 1.2

الإصدار 1.2.0-rc01

‫3 ديسمبر 2025

تم طرح androidx.glance:glance-*:1.2.0-rc01. يتضمّن الإصدار 1.2.0-rc01 هذه التعديلات.

الإصدار 1.2.0-beta01

‫27 أغسطس 2025

تم طرح androidx.glance:glance-*:1.2.0-beta01. يتضمّن الإصدار 1.2.0-beta01 هذه التعديلات.

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

الإصدار 1.2.0-alpha01

‫7 مايو 2025

تم طرح androidx.glance:glance-*:1.2.0-alpha01. يتضمّن الإصدار 1.2.0-alpha01 هذه التعديلات.

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

  • تم إيقاف currentCompositeKeyHash نهائيًا. يمكنك استخدام currentCompositeKeyHashCode كبديل. تشفّر واجهة برمجة التطبيقات البديلة التجزئة نفسها باستخدام عدد أكبر من وحدات البت، ما يقلّل بشكل كبير من احتمال أن يكون لمجموعتين عشوائيتين غير مرتبطتين في التسلسل الهرمي للتركيب مفتاح تجزئة نفسه.(I4cb6a، b/177562901)
  • تضيف هذه الحزمة واجهة برمجة تطبيقات جديدة لتحديد قيمة قناة ألفا (من 0f إلى 1f) للعنصر القابل للإنشاء Image الخاص بنظرة سريعة ومعدِّل صورة الخلفية. في حال عدم تحديدها، يتم الاحتفاظ بقناة ألفا من الصورة المصدر. (I8ad05)
  • إضافة واجهات برمجة تطبيقات Glance للمعاينات التي تم إنشاؤها استخدِم GlanceAppWidget.providePreview لتوفير تخطيط معاينة للأداة. بعد ذلك، اتّصِل بالرقم GlanceAppWidgetManager.setWidgetPreview لإعداد المعاينة. (Iced16)
  • إضافة MultiProcessGlanceAppWidget لدعم إعدادات العمليات المتعددة (Idbb90)
  • إزالة العلامة التجريبية، وأصبحنا الآن نتيح استخدام تعابير lambda (I74d98، b/299361317)
  • السماح بتحديد مستقبِل lambda لـ GlanceAppWidget.runComposition (I84829)
  • إضافة المَعلمة previewSize إلى requestPinGlanceAppWidget (I9f8f0، b/303256067)

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

  • تمت إزالة التحديد اليدوي لإمكانية الوصول إلى واجهات برمجة التطبيقات الجديدة للمنصة، لأنّ ذلك يحدث تلقائيًا من خلال تصميم واجهة برمجة التطبيقات عند استخدام R8 مع الإصدار 7.3 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (AGP) (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من AGP (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون المكوّن الإضافي لنظام Gradle المتوافق مع Android‏ (AGP) بالترقية إلى الإصدار 8.1 من D8 أو إصدار أحدث. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (If6b4c، b/345472586)
  • تحديث مكتبات glance-appwidget إلى الإصدار compileSdk 35 (I2e26b)

الإصدار 1.1

الإصدار 1.1.1

‫16 أكتوبر 2024

تم طرح androidx.glance:glance-*:1.1.1. يتضمّن الإصدار 1.1.1 هذه التعديلات.

إصلاحات الأمان

  • اعتبارًا من هذا التغيير، يتم تجميع androidx مع الإصدار 4.28.2 من protobuf من أجل معالجة CVE-2024-7254. عليك ترقية الاعتماد على الإصدار 1.1.0 من androidx.glance:glance-appwidget-proto وandroidx.glance:glance-appwidget-external-protobuf إلى الإصدار 1.1.1 لمعالجة مخاطر الثغرة الأمنية.

الإصدار 1.1.0

‫12 يونيو 2024

تم طرح androidx.glance:glance-*:1.1.0. يتضمّن الإصدار 1.1.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.0.0

  • نقل Glance إلى الإصدار الثابت 1.1.0

الإصدار 1.1.0-rc01

‫14 مايو 2024

تم طرح androidx.glance:glance-*:1.1.0-rc01. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

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

  • تمت إضافة مَعلمتَي العرض والارتفاع إلى تعليقات توضيحية خاصة بالمعاينة في Glance. نقل الإصدار 1.1.0 إلى الإصدار المحتمل

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

  • تضيف هذه السمة مَعلمة اختيارية إلى Scaffold. (If753f)
  • أضِف مَعلمتَي العرض والارتفاع إلى Glance @Preview. (Ibabe8)
  • إزالة إمكانية معاينة مربّعات "لمحة" على أجهزة Wear OS (I3850a)
  • تمت إضافة واجهة برمجة تطبيقات لضبط قيم الأوزان المخصّصة لـ FontStyle. (I7390a)
  • إعادة تسمية تعدادات ImplementationMode في Viewfinder لتعكس بشكل أفضل عمليات التنفيذ الأساسية، وإضافة ثوابت ثابتة لـ TransformationInfo.sourceRotation (Ic6149)

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

  • تم إصلاح الخطأ الذي تسبّب في مشاكل العرض في ViewGroups في وضع التوافق مع الأنظمة القديمة (I8de92)

المساهمة الخارجية

الإصدار 1.1.0-beta02

‫17 أبريل 2024

تم طرح androidx.glance:glance-*:1.1.0-beta02. يحتوي هذا الإصدار على ملفات JAR المصدر التي لم تكن مضمّنة في الإصدار السابق.

الإصدار 1.1.0-beta01

‫3 أبريل 2024

تم طرح androidx.glance:glance-*:1.1.0-beta01. يتضمّن الإصدار 1.1.0-beta01 هذه التعديلات.

الإصدار ‎1.1.0-alpha01

‫7 فبراير 2024

تم طرح androidx.glance:glance-*:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

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

  • مكتبة اختبار الوحدات في Glance التي لا تتطلّب استخدام UI Automator يمكن اختبار رمز Glance مباشرةً بدون الحاجة إلى تضخيم طريقة العرض.
  • مكوّنات ذات مستوى أعلى لتصميمات أبسط
  • خيارات جديدة للمعدّلات والسمات
  • واجهة برمجة تطبيقات جديدة للحصول على سلسلة من RemoteViews من تركيبة، runComposition

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

  • تضيف هذه السمة دور لون widgetBackground جديدًا إلى مظاهر Glance. (Ia2ab8)
  • إضافة GlanceAppWidget.runComposition (I6344c، b/298066147)
  • إضافة مكوّن TopBar جديد (Ibd361)
  • تضيف هذه السمة عمليات إلغاء إلى المعدِّل clickable. (Iacecf)
  • تضيف هذه السمة واجهة برمجة تطبيقات جديدة لتلوين الأزرار. يجب أن تكون هذه الميزة تجريبية إلى أن يتم إصدار الإصدار 1.0. (I92523)
  • تضيف هذه السمة runGlanceAppWidgetUnitTest التي توفّر نطاقًا لاستدعاء طرق في GlanceAppWidgetUnitTest، مثل provideComposable لتوفير عنصر صغير قابل للإنشاء ومعزول للاختبار، وonNode للعثور على عنصر Glance قابل للإنشاء في المحتوى المقدَّم. يتيح لك ذلك كتابة اختبارات وحدة للدوال الفردية القابلة للإنشاء في AppWidget للتحقّق من أنّ الدالة تعرض المجموعة المطلوبة من عناصر Glance القابلة للإنشاء عند توفير مدخلات معيّنة. (I2f682)
  • تضيف هذه السمة المعدِّل testTag في الدلالات لاستخدامه في اختبارات الوحدات. (I8f62f)
  • تعديل TitleBar - يمكن تلوين النص والرمز بشكلٍ فردي. (Ia0a60)
  • إضافة مكوّن السقالات (I8a736)
  • يضيف فلتر hasActionRunCallbackClickAction وتأكيد assertHasActionRunCallbackClickAction لاختبار actionRunCallack. يضيف هذا الإصدار أيضًا وظائف إضافية مختصرة لصيغة فلاتر الاختبار المرتبطة بالإجراءات، مثل hasStartActivityClickAction<activityClass>(..) وhasStartServiceAction<receiverClass>(..) وhasSendBroadcastAction<receiverClass>(..). تضيف هذه السمة صيغًا مشابهة assertHasXXX لنظيراتها. (Ieca63)
  • نقل واجهة برمجة التطبيقات التي لم يتم إصدارها تغيير معدِّل من داخلي إلى علني ولكن مع حظر الوصول إلى المكتبة (If2a08)
  • إضافة طريقة onCompositionError حيث يمكن للمطوّرين تشغيل الرمز البرمجي عند حدوث خطأ (I9b56f)
  • إضافة واجهات برمجة تطبيقات الزر وزر الرمز إلى Glance (I0fd6f)
  • تضيف هذه السمة الفلاتر isLinearProgressIndicator وisIndeterminateLinearProgressIndicator وisIndeterminateCircularProgressIndicator لمطابقة مؤشرات التقدّم. يتضمّن hasAnyDescendants فلترًا إضافيًا لاختبار ما إذا كانت العقدة تتضمّن عنصرًا فرعيًا في التسلسل الهرمي الفرعي يطابق أداة مطابقة معيّنة (Ifd426)
  • تضيف هذه القاعدة تأكيدات وفلاتر لتفعيل اختبار إجراءات النقر التي تبدأ خدمة أو نشاطًا أو عمليات بث. يتضمّن ذلك أيضًا اختبار ما إذا كانت عناصر الإدخال محدّدة. (I3041c)

الإصدار 1.0.0

الإصدار ‎1.0.0-alpha07

‫27 أغسطس 2025

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

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

  • تم إيقاف مربّعات Glance Wear نهائيًا وستتم إزالتها في إصدار قادم. وسيتم استبدالها بمكتبة جديدة من التطبيقات المصغّرة التي يمكن عرضها بنظرة سريعة على الساعة.

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

  • إيقاف glance-wear-tiles نهائيًا (I82afd)
  • إزالة التعليقات التوضيحية القديمة @RequiresApi(21) (Ic4792)
  • إزالة التعليقات التوضيحية القديمة @RequiresApi(21) (I9103b)
  • يزيل وحدة غير مستخدَمة. لن نواصل العمل على "النماذج". (I3fc90، b/430070874)
  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5)
  • Fixes api council feedback (I284c8)
  • تضيف هذه السمة واجهة برمجة تطبيقات جديدة لتلوين الأزرار. يجب أن تكون هذه الميزة تجريبية إلى حين إصدار الإصدار 1.0 (I92523)
  • تم تعديل ملفات واجهة برمجة التطبيقات لإضافة تعليقات توضيحية حول إيقاف التوافق (I8e87a، b/287516207)
  • أصبحت أنواع protolayout متاحة الآن بالكامل على مستوى جميع واجهات برمجة التطبيقات الخاصة بأداة عرض المربّعات. (I428b0)
  • تم دمج ملفات واجهة برمجة التطبيقات العامة والتجريبية للمسارات d وe وf وg (I03646، b/278769092)
  • تمت إضافة واجهة برمجة التطبيقات *Defaults لكل من Button وCheckbox وRadioButton وSwitch. ويجعلها أكثر توافقًا مع أنماط Jetpack Compose. (I94828)
  • وحدة نماذج Glance الجديدة (I94459)
  • أضفنا أنواع androidx.wear.protolayout إلى TileRenderer (I4ac7f)
  • المزيد من إمكانية قبول القيمة الخالية لأنواع الإرجاع للدوال المتوقفة نهائيًا والمخفية (Ibf7b0)
  • إضافة التعليق التوضيحي @JvmDefaultWithCompatibility (I8f206 وb/251463569)
  • تمت إضافة إمكانية استخدام تعبيرات lambda كعمليات إعادة استدعاء (Ia0bbd)

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

  • تحديث مكتبات glance-appwidget إلى الإصدار compileSdk 35 (I2e26b)

الإصدار ‎1.0.0-alpha06

‫7 فبراير 2024

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

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

  • تم تعديل الإصدار ليتوافق مع وحدة Glance الرئيسية.

الإصدار 1.0.0

‫6 سبتمبر 2023

تم طرح androidx.glance:glance-*:1.0.0. يتضمّن الإصدار 1.0.0 هذه التعديلات.

الميزات الرئيسية في الإصدار 1.0.0

  • نقل Glance إلى الإصدار الثابت 1.0.0

الإصدار ‎1.0.0-rc01

‏26 تموز (يوليو) 2023

تم طرح androidx.glance:glance-*:1.0.0-rc01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

نقل Glance إلى الإصدار rc01 في طريقه إلى الإصدار الثابت 1.0.0

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

  • تضيف هذه السمة مَعلمات رئيسية إلى دوال lambda للإجراءات من أجل استدعاء الإجراءات بشكل أكثر استقرارًا.
  • تضيف هذه السمة إمكانية تقديم إجراءات ActvityOptions إلى startActivity.
  • إتاحة استخدام نظام التشغيل Android 14

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

  • تمّت إضافة مَعلمة مفتاح اختيارية لجميع العناصر التي تقبل تعابير lambda. (Id96c1، b/282445798)
  • إتاحة ضبط حزمة ActivityOptions لـ actionStartActivity (I6a08d)
  • تم دمج ملفات واجهة برمجة التطبيقات العامة والتجريبية للمسارات d وe وf وg (I03646، b/278769092)
  • لا ينطبق، فالتغييرات في ملف واجهة برمجة التطبيقات هي مجرد إعادة ترتيب للطرق (I5fa95)
  • إضافة واجهة برمجة تطبيقات لإعداد CoroutineContext لطلبات GlanceAppWidgetReceiver (I0a100)
  • تمت إضافة واجهة برمجة تطبيقات جديدة لتوفير ActivityOptions لكل من LazyColumn وLazyVerticalGrid، وسيتم استخدامها في جميع الإجراءات الواردة في القائمة.(Id8d71)

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

  • لا ينطبق، فالتغييرات في ملف واجهة برمجة التطبيقات هي مجرد إعادة ترتيب للطرق (I5fa95)
  • عرض توضيحي لنمط مكوّن نصي في Glance (Ie78a4)

الإصدار 1.0.0-beta01

‫10 مايو 2023

تم طرح androidx.glance:glance-*:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

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

  • نقل المكتبة إلى الإصدار التجريبي
  • إتاحة استخدام السمات باستخدام GlanceTheme، وإضافة وحدتَي glance-material وglance-material3 لإتاحة سمات التصميم 2 و3 في Glance
  • تمت إضافة إمكانية استخدام FontFamily إلى واجهات برمجة التطبيقات النصية.
  • تم نقل GlanceAppWidget إلى آلية تحديث مستندة إلى جلسة WorkManager. على مستخدمي Glance for AppWidgets الآن تجاهل GlanceAppWidget.provideGlance بدلاً من طريقة Content القديمة. بما أنّ ذلك يحدث الآن في عامل، أصبح هذا المكان مناسبًا لتحميل الموارد أو قاعدة البيانات أو عناصر الشبكة بدون الحاجة إلى عامل منفصل.

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

  • تمت إضافة واجهة برمجة التطبيقات *Defaults لكل من Button وCheckbox وRadioButton وSwitch. ويجعلها أكثر توافقًا مع أنماط Jetpack Compose. (I94828)
  • وحدة نماذج Glance الجديدة (I94459)
  • جعل ResourceColorProvider داخليًا للوحدة تغيير قد يؤدي إلى عطل هذا الإعداد مطلوب لأنّه يجب استخدام ResourceColorProvider فقط لتطبيق السمات الديناميكية لتجنُّب الحالات التي تكون فيها بعض الألوان موارد ديناميكية وبعضها الآخر تم حله بالكامل. (Ib0db7)
  • يضيف FontFamily كخيار لـ TextStyle. (Ic19ba، b/274179837)
  • تم تغيير اسم مَعلمة القيمة لـ Enum.valueOf (Ia9b89)
  • المزيد من الاستثناءات التي تم طرحها من التعداد valueOf (I818fe)
  • تم تعديل GlanceAppWidget لاستخدام provideGlance كنقطة دخول رئيسية. تم إيقاف GlanceAppWidget.Content نهائيًا. (I202b5)
  • إضافة خيار لتوفير لون التظليل للصور (I26192، b/212418562)
  • المزيد من إمكانية قبول القيمة الخالية لأنواع الإرجاع للدوال المخفية التي تم إيقافها نهائيًا (Ibf7b0)
  • جارٍ إضافة التعليق التوضيحي @JvmDefaultWithCompatibility (I8f206)
  • تمت إزالة SingleEntityTemplateData.displayHeader غير المستخدَم. (I7f094)
  • تمت إضافة إمكانية استخدام تعبيرات lambda كعمليات إعادة استدعاء (Ia0bbd)
  • تم نقل DayNightColorProvider إلى وحدة "نظرة سريعة" (I1842c، b/256934779)
  • تتم إزالة LocalColorProvider من "النماذج". ستستخدم النماذج الآن GlanceTheme.colors (Ic15e2)
  • إزالة إمكانية القيم الخالية من Text(style: TextStyle) (I7123b، b/237012816)
  • ضبط لون النص التلقائي على الأسود وإزالة إمكانية القيم الخالية (I3072c، b/237012816)
  • جعل المظهر الديناميكي ColorProviders عنصرًا منفصلاً جعل ResourceColorProvider داخليًا للوحدة (Id0e2d، b/237012816)
  • أضِف الفئة "غير محدّدة" إلى ImageSize. (I2fa39)
  • إزالة الدالة GlanceAppWidget.Content المتوقّفة نهائيًا (Ib05f6)
  • تضيف هذه السمة المعدِّل كمعلَمة إلى AndroidRemoteViews. (I515d4)
  • إضافة GlanceAppWidget.compose لتسهيل اختبار الوحدات (Ie9b28)

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

  • تمت إضافة أداة عرض توضيحي لخطوط نص Glance (I5c3d7)
  • يجعل AndroidRemoteViews قابلاً للتغيير في الحجم باستخدام Modifier.
  • تم حلّ المشاكل المتعلّقة بعدم اتساق ألوان المظهر
  • تمت إضافة بادئة إلى جميع الموارد الآن لتجنُّب التعارضات

الإصدار ‎1.0.0-alpha05

‫5 أكتوبر 2022

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

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

  • تضيف requestPinGlanceAppWidget إلى GlanceAppWidgetManager، ما يسمح للتطبيقات بأن تطلب من المستخدم إضافة تطبيقها المصغّر المستند إلى "نظرة سريعة" إلى شاشته الرئيسية. (Ic6e47)
  • تضيف هذه السمة ACTION_DEBUG_UPDATE إلى GlanceAppWidgetReceiver للسماح للمطوّرين بفرض تحديث التطبيق المصغّر من adb على الأجهزة التي تم الوصول إلى جذرها والمحاكيات. (I94ae1)

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

  • إزالة أزرار الإجراءات في رأس قوالب Glance لتبسيط حالة الاستخدام (Ie4387)
  • تمت إعادة تصميم نموذج الكيان الفردي لإعادة استخدام تصميم النظام الفرعي "الكتلة". (Iecd2c)
  • تمت إعادة تصميم "نموذج قائمة النظرة السريعة" لاستخدام تصميم "Text/Image/Action". (If0cc1)
  • أضِف نطاق أرقام الأولوية لـ TextBlock وImageBlock. (I73100)

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

  • تمت إزالة تبعية Material3. (I28d1c)
  • تتّجه نحو نظام أكثر اتساقًا لإضافة الهوامش والمسافات في تنسيقات نماذج النظرة السريعة. (I29773)
  • إصلاح قاعدة Proguard غير صالحة كانت تحظر إنشاء الإصدارات المصغّرة

الإصدار ‎1.0.0-alpha04

‫10 أغسطس 2022

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

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

  • تضيف هذه السمة ميزات تلوين الأزرار.
  • تتم إضافة التعليق التوضيحي GlanceComposable لإجراء عمليات التحقّق بشكل أفضل في وقت الترجمة.
  • تضيف هذه الحزمة ميزات "نظرة سريعة" خاصة بأجهزة Wear OS.

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

  • تعديل واجهة برمجة التطبيقات Glance Gallery Data API و"العرض الموجز" (Ibc7a8)
  • تضيف هذه السمة ButtonColors لضبط الأزرار. (Iea88d، b/236305351)
  • تمّت إعادة تسمية ColorProvider.resolve إلى ColorProvider.getColor (Ic9dfe)
  • تضيف هذه الدالة طريقة copy() إلى TextStyle. (I9aef6)
  • تضيف هذه السمة فئة ColorProviders يمكن استخدامها كجزء من سمات Glance. (I848b9، b/237012816)
  • إضافة إمكانية استخدام نموذج القائمة إلى أنماط القوائم والعرض المصغّر (I50cdc)
  • أضِف دلالات إلى GlanceModiier وGlanceCurvedModifier. (Ifda7e)
  • أضِف تعليقًا توضيحيًا GlanceComposable. (I5dbf0)
  • نقل "نماذج Glance" إلى مشروع Glance الرئيسي (I9db94)
  • إضافة ColorProvider.resolve() (Ife532، b/214733442)
  • طريقة جديدة للحصول على GlanceId من appWidgetId حالي أو غرض من نشاط الإعداد (Icb70c، b/230391946)
  • أضِف تعليقًا توضيحيًا GlanceComposable. (I2c21f)
  • تمت إضافة GlanceRemoteViews لتشغيل المقطوعة الموسيقية خارج GlanceAppWidget. (I18f92)
  • إزالة اللون في ProgressIndicatorDefaults (I40299)
  • أعِد تسمية طريقة ActionCallback‎ onRun إلى onAction، وذلك لضمان التوافق مع واجهات برمجة التطبيقات العامة، كما هو مطلوب في ملاحظات مراجعة واجهة برمجة التطبيقات. (Icfa57)
  • تحويل تخطيطات قوالب النظرة السريعة لاستخدام خريطة (I46bfd)
  • إضافة عنصر قابل للإنشاء RadioButton (I4ecce)
  • تمت إضافة GlanceWearTiles لإنشاء بطاقات Wear (Ia9f65)
  • تمت إضافة عنصر قابل للنقر إلى GlanceCurvedModifier (Iec2a0)
  • نفِّذ CurvedRow كنطاق وأنشئ لغة خاصة بالمجال (DSL) لإضافة عناصر عادية و/أو منحنية قابلة للإنشاء. تمت أيضًا إضافة curvedLine وcurvedSpacer اللذين تتم ترجمتهما إلى ArcLine وArcSpacer في شاشات المعلومات الأولية (Ib955b)
  • تم تعديل إمكانية القيم الخالية في حزمتَي core وappcompat لتتوافق مع الإصدار التجريبي الثاني من Tiramisu (I0cbb7)
  • إضافة دعم لـ RuncallbackAction في glance-wear-tiles، ولا تتوفّر حاليًا سوى RunCallbackAction بدون مَعلمة (Ide64a)

المساهمة الخارجية

  • تم تعديل واجهة برمجة التطبيقات :compose:ui:ui-test (updateApi) بسبب نقل مكتبة test-coroutines-lib (I3366d)

الإصدار ‎1.0.0-alpha03

‫23 فبراير 2022

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

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

  • تعريف مبسط للحالة التلقائية للإعدادات المفضّلة

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

  • تبسيط عملية معالجة الحالة من خلال جعل PreferencesGlanceStateDefinition هي عملية معالجة الحالة التلقائية تمت إزالة GlanceAppWidget.updateAppWidgetState وإضافة updateAppWidgetState التي تستخدم Preferences تلقائيًا. (I58963)
  • إضافة فئة Glance TemplateText وتعديل تصميم النموذج (I4e146)
  • إضافة بنية المخطط التفصيلي لنموذج "اللوحة الحرة" (If03d6)
  • تعديلات على تخطيطات SingleEntityTemplate (If925d)
  • تمت الإضافة في ‎LazyVerticalGrid (I5f442)
  • استخدام ColorProvider على SingleEntityTemplate (I01ee0)
  • تعديل اسم فئة النموذج (I3720e)
  • تمت إضافة العنصرين القابلَين للإنشاء LinearProgressIndicator وCircularProgressIndicator. (Ie116b)

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

  • تنفيذ نماذج النظرة الأولية، وتحديد بيانات "نموذج العنصر الفردي" وتصميم النموذج النموذجي (I35837)
  • محاذاة محتوى المربّع إلى المنتصف تلقائيًا (I264be)
  • إصلاح خطأ في fillMaxSize/Width/Height في glance-wear-tiles (I0a39f)

الإصدار ‎1.0.0-alpha02

‫26 يناير 2022

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

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

يحتوي هذا الإصدار على مجموعة واجهات برمجة التطبيقات لإنشاء "شاشات معلومات Wear" باستخدام وقت تشغيل Compose مع عناصر قابلة للإنشاء محسَّنة لتوفير معلومات سريعة.

  • عليك الإعلان عن خدمة لوحة Wear من خلال توسيع GlanceTileService، وهي خدمة لإنشاء لوحتك في الدالة القابلة للإنشاء Content().
  • عناصر Wear القابلة للإنشاء الخاصة باللمحة السريعة: CurvedRow وCurvedText
  • تعامَل مع أوضاع المخطط الزمني المختلفة للّوحة من خلال تحديد TimelineMode.SingleEntry وTimelineMode.TimeBoundEntries.
  • تشير LocalTimeInterval، وهي التركيبة المحلية، إلى فاصل زمني محدّد.
  • ‫BorderModifer هي GlanceModifier تطبّق حدًا حول عنصر.

يضيف هذا الإصدار أيضًا "مؤشرات التقدم" إلى "نظرة سريعة على AppWidget".

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

  • تمت إضافة العنصرين القابلَين للإنشاء LinearProgressIndicator وCircularProgressIndicator. (Ie116b)
  • تغيير actionStartBroadcastReceiver إلى actionSendBroadcast (I7d555)
  • تمرير Context إلى دالة معاودة الاتصال GlanceAppWidget onDelete (I4c795)

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

  • التعامل بشكل صحيح مع OPTIONS_APPWIDGET_SIZES إذا كان الحقل متوفّرًا ولكنّه فارغ (I01f82)

الإصدار ‎1.0.0-alpha01

15 كانون الأول (ديسمبر) 2021

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

الميزات المضمّنة في الإصدار الأوّلي

  • يتضمّن الإصدار الأول من Glance المجموعة الأولى من واجهات برمجة التطبيقات لإنشاء AppWidget باستخدام Compose Runtime مع مجموعة من عناصر Composables الجديدة المحسَّنة لتناسب "المعلومات السريعة".

الميزات