أخبار المنتجات

الميزات الجديدة في إصدار نوفمبر 2026 من Jetpack Compose

مدّة القراءة: 10 دقائق
عرض ملف "مريم مهتا" الشخصي
Meghan Mehta مسؤول علاقات المطوّرين في Android

أصبح إصدار نوفمبر 2026 من Jetpack Compose مستقرًا. يقدّم هذا الإصدار 1.13 في جميع وحدات Compose الأساسية (يمكنك الاطّلاع على تخطيط قائمة المواد الكامل)، ويقدّم تحديثات للنصوص والرسومات والتنسيقات والأداء والمزيد، بالإضافة إلى بعض عمليات الإيقاف النهائي المهمة وتغييرات السلوك التي يجب الانتباه إليها.

لتحديث مشروعك إلى هذا الإصدار، عليك ترقية إصدار Compose BOM إلى 2026.11.01. يُرجى العِلم أنّ هذه الترقية تتطلّب Kotlin 2.2 (أو إصدار أحدث) وcompileSdk 37.1.

implementation(platform("androidx.compose:compose-bom:2026.11.01"))

الرسومات

نواصل إضافة العديد من ميزات الرسومات الجديدة إلى Compose. قدّم الإصدار 1.13 من Compose أشكال المضلّعات والتمويه التدريجي وإمكانية ضبط خصائص التمويه مباشرةً في مربّعات الحوار والنوافذ المنبثقة.

التمويه التدريجي

يقدّم الإصدار 1.13 من Jetpack Compose ميزة التمويه التدريجي، ما يتيح لك نقل العناصر من واضحة إلى مموّهة بسلاسة. يتم إنشاء التمويه التدريجي على دالة lambda لمرحلة الرسم باستخدام Modifier.blur { ... } وBlurRadiusSpec. يمكنك تنفيذ تدرجات خطية (مثل الانتقالات العمودية أو الأفقية)، أو تدرجات شعاعية لتأثيرات تسليط الضوء على نقاط محددة، أو حتى تمرير لغة AGSL RuntimeShaders مخصّصة لإنشاء خرائط تمويه ديناميكية وإجرائية.

سواء كنت تدمج الحافة السفلية لصورة العنوان في الخلفية باستخدام BlurredEdgeTreatment.Unbounded، أو تتبّع إحداثيات اللمس باستخدام تسليط ضوء شعاعي، فإنّ التمويه التدريجي يجعل من السهل جدًا تنفيذ تأثيرات عمق المجال المميّزة والملموسة على Android.

Modifier.blur {
    blurRadiusSpec = BlurRadiusSpec.linearGradient(
        start = DpOffset.Zero,
        end = DpOffset(size.width, size.height),
        stops = listOf(
            BlurStop(fraction = 0f, radius = 0.dp),
            BlurStop(fraction = 0.5f, radius = 0.dp),
            BlurStop(fraction = 0.75f, radius = 14.dp),
            BlurStop(fraction = 1f, radius = 28.dp),
        ),
    )
}
image5_size.png
تدرّج خطي مطبَّق على الجزء السفلي من الصورة بنسبة %75

أشكال المضلّعات والتحويل 

يضيف الإصدار 1.13 من Compose PolygonShape وMorphPolygonShape إلى androidx.compose.foundation:foundation. حتى الآن، كان إنشاء المضلّعات والنجوم الدائرية وتحويل الأشكال في Compose يتطلّب استخدام androidx.graphics:graphics-shapes مباشرةً، أي إضافة التبعية وإنشاء RoundedPolygon بحجم البكسل المناسب وتحويله إلى Path وكتابة Shape الخاص بك ليتناسب مع حدود التنسيق.

‫PolygonShape هو شكل عادي في Compose، لذا فهو يعمل مع Modifier.clip أو أي مَعلمة شكل خاصة بالمكوّن، ويتم تحويله إلى حجم التنسيق تلقائيًا. تُنشئ دالة MorphPolygonShape صورًا متحركة بين شكلَين مضلّعَين من خلال قراءة دالة lambda للتقدّم في وقت الرسم، بدون إعادة تركيب. استخدِم graphics-shapes مباشرةً فقط عندما تكون خارج واجهة مستخدم Compose أو تحتاج إلى هندسة RoundedPolygon الأولية. لا تحتاج إلى إضافة graphics-shapes لاستخدام PolygonShape، لأنّ foundation يعتمد عليه حاليًا.

var recording by remember { mutableStateOf(false) }
val progress by animateFloatAsState(if (recording) 1f else 0f)
val shape = remember {
   MorphPolygonShape(
       start = PolygonShape.circle(),
       end = PolygonShape.star(
           numPoints = 9,
           innerRadiusRatio = 0.8f,
           outerRounding = CornerRounding.fraction(0.5f),
       ),
       progress = { progress },
   )
}
Box(
   Modifier
       .size(96.dp)
       .clip(shape)
       .background(MaterialTheme.colorScheme.primary)
       .clickable { recording = !recording }
)
يتحوّل الزر من دائرة إلى نجمة عند التفاعل معه.
يتحوّل الزر من دائرة إلى نجمة عند التفاعل معه.

تمويه الخلفية وخصائص النوافذ المنبثقة

يمكنك الآن ضبط blurBehindRadius وbackgroundBlurRadius وscrimAlpha وwindowShape (لاقتصاص تمويه خلفية مربّع الحوار إلى زوايا مستديرة) مباشرةً على DialogProperties (وblurBehindRadius/scrimAlpha على PopupProperties). 
يمكنك أيضًا الاستعلام عن حالة التمويه في النظام عبر النوافذ من خلال WindowInfo.isCrossWindowBlurEnabled.

تحسينات على أداء الرسومات

تحسينات التخزين المؤقت

في الإصدار 1.13 من Compose، أصبح عرض الرموز الثابتة أكثر كفاءة. يشارك VectorPainter تلقائيًا ذاكرة التخزين المؤقت للرسومات النقطية ويعيد استخدامها على مستوى برامج الرسم التي تعرض نفس ImageVector الثابت بالحجم والإعدادات نفسها، ما يمنع التخصيصات المتكررة للصور النقطية والتنقيط. لزيادة التخزين المؤقت إلى أقصى حد، أعِد استخدام مثيلات ImageVector في جميع أنحاء التركيب بدلاً من إعادة إنشائها. يتم تفعيل هذا التحسين تلقائيًا من خلال ComposeUiFlags.isVectorDrawCacheSharingEnabled.

تحسينات على حدود المعدِّلات

تتضمّن حزمة Modifier.border الآن تنفيذًا أسرع وأفضل أداءً، وتضيف ميزة "تظليل وقت التشغيل" (ShaderBrush مع RuntimeShader) في جميع أنواع الأشكال، وتستخدم حجم المخطط التفصيلي باستمرار عند عرض الحدود.

لمزيد من المعلومات حول جميع ميزات الرسومات الجديدة في Compose وعلى نظام Android الأساسي، يمكنك الاطّلاع على المحاضرة من مؤتمر Android Dev Summit لعام 2026: 

الإصدار 1.5.0 من Material 3

أصبح الإصدار 1.5.0 من Compose Material 3 ثابتًا الآن، ويقدّم الميزات التالية:

  • تم نقل Slider وRangeSlider إلى نموذج ذي حالة مع SliderState.
  • مكوّنات تعبيرية جديدة، بما في ذلك ToggleButtons وWavyProgressIndicators وTimePickers
  • تمت ترقية واجهات برمجة التطبيقات، بما في ذلك BottomAppBar وTopAppBar variants وBasicAlertDialog، إلى الإصدار الثابت.
  • صورة material3-ripple مع حلقات تركيز داخلية

في هذا الإصدار، خفضنا التعليقات التوضيحية التجريبية بنسبة 52 في المائة - حيث انخفضت من 120 إلى 58. لقد أطلقنا أيضًا كل المكوّنات التعبيرية الجديدة تقريبًا في الإصدار الثابت. مع دخول Material 3 عامه السادس، تم إيقاف مكتبة Compose Material 2 نهائيًا ولم تعُد تتم صيانتها بشكل نشط. ننصحك بالانتقال من Material 2 إلى Material 3 للحصول على أحدث إصلاحات الأخطاء ولغة التصميم لنظام التشغيل Android. يمكنك ترقية التبعيات إلى الإصدار 1.5.0 من Material 3 اليوم لإضافة هذه المكوّنات التعبيرية الجديدة إلى تطبيقاتك. يمكنك الاطّلاع على مزيد من المعلومات حول جميع المكوّنات الجديدة وتعديلات الأداء والتغييرات في السلوك في منشور المدوّنة. 

نص

نقل البيانات إلى BasicTextField المستند إلى الحالة

تم إيقاف BasicTextField المستندة إلى القيمة وMaterial 2 TextField نهائيًا. يوجّهك هذا التغيير إلى الانتقال إلى واجهتَي برمجة التطبيقات BasicTextField  وTextFieldState الأكثر فعالية والمستندتَين إلى الحالة.

إذا كنت تستخدم Material 3، لن يتم إيقاف وظائف TextField الحالية المستندة إلى القيمة نهائيًا في الإصدار 1.5.0، ولكن ننصحك بالانتقال إلى وظائف TextField وOutlinedTextField المستندة إلى الحالة للاستفادة بشكل كامل من الحالة المتزامنة والأداء المحسّن والميزات القادمة. إذا كنت لا تزال تستخدم Material 2، انتقِل مباشرةً إلى الحقول النصية المستندة إلى الحالة في Material 3.

من خلال نقل البيانات إلى TextFieldState، الذي يتيح حفظ الأنماط المنسَّقة واستعادتها بشكلٍ تلقائي، يمكنك الاستفادة من أداء محسَّن وجاهز للاستخدام ونموذج حالة متزامن وأكثر أمانًا. يزيل هذا الإصدار أيضًا التعليقات التوضيحية التجريبية من سجلّ التراجع/الإعادة وتغيير مخازن التتبُّع المؤقتة. تم إيقاف الأدوات المساعدة القديمة، مثل VisualTransformation، نهائيًا في هذا الإصدار، ما يفسح المجال لبدائل مبسّطة، مثل OutputTransformation وInputTransformation، بما في ذلك فلاتر الحد الأقصى للطول المضمّنة.

لمزيد من المعلومات حول كيفية الانتقال إلى حقول نصية مستندة إلى الحالة، يمكنك الاطّلاع على هذه الجلسة من مؤتمر Android Dev Summit لعام 2026: 

ارتفاع السطر لكل سطر 

عند عرض نص متعدد اللغات أو أحجام خطوط مختلطة ضمن فقرة واحدة، يمكن أن يؤدي تباعد الأسطر الموحّد إلى تداخل النصوص الطويلة (مثل البورمية أو الخميرية أو التايلاندية) مع الأسطر المجاورة. يقدّم الإصدار 1.13 من Compose ميزة LineHeightStyle.Mode.PerLine التي تحتسب ارتفاع السطر بشكل مستقل لكل سطر. يتيح ذلك للأسطر التي تحتوي على رموز أطول أو مسافات أكبر أن تتوسّع ديناميكيًا لتناسب حدودها الطبيعية بدون اقتصاص أو تعطيل بقية الفقرة.

image10.png
مقارنة بين Mode.Fixed (الوضع التلقائي، على اليمين) وMode.PerLine (على اليسار) لمنع تداخل النصوص في التنسيقات المتعددة اللغات

إعدادات FontVariation قابلة للدمج

يضيف الإصدار 1.13 من Compose عمليات دمج زائدة إلى FontVariation.Settings، ما يسهّل تحديد إعدادات الخطوط المتغيّرة الأساسية وتجاوز محاور معيّنة بشكل ديناميكي (مثل الوزن أو الميل أو العرض) بدون إعادة تخصيص قائمة الإعدادات بالكامل أو إعادة إنشائها.

// Define a shared base configuration for your variable font
val baseVariation = FontVariation.Settings(FontVariation.weight(400), FontVariation.width(100f))

 
// Easily override or combine specific axes inline
val boldVariation = baseVariation.merge(FontVariation.weight(700))
val condensedVariation = baseVariation.merge(FontVariation.width(85f))

الأداء

مهارة التحليل الثابت للأداء

أضفنا مهارة تحليل ثابت جديدة لأداء Jetpack Compose تتيح تدقيق الرموز البرمجية وإنشائها بدون أي إعدادات مسبقة في سبع فئات رئيسية، وهي الحالة والثبات، والتنسيقات الكسولة، والتنسيقات، والرسومات، والصور المتحركة، والتأثيرات وسلاسل المحادثات، وعمليات نقل البيانات إلى Modifier.Node، ما يتيح لك إجراء عمليات تحقّق مستقلة على أي طلب دمج أو ملف أو شاشة للامتثال لأفضل الممارسات الحالية. يمكنك تجربتها اليوم من خلال Android CLI.

مهارة تحسين الأداء في Jetpack Compose

computedStateOf

تم تقديم آلية جديدة لحساب الحالة، computedStateOf، في الإصدار 1.13. وهو بديل خفيف لـ derivedStateOf، ومخصّص لعمليات التحقّق من الشروط والحالة التي تمت فلترتها والمحسوبة من حالات أخرى تتغيّر بشكل متكرّر (مثل موضع الانتقال وحدود الصور المتحركة). من خلال عدم تخزين نتائج العمليات الحسابية مؤقتًا، يكون لديها عبء أقل من derivedStateOf، خاصةً عندما يتم إبطال العملية الحسابية من خلال تغيير إحدى الحالات المُشار إليها. 

يؤدي كلا النوعين من الحالة إلى إلغاء صلاحية التركيب عندما تتغير نتيجة العملية الحسابية، وليس عندما تتغير حالات الإدخال. ويتم تطبيقها عادةً لتحويل الحالات التي تتغيّر بشكل متكرّر إلى حالات تتغيّر بشكل غير متكرّر، ما يمنع عمليات الإبطال في التسلسل الهرمي للإنشاء بسبب تغييرات الحالة غير المؤثرة. يجب حجز derivedStateOf للعمليات الحسابية الكبيرة أو في الحالات التي يكون فيها التخزين المؤقت ضروريًا. بشكل عام، ننصح باستخدام computedStateOf بدلاً من derivedStateOf لحساب الحالة.

تتبُّع إعادة التركيب في Perfetto

تتبُّع إعادة التكوين هو طريقة جديدة لتعزيز تتبُّع التكوين الحالي بمعلومات جديدة حول قراءات الحالة وكتابات الحالة، ما يمنحك نظرة عامة كاملة على تغييرات الحالة التي تسبّبت في إعادة التكوين. بالنسبة إلى كل عملية قراءة وكتابة تؤثر في التركيب، تسجّل الأداة تمثيل السلسلة للحالة وتتبع تسلسل استدعاء الدوال البرمجية لتحديد سطر الرمز البرمجي الدقيق الذي حدث فيه التغيير.

يُرجى العِلم أنّ تسجيل بيانات إضافية لتتبُّع إعادة الإنشاء يضيف عبئًا إضافيًا، لذا تأكَّد من إيقافه عند التحقّق من أداء تطبيقك.

مقاييس الأداء الرئيسية

يتطابق الإصدار 1.13 من Compose مع الإصدار 1.12.1 من Compose في جميع مقاييس الأداء الأساسية لبدء التشغيل والتمرير مع معدّل تأخُّر في الاستجابة يبلغ %0 على هاتف Pixel 6. عند التشغيل على البارد، يحقّق الإصدار 1.13 من Compose وقتًا أسرع للعرض الأولي (147.65 ملي ثانية) مقارنةً بـ Views (152.87 ملي ثانية)

image4_size.png

تظلّ طريقة العرض أسرع في "الوقت المستغرَق للعرض الكامل" (180.32 ملي ثانية مقابل 202.79 ملي ثانية في Compose) بسبب الاختلافات في بدء تدفق البيانات وعمل تظليل وحدة معالجة الرسومات.  تبلغ مدة عرض الإطارات أثناء الانتقال للأعلى أو للأسفل (P50) ‏3.51 ملي ثانية في Compose مقارنةً بـ 3.06 ملي ثانية في Views، مع بقاء الأداء العام مستقرًا ومتسقًا في جميع عمليات التشغيل التجريبي الصالحة. نواصل الاستثمار بشكل كبير في تحسين الأداء على مستوى جميع مقاييس الأداء، مع التركيز على مقاييس بدء التشغيل. للاطّلاع على النتائج الكاملة، يُرجى مراجعة المستندات. 

لمزيد من المعلومات حول الأداء، يمكنك الاطّلاع على المحادثة من مؤتمر Android Dev Summit لعام 2026: 

التنسيقات

نموذج FlexBox والشبكة الثابتان

تمت ترقية تنسيقَي FlexBox وGrid (اللذين تم الإعلان عنهما في Compose 1.11) رسميًا من تجريبي إلى ثابت. تُعدّ واجهات برمجة التطبيقات هذه بدائل جاهزة للإنتاج وعالية الأداء للشبكات الملتفة والتصميمات سريعة الاستجابة. يوفّر FlexBox أيضًا إعدادًا جديدًا maxItemsInEachLine يتيح لك تحديد عدد العناصر في السطر عند تفعيل ميزة الالتفاف. 

يحلّ FlexBox محل تنسيقات Flow (FlowRow وFlowColumn)، وننصح باستخدام FlexBox بدلاً من تنسيقات Flow للرموز البرمجية الجديدة. للحصول على مقارنة تفصيلية بين حاويات التنسيق، يُرجى الاطّلاع على حاويات التنسيق.

تخطيط FlexBox يستجيب لتغييرات إعدادات الشاشة
تخطيط FlexBox يستجيب للتغييرات في إعدادات الشاشة.
تنسيق ثنائي الأبعاد مرن وقابل للتكيّف باستخدام Grid
تنسيق ثنائي الأبعاد مرن وقابل للتكيّف باستخدام Grid

إيقاف ConstraintLayout وMotionLayout نهائيًا

مع طرح أدوات أكثر حداثة للتخطيط والتحريك في Compose وواجهات برمجة تطبيقات Shared Element الجديدة، سنوقف نهائيًا استخدام ConstraintLayout وMotionLayout في Compose (العنصر androidx.constraintlayout:constraintlayout-compose). 

وتوفّر هذه البدائل الأحدث حلولاً فعّالة، ما يقدّم نهجًا مبسّطًا لإنشاء واجهات مستخدم معقّدة مدمجة في Compose. ننصحك بنقل استخدامات ConstraintLayout Compose إلى البدائل المذكورة أعلاه. 

Stable LazyLayoutCacheWindow

يوفّر تثبيت LazyLayoutCacheWindow ميزة التخزين المؤقت الفعّال والجلب المُسبق المستند إلى النوافذ مباشرةً لجميع مجموعات التحميل الكسول الأساسية، مثل القوائم والشبكات والشبكات المتداخلة. تعمل هذه الوظيفة على تحسين أداء التنسيقات الكسولة للمكوّنات خارج الشاشة. 

تشمل أهم الميزات في هذا الإصدار ما يلي:

  • إعدادات مبسّطة لواجهة برمجة التطبيقات: تم نقل إعدادات نافذة ذاكرة التخزين المؤقت من عنصر الاحتفاظ بحالة الانتقال (مثل rememberLazyListState) مباشرةً إلى الدوال المركّبة للتنسيق (LazyColumn و LazyVerticalGrid وما إلى ذلك)، ما يجعل الجلب المُسبَق والتخزين المؤقت من الاهتمامات المباشرة للتنسيق.
  • الجلب المُسبَق المستند إلى النافذة: يحلّ محلّ الجلب المُسبَق القديم المستند إلى العناصر باستخدام محرّك جلب مُسبَق تلقائي مستند إلى النافذة يحسب ديناميكيًا نافذة أمامية استنادًا إلى مقاييس إطار العرض، مع خيار تخصيص كلّ من النوافذ الأمامية والخلفية للاحتفاظ بالتركيبات خارج الشاشة.

يمكنك الاطّلاع على كيفية استفادة Instagram Direct من استخدام LazyLayoutCacheWindow في منشور المدوّنة حول دراسة الحالة، والاطّلاع على المستندات لمعرفة المزيد من المعلومات.

صورة متحركة

يوفّر الإصدار 1.13 من Compose استقرارًا في DeferredTransition ويقدّم دالة مركّبة جديدة، وهي CapturedAnimatedVisibility. 

CapturedAnimatedVisibility

يتطلّب AnimatedVisibility الاحتفاظ بالمحتوى والحالات الصادرة أثناء الحركة عند الخروج، لأنّه يواصل إنشاء المحتوى إلى أن تنتهي الحركة عند الخروج. عندما يعتمد المحتوى على الحالة التي اختفت، يمكن أن يتسبب ذلك في وميض مرئي. على سبيل المثال، عند إغلاق جزء التفاصيل، يتم ضبط العنصر المحدّد على null، ولا يتبقّى أي محتوى حالي لعرضه. سيظهر لك إما فراغ أو وميض في منتصف الحركة، أو عطل في حال استخدام !!، أو عليك الاحتفاظ بالقيمة القديمة بنفسك.

يقدّم الإصدار 1.13 من Compose CapturedAnimatedVisibility. لا تتطلّب هذه الدالة المركّبة من المتصل إدارة الحالات أثناء الخروج لأنّها تلتقط لقطة من آخر إطار بدلاً من ذلك عندما تصبح قيمة visible خاطئة. يمكنك محو الحالة على الفور، وسيظلّ تأثير الخروج المتحرّك يعرض ما كان على الشاشة. 

@Composable
fun TrackDetails(track: Track?) {
    // `track` becomes null as soon as the details are closed. CapturedAnimatedVisibility
    // removes the content right away and animates a snapshot of its last frame instead.
    CapturedAnimatedVisibility(
        visible = track != null,
        enter = fadeIn() + expandVertically(),
        exit = fadeOut(tween(800)) + shrinkVertically(tween(800)),
    ) {
        if (track != null) {
            TrackCard(track)
        }
    }
}
يؤدي إغلاق التفاصيل إلى ضبط المسار على قيمة فارغة.
يؤدي إغلاق التفاصيل إلى ضبط المسار على قيمة فارغة. باستخدام AnimatedVisibility (على اليمين)، تختفي البطاقة بدون أي تأثير متحرك. أما CapturedAnimatedVisibility (على اليسار)، فيعرض آخر لقطة من الصورة المتحركة.

يؤدي تحرير الحالة على الفور أيضًا إلى جعل عمليات الخروج أقل تكلفة: في مقاييس الأداء لدينا، يكون الأداء أثناء الخروج أسرع بنسبة %7 إلى %8 من حيث وقت عرض اللقطة مقارنةً بـ AnimatedVisibility. يمكنك مواصلة استخدام AnimatedVisibility عندما يكون المحتوى الحالي بحاجة إلى البقاء معروضًا، أو عندما تحتاج إلى استخدام Modifier.animateEnterExit() على عناصره الفرعية، وإلا يُفضَّل استخدام CapturedAnimatedVisibility.

معالجة حالات الفشل المخصّصة في الاختبارات

يتطلّب تصحيح أخطاء اختبارات واجهة المستخدم التي تعذّر إجراؤها، خاصةً في بيئات CI، فحص حالة الشاشة والتسلسل الهرمي للدلالات في اللحظة التي يتعذّر فيها تنفيذ عبارة التحقّق. يقدّم الإصدار 1.13 من Compose مسارًا أصليًا لمعالجة حالات التعطُّل من خلال TestFailurePolicy في ComposeUiTestConfig لإجراء تشخيصات الاختبارات بشكل آلي. 

باستخدام TestFailurePolicy، يمكنك:

  • التقاط العناصر المضمّنة: اضبط screenshotCaptureMode وuiHierarchyCaptureMode على CaptureMode.Enabled لتفريغ لقطة شاشة مرئية وشجرة دلالات واجهة المستخدم تلقائيًا في حال تعذّر الاختبار.
  • تشغيل معالِجات الأخطاء المخصّصة: سجِّل مثيلًا واحدًا أو أكثر من مثيلات TestFailureHandler لمعالجة FailureContext، ما يوفّر الجذر error وأي artifacts تم إنشاؤه. يتيح لك ذلك تحميل لقطات شاشة أو إعادة توجيه بيانات القياس عن بُعد الخاصة بالأعطال إلى أدوات إعداد التقارير الخارجية.
  • ضبط عمليات الالتقاط في حزمة اختبارية كاملة: يمكنك تفعيل عمليات التقاط لقطات الشاشة والتسلسل الهرمي لواجهة المستخدم على مستوى العالم في build.gradle.kts من خلال testInstrumentationRunnerArguments (androidx.compose.ui.test.failure.isScreenshotCaptureEnabled وandroidx.compose.ui.test.failure.isUiHierarchyCaptureEnabled) بدون تعديل ملفات الاختبار الفردية، مع الاحتفاظ بإمكانية إلغائها لكل اختبار.
val customConfig = ComposeUiTestConfig(
   failurePolicy = TestFailurePolicy(
       screenshotCaptureMode = TestFailurePolicy.CaptureMode.Enabled,
       uiHierarchyCaptureMode = TestFailurePolicy.CaptureMode.Enabled,
       failureHandlers = listOf(
           TestFailureHandler { context ->
               val screenshot = context.artifacts.firstOrNull {
                   it.type == FailureArtifact.Type.Screenshot
               }
               // Process or upload the artifact and context.error
           }
       )
   )
)
@Test
fun myTest() = runComposeUiTest(config = customConfig) {
   // Test content
}

مهارة تكيّفية

استخدِم المهارة التكيُّفية المعدَّلة لتحسين واجهة مستخدم Compose للأجهزة القابلة للطي وأجهزة الكمبيوتر المكتبي.

يمكنك إنشاء تجارب الشاشة المسطحة بدون لمس الجهاز على الأجهزة القابلة للطي من خلال عرض المحتوى على الشاشة العمودية ووضع عناصر التحكّم في النصف السفلي المسطّح، ما يمنع الأصابع من حجب الرؤية.
ستساعدك هذه المهارة أيضًا في جعل تطبيقك يبدو أصليًا على أجهزة الكمبيوتر المكتبي من خلال اختصارات لوحة المفاتيح وتلميحات الشاشة والمؤشرات المخصّصة، بالإضافة إلى الأنماط المُثبَتة لمنع فقدان الحالة عندما يقوم المستخدمون بتدوير أجهزتهم أو فتحها. يمكنك تجربتها اليوم من خلال Android CLI.

مهارة التكيّف في Jetpack Compose

شاهِد هذه المحاضرة في Android Dev Summit للتعرّف على كيفية تحسين توافق تطبيقك مع الأجهزة القابلة للطي وأجهزة الكمبيوتر المكتبي:

احتساب دقيق لسرعة الانتقال المتداخل للأعلى أو للأسفل 

بالنسبة إلى التطبيقات التي تتضمّن بنى واجهة مستخدم مختلطة، تم حلّ مشكلة كانت تؤدي أحيانًا إلى احتساب سرعة غير صحيحة عند الانتقال السريع في Compose المُدمَج داخل حاويات الانتقال في Android View (مثل ScrollView أو NestedScrollView أو CoordinatorLayout). يتم الآن احتساب عمليات نقل السرعة بدقة، ما يمنع التوقف المفاجئ أو فيزياء التمرير المتقطعة ويضمن تجربة تمرير سلسة عبر حدود View وCompose. 

تغيير في السلوك: 
تم إيقاف Modifier.onFocusedBoundsChanged نهائيًا

تم إيقاف Modifier.onFocusedBoundsChanged نهائيًا في الإصدار 1.12 من Compose، وتمت إزالة تنفيذه في الإصدار 1.13، ما يعني أنّه لن يكون له أي تأثير في حال تشغيل المُعدِّل. لم تكن الطريقة القديمة تُبلغ عن حدود التركيز بشكل موثوق في العديد من الحالات، وكانت تواجه مشاكل في الأداء. 

إنّ حاويات الانتقال المضمّنة، مثل LazyColumn وModifier.verticalScroll، تعرض المحتوى الذي يتم التركيز عليه بدون واجهة برمجة التطبيقات هذه، لذا لن تتأثر بها. 

للحصول على حدود العنصر الذي تم التركيز عليه، يمكنك استدعاء FocusTargetModifierNode.getFocusedRect() من Modifier.Node مخصّص. وتعرض الحدود عند طلبها، بدلاً من الإبلاغ عن كل تغيير من خلال استدعاء. للتفاعل مع تغييرات التركيز، استخدِم Modifier.onFocusChanged. للانتقال إلى عنصر مركَّز عليه في حاوية مخصّصة، يمكنك إقران onFocusChanged مع BringIntoViewRequester. 

تغيير في السلوك: التأثيرات الصوتية للتفاعل مع المنصة على Android 

أصبحت العناصر القابلة للنقر التي تم ضبطها باستخدام Modifier.clickable (أو المكوّنات المستندة إليها) تشغّل الآن تلقائيًا المؤثرات الصوتية العادية للتفاعل في Android، مع مراعاة إعدادات الصوت في نظام المستخدم. في السابق، كانت العناصر القابلة للنقر في Compose تتطلّب استدعاء المؤثرات الصوتية يدويًا لتحقيق التكافؤ مع عناصر View التقليدية في Android. يضمن هذا التحديث أن توفّر العناصر التفاعلية ملاحظات صوتية فورية وأن تكون متوافقة مع نظام Android الأساسي تلقائيًا. 

تعديل على الأنماط

في مؤتمر Google I/O، عرضنا طريقة جديدة لتخصيص المكوّنات بدون تفرُّع الرمز المصدر. في الإصدار 1.13 من Compose، تطوّرت هذه البنية الأساسية إلى محرّك تصميم غير مقيّد. بدلاً من ترميز الخصائص المرئية في إطار العمل، تم نقل تعريفات الخصائص إلى طبقة نظام التصميم، ما يتيح للفِرق تحديد رموز مخصّصة للعلامة التجارية (stylePropertyOf / styleLocalOf) باستقلالية تامة.

بسبب هذا التغيير في البنية، تظلّ Styles API تجريبية في الإصدار 1.13 من Compose. نعمل حاليًا مع شركائنا وفريق Material 3 لتحسين عملية دمج الأنماط وتسهيل استخدام المطوّرين لها قبل توفرها للجمهور العام. لقد أزلنا المستندات والمهارات المتعلّقة بالأنماط خلال هذه الفترة الانتقالية. 

مكتبة Compose Web الجديدة لتسهيل نقل WebView (إصدار أوّلي)

يُعدّ تضمين محتوى على الويب داخل Compose إحدى نقاط الاحتكاك النهائية في عملية نقل التطبيقات. قد تؤدي عمليات التنفيذ القديمة التي تستخدم AndroidView إلى حدوث تقطُّع في الانتقال وفقدان الحالة أثناء تغييرات الإعدادات أو التنقّل، وزيادة عبء عرض المحتوى في التشغيل التفاعلي.

للتخلّص من هذا التفاوت، سنطلق مكتبتَين تستندان إلى عنصرَين أساسيَين متكاملَين في androidx.web:

  • WebContent (متوفّر الآن في androidx.web:web:1.0.0-alpha01): هو عنصر احتفاظ بالحالة يفصل حالة الويب (بما في ذلك موضع الانتقال للأعلى أو للأسفل وإدخالات النماذج وسجلّ التنقّل وحالة JavaScript) عن هيكلية طرق العرض، ما يتيح له الاستمرار بعد تغييرات الإعدادات والتنقّل بدون تسرُّب Activity.
@Composable
// Assumes `webContent` is already created and retained (e.g., in a ViewModel or via `retain`)
fun WebContentPage(webContent: WebContent, startUrl: String, modifier: Modifier = Modifier) {
   key(webContent) {
       AndroidView(
           factory = { context ->
               webContent.attach(context, ::WebContentView).apply {
                   settings.javaScriptEnabled = true
                   if (url == null) loadUrl(startUrl)
               }
           },
           modifier = modifier,
           onRelease = { view ->
               // The view must leave the hierarchy before WebContent is detached.
               (view.parent as? ViewGroup)?.removeView(view)
               webContent.detach()
           },
       )
   }
}
  • WebSurface (ستتوفّر قريبًا): دالة مركّبة مخصّصة ومحسّنة لـ WebContent تتجاوز عبء التشغيل التفاعلي لـ AndroidView.

يمكنك تجربة واجهات برمجة التطبيقات اليوم من خلال استيراد androidx.web:web:1.0.0-alpha01، وترقَّب إصدار WebSurface الأولي في المستقبل القريب.

أداة عرض A2UI جديدة في Jetpack Compose

يجب ألا تقتصر ردود النماذج اللغوية الكبيرة (LLM) في وقت التشغيل على النص العادي. تنفّذ أداة العرض الجديدة Jetpack Compose A2UI Renderer بروتوكول Agent-to-UI (A2UI) المفتوح. 

implementation("androidx.compose.material3:material3-a2ui:1.0.0-alpha02")

يمكن لوكلاء الذكاء الاصطناعي إنشاء واجهات مستخدم تفاعلية وغنية في وقت التشغيل، ويتم عرضها كمكوّنات Compose أصلية بدون تنفيذ رمز عشوائي. يعالج العارض تحليل الرسائل والتحقّق من صحة المخطط، ويُدخل بيانات الوكيل في حالة لقطة Compose. يمكنك استخدام "الكتالوج الأساسي" الجاهز أو إضافة الدوال المركّبة ونظام التصميم الخاص بك. يمكنك البدء بالاطّلاع على المستندات أو مشاهدة الجلسة من مؤتمر Android DevSummit. 

التعديلات التي تم إجراؤها على المستندات

تتوفّر لدينا مستندات جديدة تتناول Anchored draggable وNavigation3 Deep Links وAppState.

نتمنى لك تجربة ممتعة.

يوفّر الإصدار 1.13 من Compose تجربة تطوير تطبيقات أسهل وأكثر تعبيرًا من أي وقت مضى، وذلك بفضل تحديثات النصوص والرسومات والتنسيقات والأداء والمزيد. للاطّلاع على المجموعة الكاملة من التغييرات بين إصدارات قائمة المواد، يمكنك إلقاء نظرة على أداة مقارنة قائمة المواد لمعرفة الفرق.

لمزيد من المعلومات حول الميزات الجديدة في Compose، يمكنك مشاهدة أحدث الجلسات من مؤتمر Android Dev Summit.

تهمّنا ملاحظاتك دائمًا، لذا يُرجى مشاركة رأيك بشأن هذه التغييرات أو ما تريد رؤيته في المرة القادمة على Issue Tracker. نتمنى لك تجربة ممتعة.

من كتابة:
متابعة القراءة