نظرة سريعة

يمكنك إنشاء تصميمات لمساحات بعيدة باستخدام واجهة برمجة تطبيقات بنمط Jetpack Compose.
آخر تعديل الإصدار المستقر إصدار المرشح الإصدار التجريبي إصدار أولي
6 أيلول (سبتمبر) 2023 - - - 1.0.0-alpha05

إعلان التبعيات

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

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

رائع

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

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

لغة Kotlin

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

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

ملاحظات

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

إنشاء عدد جديد

راجع وثائق "أداة تتبُّع المشاكل" للحصول على مزيد من المعلومات.

الإصدار 1.0.0

الإصدار 1.0.0

6 أيلول (سبتمبر) 2023

تم إطلاق "androidx.glance:glance-*:1.0.0". يحتوي الإصدار 1.0.0 على هذه الالتزامات.

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

  • نقل ميزة "نظرة سريعة" إلى الإصدار الثابت 1.0.0

الإصدار 1.0.0-rc01

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

تم إطلاق "androidx.glance:glance-*:1.0.0-rc01". يحتوي الإصدار 1.0.0-rc01 على هذه الالتزامات.

نقل نظرة سريعة إلى rc01 في الطريق إلى الإصدار الثابت للإصدار 1.0.0.

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

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

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

  • تمت إضافة مَعلمة رئيسية اختيارية لجميع العناصر التي تقبل قيم 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. ويتيح لك هذا التنسيق إضافة وحدات نمطية للمواد الأساسية وأخرى لمواد العرض السريعة لتوفير مظاهر نمطَي المادة 2 والمواد 3 في ميزة "نظرة سريعة".
  • تمت إضافة دعم FontFamily إلى واجهات برمجة التطبيقات النصية.
  • تم نقل GlanceAppWidget إلى آلية تحديث مستندة إلى جلسة WorkManager. على مستخدمي ميزة "نظرة سريعة" في AppWidgets الآن إلغاء GlanceAppWidget.provideGlance بدلاً من طريقة Content القديمة. ونظرًا لأن ذلك يحدث الآن لدى العامل، يمكن الآن تحميل الموارد أو عناصر قاعدة البيانات أو الشبكة دون الحاجة إلى عامل منفصل.

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

  • تمت إضافة *Defaults API لـ Button وCheckbox وRadioButton وSwitch. وتقرّب هذه الميزة من نمط Jetpack Compose. (I94828)
  • وحدة نماذج ميزة "نظرة سريعة" الجديدة (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)

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

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

الإصدار 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)

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

  • يمكنك إزالة أزرار الإجراءات الخاصة بالعناوين في نماذج ميزة "نظرة سريعة" لتبسيط حالة الاستخدام. (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.

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

  • تعديل واجهة برمجة التطبيقات لبيانات المعرض من خلال ميزة Glance Gallery والعرض المكثّف (Ibc7a8)
  • تضيف ButtonColors لضبط الأزرار. (Iea88d، b/236305351)
  • إعادة تسمية ColorProvider.resolve إلى ColorProvider.getColor (Ic9dfe)
  • لإضافة طريقة copy() إلى TextStyle. (I9aef6)
  • إضافة صف ColorProviders يمكن استخدامه كجزء من المظاهر لميزة "نظرة سريعة" (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)
  • يمكنك إعادة تسمية طريقة onRun لـ ActionCallback لتصبح onAction لتتوافق مع واجهات برمجة التطبيقات المتاحة للجميع، وذلك حسبما تتطلب ملاحظات مراجعة واجهة برمجة التطبيقات. (Icfa57)
  • تحويل تنسيقات نماذج إلقاء نظرة سريعة لاستخدام خريطة (I46bfd)
  • إضافة RadioButton قابل للإنشاء (I4ecce)
  • تمت إضافة GlanceWearTiles لإنشاء مربعات الملابس (Ia9f65).
  • تمت إضافة قابل للنقر إلى GlanceCurvedModifier (Iec2a0)
  • يمكنك تنفيذ CurvedRow كنطاق وإنشاء DSL لإضافة عناصر عادية قابلة للإنشاء و/أو منحنية. تمت أيضًا إضافة curvedLine وcurvedSpacer المترجَمتين إلى ArcLine وArcSpacer في أقسام الأولية (Ib955b).
  • تم تعديل إمكانية القيم الفارغة في النظام الأساسي وتطبيق التطبيق لتتطابق مع Tiramisu DP2 (I0cbb7)
  • إضافة دعم RuncallbackAction في المربّعات التي يمكن ارتداؤها سريعًا، علمًا بأنّ السمة RunCallbackAction فقط بدون معلَمة متاحة في الوقت الحالي (Ide64a)

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

  • تم تعديل :compose:ui:ui-test api (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 inlocale-wear-tiles (I0a39f)

الإصدار 1.0.0-alpha02

26 كانون الثاني (يناير) 2022

تم إطلاق "androidx.glance:glance-*:1.0.0-alpha02". يحتوي الإصدار 1.0.0-alpha02 على هذه الالتزامات.

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

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

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

ويضيف هذا الإصدار أيضًا مؤشرات التقدم إلى AppWidget Glance.

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

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

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

  • المعالجة الصحيحة لـ OPTIONS_APP{9}_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 على هذه الالتزامات.

الميزات في الإصدار الأولي

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

الميزات