وميض Jetpack Compose

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

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

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

dependencies {
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha20"
}

dependencies {
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha20")
}

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

الملاحظات

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

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.0

الإصدار ‎1.0.0-alpha20

‫23 سبتمبر 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha20 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha20. يتضمّن الإصدار ‎1.0.0-alpha20 هذه التعديلات.

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

• إضافة Glimmer AlertDialog (I01019)
• تستهدف المكتبات الآن الإصدار 2.2 من Kotlin وتتطلّب الإصدار 2.2 من kotlinc (I82396، b/498369605)
• إضافة LeadingImageCard وTrailingImageCard (Icdf91)
• إضافة واجهة برمجة التطبيقات ImageCard وإزالة المَعلمة header من Card وActionCard (I81f62)
• تمت إضافة مكونات IconMarker تُستخدَم لتثبيت العناصر في العالم الحقيقي. (I958d6)

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

• تم تعديل الاعتمادية androidx.lifecycle:lifecycle-runtime إلى الإصدار 2.10.0. هذا الإصدار مطلوب لتشغيل عمليات التحقّق من أخطاء lint المجمَّعة في وقت التشغيل لدورة الحياة مع الإصدار 9.5.0-alpha04 أو إصدار أحدث من "مكوّن Android الإضافي لبرنامج Gradle". (I99bfd، b/556807521)

الإصدار ‎1.0.0-alpha19

‫9 سبتمبر 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha19 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha19. يتضمّن الإصدار ‎1.0.0-alpha19 هذه التعديلات.

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

• تغيير اسم المَعلمة من color إلى baseColor لكلّ من SurfaceDefaults.color وSurfaceDefaults.focusedColor (Id1a08)
• أضِف المَعلمة pageOffsetFraction إلى الدالتَين animateScrollToPage وscrollToPage في GlimmerPagerState. (I5ed0d)

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

• تم تعديل compileSdk لمكتبات Compose إلى الإصدار 37.1. سيتطلّب ذلك تعديل compileSdk بشكل متعدٍّ لجميع التطبيقات والمكتبات التي تستخدم Compose. (I05b0f)

الإصدار ‎1.0.0-alpha18

‫26 أغسطس 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha18 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18. يتضمّن الإصدار ‎1.0.0-alpha18 هذه التعديلات.

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

• غيِّر نوع ButtonGroupState.Saver المتسلسل من Int إلى *. (I78af5)
• اجعل SurfaceDefaults.color وSurfaceDefaults.focusedColor وcheckedBackgroundColor تعمل في IconToggleButton وToggleButton و@Composable. (I52eb5، b/481943080)
• أضِف المَعلمتَين focusedColor وfocusedContentColor إلى الدالة Modifier.surface() لتخصيص ألوان السطح الذي تم التركيز عليه. (Ied24a)
• إزالة تخصيص الحدود من جميع المكوّنات ولون المخطّط التفصيلي من GlimmerTheme.colors (I0d814)

الإصدار ‎1.0.0-alpha17

‫12 أغسطس 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha17 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha17. يتضمّن الإصدار ‎1.0.0-alpha17 هذه التعديلات.

الإصدار ‎1.0.0-alpha16

‫29 يوليو 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha16 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha16. يتضمّن الإصدار ‎1.0.0-alpha16 هذه التعديلات.

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

• إضافة واجهة برمجة تطبيقات لمؤشر الصفحة لاستخدامها مع GlimmerHorizontalPager يتم تجميع هذا المكوّن تلقائيًا عند استخدام أداة Pager، ولكن يمكن أيضًا استخدامه بشكل منفصل طالما تم توفير GlimmerPagerState (I54990، b/481669397)
• إضافة مكوّن ButtonGroup (I26324، b/481662773)

الإصدار ‎1.0.0-alpha15

‫01 يوليو 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha15 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha15. يتضمّن الإصدار ‎1.0.0-alpha15 هذه التعديلات.

الإصدار ‎1.0.0-alpha14

‫3 يونيو 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha14 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha14. يتضمّن الإصدار ‎1.0.0-alpha14 هذه التعديلات.

الإصدار 1.0 من glimmer وglimmer-google-fonts

الإصدار ‎1.0.0-alpha13

‫19 مايو 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha13 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha13. يتضمّن الإصدار ‎1.0.0-alpha13 هذه التعديلات.

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

• تمّت إضافة المَعلمة الاختيارية enabled إلى Modifier.surface التي تطبّق تراكبًا مرئيًا عند إيقاف السطح. (I8b781)
• تم طرح reverseLayout في GlimmerPagerLayoutInfo (I73818، b/481669559)
• تمت إعادة تسمية animateShape إلى animatedShape في ToggleButtonDefaults وIconToggleButtonDefaults (I15f00)
• تمت إعادة تسمية المكوّنات ذات الصلة بـ List لاستخدام البادئة GlimmerLazyList. (If0737، b/425919254، b/483126735)
• التنفيذ الأولي لمؤشر الصوت في Glimmer (I446c7، b/481998624)
• إزالة الأحمال الزائدة القابلة للتركيز والنقر لمعدِّل "السطح" أصبح الآن معدِّلاً واحدًا مسؤولاً عن المؤثرات المرئية فقط. أضِف يدويًا المعدِّلات focusable أو clickable أو غيرها لإنشاء أسطح تفاعلية. راجِع الأمثلة للحصول على مزيد من المعلومات. (I12dbe)

الإصدار ‎1.0.0-alpha12

‫6 مايو 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha12 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha12. يتضمّن الإصدار ‎1.0.0-alpha12 هذه التعديلات.

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

• إطلاق Glimmer Pager API (I2d830، b/481670271)
• تمت إضافة واجهات برمجة التطبيقات ToggleButton وIconToggleButton (I2656b وIb1667 وb/481299196 وb/481663547)

الإصدار ‎1.0.0-alpha11

‫22 أبريل 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha11 وandroidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11. يتضمّن الإصدار ‎1.0.0-alpha11 هذه التعديلات.

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

• تم إصدار glimmer-google-fonts - أضِف هذه التبعية واستخدِم createGoogleSansFlexTypography لإنشاء مثيل Typography باستخدام إعدادات Google Sans Flex المقترَحة. يمكن تقديم مثيل Typography هذا كالمعتاد من خلال GlimmerTheme. (Iec9e4، b/458447191)

الإصدار ‎1.0.0-alpha10

‫8 أبريل 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha10. يتضمّن الإصدار ‎1.0.0-alpha10 هذه التعديلات.

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

• تمت إضافة واجهة برمجة التطبيقات IconButton. (I0f3dd، b/481298420)
• تم تعميم نوع StackState أداة الحفظ إلى Saver<StackState, *>. (Ic164f، b/491893461)

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

• تم تعديل Compose compileSdk إلى الإصدار 37 من واجهة برمجة التطبيقات. وهذا يعني أنّه يجب استخدام الإصدار 9.2.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" على الأقل عند استخدام Compose. (Id45cd، b/413674743)

الإصدار ‎1.0.0-alpha09

‫25 مارس 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha09. يتضمّن الإصدار ‎1.0.0-alpha09 هذه التعديلات.

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

• تم تعديل القيم التلقائية للسمات "أساسي" و"إيجابي" و"سلبي" و"سطح". تمّت إضافة محور ألوان جديد باسم "الخلفية". (I6bb6c، b/481671956)
• تمت إضافة نظام فرعي ComponentSpacingValues في GlimmerTheme يوفّر قيمًا لاستخدامها في جميع المكوّنات من أجل الحشو وعناصر المسافات الأخرى. تمت إعادة تسمية ثوابت PascalCase المسافة والحشو الحالية في عناصر Defaults الخاصة بالمكوّنات (مثل ContentPadding وItemSpacing) إلى camelCase وتم تحويلها إلى خصائص قابلة للإنشاء. (I96e30، b/491166461)
• انقل onClick إلى الموضع الأخير في قائمة المَعلمات لاستخدامه كدالة lambda لاحقة. عدم استخدام IndirectPointerEvent(s) في حال عدم توفير دالة lambda مناسبة (I9343e، b/486965466)
• تمت إعادة تسمية "العمق" والكيانات ذات الصلة إلى DepthEffect. يتم إتاحة خصائص الطبقة DepthEffect للجميع. (Ie26d2، b/485632564)

الإصدار ‎1.0.0-alpha08

‫11 مارس 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha08. يتضمّن الإصدار ‎1.0.0-alpha08 هذه التعديلات.

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

• تم استبدال TitleChipDefaults.contentPadding بالثابت ContentPadding. (If992f، b/489451530)
• تقدّم أداة Glimmer ListState الآن ScrollIndicatorState (I0a2f8، b/481662773)
• تمت إضافة TextStyle جديد باسم caption. بالنسبة إلى TextStyles وfontWeight وfontSize وlineHeight الحالية (I2319f، b/473560419)

الإصدار ‎1.0.0-alpha07

‫25 فبراير 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha07. يتضمّن الإصدار ‎1.0.0-alpha07 هذه التعديلات.

الإصدار ‎1.0.0-alpha06

‫11 فبراير 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha06. يتضمّن الإصدار ‎1.0.0-alpha06 هذه التعديلات.

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

• أضِف إصدارًا محملاً بشكل زائد من واجهة برمجة التطبيقات VerticalList مع خانة للعنوان. (Ic3d44)
• تم تعديل ترتيب مَعلمات Glimmer Text autoSize لضمان التوافق مع material3. (Ic24bd، b/477669012)

الإصدار ‎1.0.0-alpha05

‫28 يناير 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha05. يتضمّن الإصدار ‎1.0.0-alpha05 هذه التعديلات.

الإصدار ‎1.0.0-alpha04

‫14 يناير 2026

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha04. يتضمّن الإصدار ‎1.0.0-alpha04 هذه التعديلات.

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

• تمت إضافة إمكانية استخدام عدة أشكال لتزيين العناصر لكل عنصر في VerticalStack (22daab3) وإمكانية استخدام أشكال عامة لتزيين العناصر (033e015).

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

• تمت إضافة VerticalListDefaults لتوفير القيم المقترَحة للعنصر القابل للإنشاء VerticalList. (I07b1a، b/448364605)

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

• تمت إضافة معالجة التركيز الأولي إلى VerticalStack للتأكّد من أنّ العنصر العلوي يحصل على التركيز عند دخول التركيز إلى الحزمة. يحلّ هذا الإجراء مشكلة تحديد التركيز الأولي على العنصر التالي، ما يؤدي إلى التمرير فورًا إلى هذا العنصر. (bd69841)
• تم إصلاح خطأ في ItemDecorationNode ضمن VerticalStack، حيث لم يتم تعديل الزخارف في نطاق العنصر عند إعادة استخدام عقدة المعدِّل. (7ec2c94)

الإصدار ‎1.0.0-alpha03

‫17 ديسمبر 2025

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha03. يتضمّن الإصدار ‎1.0.0-alpha03 هذه التعديلات.

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

• تعديلات على السلوك وإصلاح الأخطاء في "الحِزم"

الإصدار ‎1.0.0-alpha02

‫3 ديسمبر 2025

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha02. يتضمّن الإصدار ‎1.0.0-alpha02 هذه التعديلات.

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

• طرق الإضافة الجديدة items(items: List<T>) وitemsIndexed(items: List<T>) في ListScope (Ic2afe)
• توفير واجهة برمجة التطبيقات FlingBehavior لـ VerticaList (I16de7)
• توفير مصنع لسلوك المحاذاة المراعي للتركيز في VerticalList (I4a528)

الإصدار ‎1.0.0-alpha01

‫5 نوفمبر 2025

تم طرح androidx.xr.glimmer:glimmer:1.0.0-alpha01. يتضمّن الإصدار ‎1.0.0-alpha01 هذه التعديلات.

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

• الإصدار الأوّلي من Jetpack Compose Glimmer للمطوّرين، وهو لغة تصميم ومكوّنات واجهة مستخدم لإنشاء تجارب Android XR معزَّزة. تم تصميمها لتوفير الوضوح وسهولة القراءة والحدّ من مصادر تشتيت الانتباه من خلال أسلوب مبسط، وتركيز متميّز، وارتفاع محسّن.
• يمكنك البدء باستخدام المجموعة الأولية من مكوّنات Glimmer في Jetpack Compose:
  • نص
  • الرموز
  • شرائح العناوين
  • بطاقات
  • القوائم
  • الأزرار
  • المكدّسات (قيد التطوير)