نظرة سريعة

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

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

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

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

Groovy

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

    // 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-alpha01")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.3.0-alpha01")

    // 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-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 هذه التعديلات.

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

  • نقل القيمة التلقائية minSdk من الإصدار 21 من واجهة برمجة التطبيقات إلى الإصدار 23 من واجهة برمجة التطبيقات (Ibdfca، b/380448311، b/435705964، b/435705223)

الإصدار ‎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 من "مكوّن Android الإضافي Gradle" أو الإصدارات الأحدث (مثل الإصدار 3.3 من R8) وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 من "مكوّن Android الإضافي Gradle" أو الإصدارات الأحدث (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون "مكوّن Android الإضافي لبرنامج Gradle" بالترقية إلى الإصدار 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 هذه التعديلات.

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

  • تمت إضافة مَعلمتَي العرض والارتفاع إلى التعليقات التوضيحية الخاصة بالمعاينة في ميزة "نظرة سريعة". نقل الإصدار 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 نهائيًا وستتم إزالتها في إصدار قادم. وسيتم استبدالها بمكتبة جديدة من التطبيقات المصغّرة التي يمكن عرضها بنظرة سريعة على Wear OS.

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

  • إيقاف glance-wear-tiles نهائيًا (I82afd)
  • إزالة التعليقات التوضيحية القديمة @RequiresApi(21) (Ic4792)
  • إزالة التعليقات التوضيحية القديمة @RequiresApi(21) (I9103b)
  • يزيل وحدة غير مستخدَمة. لن نواصل العمل على "النماذج". (I3fc90، b/430070874)
  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5)
  • إصلاح ملاحظات مجلس إدارة واجهة برمجة التطبيقات (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)
  • تمت إضافة إمكانية استخدام lambdas كعمليات إعادة استدعاء (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)
  • عرض توضيحي لنمط مكوّن النص في "نظرة سريعة" (Ie78a4)

الإصدار ‎1.0.0-beta01

‫10 مايو 2023

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

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

  • نقل المكتبة إلى الإصدار التجريبي
  • تتيح هذه السمة استخدام GlanceTheme ، وتضيف وحدتَي glance-material وglance-material3 لإتاحة مظاهر بتصميم Material 2 وMaterial 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)
  • تمت إعادة تصميم "نموذج قائمة Glance" لاستخدام تصميم "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.

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

  • تعديل واجهة برمجة التطبيقات 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)
  • أعِد تسمية طريقة ActionCallbackonRun إلى 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)
  • تمرير السياق إلى دالة معاودة الاتصال 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 الجديدة المحسَّنة لتناسب "المعلومات السريعة".

الميزات