نظرة سريعة
آخر تعديل | الإصدار المستقر | إصدار المرشح | الإصدار التجريبي | إصدار أولي |
---|---|---|---|---|
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" مع مجموعة من العناصر الجديدة التي تم تحسينها لميزة "نظرة سريعة".
الميزات
- يمكنك تعريف التطبيقات المصغّرة لتطبيقك من خلال GlanceAppWidget وGlanceAppWidgetInheritr.
- أنشئ واجهة المستخدم باستخدام المجموعة الأولية من العناصر المتحركة في Glance Composables: Box والصف والعمود والنص والزر وLazyColumn والصورة وتباعد.
- طبِّق المعدّلات على المحتوى المركّب باستخدام طرق GlanceModifier.
- تعامل مع تفاعل المستخدم باستخدام الإجراءات المحدّدة مسبقًا.
- قدِّم مَعلمات إلى الإجراء باستخدام ActionParameters.
- تعامل مع أوضاع الحجم المختلفة من خلال تحديد SizeMode.Single أو SizeMode.Exact أو SizeMode.سريع للاستجابة.
- احتفِظ بحالة GlanceAppWidget من خلال توفير GlanceStateDefinition.
- المقطوعات الموسيقية المحلية مثل LocalContext وLocalState وLocalGlanceId وLocalSize
- يمكنك التشغيل التفاعلي مع وحدات التحكم عن بُعد الحالية باستخدام عناصر Androidالتحكم عن بُعد التي يمكن إنشاؤها.