نظرة سريعة

يمكنك إنشاء تصاميم للمساحات البعيدة باستخدام واجهة برمجة تطبيقات بأسلوب Jetpack Compose.
التعديل الأخير الإصدار المستقر إصدار مرشح الإصدار التجريبي إصدار ألفا
17 نيسان (أبريل) 2024 1.0.0 - 1.1.0-beta02 -

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

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

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

رائع

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

    // 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.1.0-beta02")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.1.0-beta02")

    // 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.1

الإصدار 1.1.0-beta02

17 نيسان (أبريل) 2024

تم طرح "androidx.glance:glance-*:1.1.0-beta02". يحتوي هذا الإصدار على أواني مصدر غير متوفّرة في الإصدار السابق.

الإصدار 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 يمكن اختبار رمز النظرة السريعة مباشرةً بدون الحاجة إلى تضخيم العرض.
  • مكونات ذات مستوى أعلى لتخطيطات أبسط.
  • المعدِّلات وخيارات المظاهر الجديدة
  • واجهة برمجة تطبيقات جديدة للحصول على تدفق من RemoteViews من مقطوعة موسيقية، runComposition

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

  • تتم إضافة دور لون widgetBackground جديد إلى مظاهر ميزة "نظرة سريعة". (Ia2ab8)
  • إضافة GlanceAppWidget.runComposition (I6344c، b/298066147)
  • إضافة مكوّن TopBar جديد (Ibd361)
  • تعمل هذه السياسة على إضافة عمليات إلغاء إلى مفتاح التعديل clickable. (Iacecf)
  • إضافة واجهة برمجة تطبيقات جديدة لتلوين الأزرار من المفترض أن تكون هذه التجربة تجريبية حتى الإصدار 1.0 من الشحن. (I92523)
  • تتم إضافة runGlanceAppWidgetUnitTest لتوفير نطاق لطُرق طلب البيانات على GlanceAppWidgetUnitTest، مثل provideComposable لتوفير عنصر صغير معزول قابل للإنشاء للاختبار، onNode للعثور على عنصر قابل للإنشاء من خلال ميزة "نظرة سريعة" في المحتوى المقدَّم. يتيح لك ذلك كتابة اختبارات وحدات لدوال فردية قابلة للإنشاء في appWidget للتحقّق من أنّه بناءً على إدخالات معيّنة، تُخرج الدالة المجموعة المقصودة من العناصر القابلة للإنشاء بنظرة سريعة. (I2f682)
  • لإضافة عنصر تعديل testTag في الدلالات للاستخدام في اختبارات الوحدات. (I8f62f)
  • تحديث TitleBar - النص والرمز قابلان للتلوين بشكل فردي. (Ia0a60)
  • إضافة مكوّن سقالة (I8a736)
  • إضافة الفلتر hasActionRunCallbackClickAction وتأكيد assertHasActionRunCallbackClickAction لاختبار "actionRunCallack" تتم أيضًا إضافة دوال صيغ مختصرة إضافية لفلاتر الاختبار المرتبطة بالإجراءات - hasStartActivityClickAction<activityClass>(..) وhasStartServiceAction<receiverClass>(..) وhasSendBroadcastAction<receiverClass>(..). إضافة صيغ مشابهة لنظيراتها في assertHasXXX. (Ieca63)
  • نقل واجهة برمجة التطبيقات التي لم يتم إصدارها تغيير مفتاح التعديل من داخلي إلى علني ولكن المكتبة محظورة (If2a08)
  • إضافة طريقة onCompositionError التي يمكن للمطوّرين من خلالها تشغيل الرمز عند حدوث خطأ (I9b56f)
  • إضافة واجهات برمجة تطبيقات الزر والزر icon إلى لمحة سريعة (I0fd6f)
  • إضافة فلاتر isLinearProgressIndicator وisIndeterminateLinearProgressIndicator وisIndeterminateCircularProgressIndicator لمطابقة مؤشرات التقدّم تشمل الميزات الإضافية فلتر hasAnyDescendants لاختبار ما إذا كان للعقدة تابعة في تدرّجها الهرمي الفرعي تتطابق مع مطابقة محدّدة (Ifd426).
  • تتم إضافة تأكيدات وفلاتر لتفعيل اختبار إجراءات النقر التي تبدأ الخدمة أو النشاط أو عمليات البث. يتضمن أيضًا اختبار التحقق من التحقق من عناصر الإدخال. (I3041c)

الإصدار 1.0.0

الإصدار 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 على هذه الالتزامات.

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

  • تم تعديل الإصدار لاتّباع وحدة "نظرة سريعة" الرئيسية.

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

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

  • تمت إضافة واجهة برمجة التطبيقات *Defaults الخاصة بـ "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)
  • تمت إضافة دعم لاستخدام 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 حالي أو intent من نشاط إعداد (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 في أقسام Proto (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/العرض/الارتفاع في clean-wear-ilees (I0a39f)

الإصدار 1.0.0-alpha02

26 يناير 2022

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

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

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

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

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

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

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

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

  • المعالجة الصحيحة لـ OPTIONS_APP{/8}S إذا كانت موجودة ولكنها فارغة. (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" مع مجموعة من العناصر الجديدة القابلة للإنشاء والتي تم تحسينها لـ "التطبيقات المصغّرة من فئة Glanceables".

الميزات