نظرة سريعة

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

تعريف التبعيات

لإضافة اعتمادية على ميزة "نظرة سريعة"، يجب إضافة مستودع 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 على هذه الالتزامات.

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

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

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

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

  • تمت إضافة مَعلمة رئيسية اختيارية لجميع العناصر التي تقبل دالة lambda. (Id96c1، b/282445798)
  • إضافة دعم لإعداد حزمة ActivityOptions لـ actionStartActivity (I6a08d)
  • تم دمج ملفات واجهة برمجة التطبيقات العامة والتجريبية للمسارات d,e,f,g-path (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 ، ويتيح لك هذا الإعداد إضافة وحدات نمطية محورية للمادة اللامعة ومادة سريعة 3 للتوافق مع المظاهر بنمط المادة 2 والمادّة 3 في ميزة "نظرة سريعة".
  • تمت إضافة دعم FontFamily إلى واجهات برمجة التطبيقات النصية.
  • تم نقل GlanceAppWidget إلى آلية تعديل مستندة إلى جلسة WorkManager. على مستخدمي ميزة "نظرة سريعة" على 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)

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

  • تمت إضافة تطبيق مصغّر لتقديم عرض توضيحي لخطوط النصوص من خلال ميزة "نظرة سريعة" (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 قابلة للتعديل (I4cece)
  • تمت إضافة GlanceWearTiles لإنشاء مربّعات الملابس (Ia9f65).
  • تمت إضافة عنصر قابل للنقر إلى GlanceCurvedModifier (Iec2a0)
  • نفِّذ CurvedRow كنطاق وأنشِئ DSL لإضافة عناصر عادية قابلة للتركيب و/أو منحنية. تمت أيضًا إضافة curvedLine وcurvedSpacer اللتين تمت ترجمةهما إلى ArcLine وArcSpacer في أقسام Proto (Ib955b).
  • تم تعديل إمكانية إلغاء القيم في النظام الأساسي وAppcompat لتتوافق مع 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)
  • إضافة البنية الأساسية للمخطط الخاص بنموذج Freeform (If03d6)
  • تعديلات على تنسيقات SingleEntityTemplate (If925d)
  • تمت إضافة LazyVerticalGrid (I5f442).
  • استخدام ColorProvider على SingleEntityTemplate (I01ee0)
  • تحديث اسم فئة النموذج (I3720e)
  • تمت إضافة LinearProgressIndicator وCircularProgressIndicator عنصر واحد. (Ie116b)

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

  • تنفيذ النماذج السريعة الأولية، وتحديد بيانات "نموذج عنصر واحد" ومثال على تنسيق النموذج (I35837)
  • محاذاة فئة الصور إلى الوسط تلقائيًا (I264be)
  • إصلاح الخطأ في fillMaxSize/العرض/الارتفاع في نظرة عامة على الملابس المتجانبة (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 Callback (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 على هذه الالتزامات.

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

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

الميزات