نظرة سريعة

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

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

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

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

Groovy

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.2.0-rc01"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.2.0-rc01"

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

    // 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.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" (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون 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)
  • إعادة تسمية ViewfinderImplementationMode Enums لتعكس بشكل أفضل عمليات التنفيذ الأساسية، وإضافة ثوابت ثابتة لـ 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 للتحقّق من أنّ الوظيفة تعرض المجموعة المطلوبة من العناصر القابلة للإنشاء عند توفّر مدخلات معيّنة. (I2f682)
  • تضيف هذه السمة المعدِّل testTag في الدلالات لاستخدامه في اختبارات الوحدات. (I8f62f)
  • تعديل TitleBar - يمكن تلوين النص والرمز بشكلٍ فردي. (Ia0a60)
  • إضافة مكوّن السقالات (I8a736)
  • يضيف فلتر hasActionRunCallbackClickAction وتأكيد assertHasActionRunCallbackClickAction لاختبار actionRunCallack. بالإضافة إلى ذلك، يضيف هذا الإصدار وظائف مختصرة إضافية لخيارات فلاتر الاختبارات المرتبطة بالإجراءات، وهي hasStartActivityClickAction<activityClass>(..) وhasStartServiceAction<receiverClass>(..) وhasSendBroadcastAction<receiverClass>(..). تضيف هذه السمة صيغًا مشابهة لنظيراتها assertHasXXX. (Ieca63)
  • نقل واجهة برمجة التطبيقات غير المتوفرة بعد تغيير معدِّل من داخلي إلى علني ولكن مع حظر المكتبة (If2a08)
  • إضافة طريقة onCompositionError حيث يمكن للمطوّرين تشغيل الرمز البرمجي عند حدوث خطأ (I9b56f)
  • إضافة واجهات برمجة تطبيقات الأزرار وأزرار الرموز إلى النظرة السريعة (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)
  • إصلاح ملاحظات مجلس إدارة واجهة برمجة التطبيقات (I284c8)
  • تضيف هذه السمة واجهة برمجة تطبيقات جديدة لتلوين الأزرار. يجب أن تكون هذه الميزة تجريبية إلى حين إصدار الإصدار 1.0 (I92523)
  • تم تعديل ملفات واجهة برمجة التطبيقات لإضافة تعليقات توضيحية بشأن إيقاف التوافق (I8e87a، b/287516207)
  • أصبحت أنواع protolayout متاحة الآن بالكامل على مستوى جميع واجهات برمجة التطبيقات الخاصة بأداة عرض المربّعات. (I428b0)
  • تم دمج ملفات واجهة برمجة التطبيقات العامة والتجريبية للمسارات d وe وf وg (I03646، b/278769092)
  • تمت إضافة واجهة برمجة التطبيقات *Defaults لكل من Button وCheckbox وRadioButton وSwitch. ويجعل Glance أكثر توافقًا مع أنماط 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)
  • عرض توضيحي لنمط عنصر نصي في 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. ويجعل هذا التغيير Glance أكثر توافقًا مع أنماط 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)
  • تمت إضافة إمكانية استخدام lambdas كعمليات إعادة استدعاء (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 لإجراء عمليات التحقّق بشكل أفضل في وقت الترجمة.
  • تضيف هذه الحزمة ميزات Glance خاصة بأجهزة 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)
  • نقل "نماذج النظرة السريعة" إلى مشروع "النظرة السريعة" الرئيسي (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)
  • إضافة بنية المخطط التفصيلي لنموذج Freeform (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 tiles القابلة للإنشاء في Glance: 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 مع مجموعة من العناصر الجديدة القابلة للإنشاء والمحسَّنة لتناسب "المعلومات السريعة".

الميزات