نظرة سريعة

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

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

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

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

أنيق

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 interop APIs with Material 3
    implementation "androidx.glance:glance-material3:1.3.0-alpha02"

    // For interop APIs with Material 2
    implementation "androidx.glance:glance-material: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.5.15"
    }

    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 interop APIs with Material 3
    implementation("androidx.glance:glance-material3:1.3.0-alpha02")

    // For interop APIs with Material 2
    implementation("androidx.glance:glance-material: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.5.15"
    }

    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)

  • إزالة الثابت غير المستخدَم للتمرير السريع (Ib6df6)

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

الإصدار 1.3.0-alpha01

‫19 مايو 2026

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

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

  • زيادة رقم إصدار واجهة برمجة التطبيقات وCompose عن بُعد بمقدار 1 في Glance (Ia4ea3)
  • إضافة إمكانية التمرير السريع عند استخدام ميزة "إنشاء عن بُعد" (I0ca9d)

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

  • تم تعديل 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

‫26 أغسطس 2026

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

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

تحسينات على الأداء وإصلاحات للأخطاء وإيقاف مكتبة Wear القديمة نهائيًا واستخدام androidx.glance.wear بدلاً منها

الإصدار 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) للعنصر Glance 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)
  • نقل "نماذج النظرة السريعة" إلى مشروع "النظرة السريعة" الرئيسي (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 القابلة للإنشاء الخاصة باللمحة السريعة في البلاطات: CurvedRow وCurvedText
  • تعامَل مع أوضاع المخطط الزمني المختلفة للّوحة من خلال تحديد TimelineMode.SingleEntry وTimelineMode.TimeBoundEntries.
  • تشير LocalTimeInterval، وهي التركيبة المحلية، إلى فاصل زمني محدّد.
  • BorderModifer هي GlanceModifier تطبّق حدًا حول عنصر.

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

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

  • تمت إضافة العنصرين القابلَين للإنشاء LinearProgressIndicator وCircularProgressIndicator. (Ie116b)
  • تغيير actionStartBroadcastReceiver إلى actionSendBroadcast (I7d555)
  • تمرير السياق إلى GlanceAppWidget onDelete callback (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 الجديدة المحسَّنة لتوفير "معلومات سريعة".

الميزات