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

ما الجديد في إصدار ديسمبر 2025 من Jetpack Compose؟

قراءة لمدة 6 دقائق
Nick Butcher
مدير منتجات

أصبح إصدار ديسمبر 2025 من Jetpack Compose مستقرًا اليوم. يحتوي هذا الإصدار على الإصدار 1.10 من وحدات Compose الأساسية والإصدار 1.4 من Material 3 (اطّلِع على عملية الربط الكاملة لـ قائمة إدارة الإصدارات)، ما يضيف ميزات جديدة وتحسينات كبيرة في الأداء.

لاستخدام إصدار اليوم، عليك ترقية إصدار قائمة إدارة الإصدارات في Compose إلى 2025.12.00:

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

تحسينات الأداء

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

janky.png

مقياس أداء التمرير الذي يقارن بين طريقة العرض وJetpack Compose في إصدارات مختلفة من Compose

الإنشاء القابل للإيقاف المؤقت في عملية الجلب المسبق الكسول

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

في السابق، كان يجب إكمال عملية الإنشاء بعد بدئها. إذا كانت عملية الإنشاء معقّدة، قد يؤدي ذلك إلى حظر سلسلة التعليمات الرئيسية لفترة أطول من إطار واحد، ما يؤدي إلى تجمّد واجهة المستخدم. باستخدام ميزة "الإنشاء القابل للإيقاف المؤقت"، يمكن لوقت التشغيل الآن "إيقاف" عمله مؤقتًا إذا كان الوقت ينفد واستئناف العمل في الإطار التالي. يكون ذلك فعالاً بشكل خاص عند استخدامه مع ميزة "الجلب المسبق للتنسيق الكسول" لإعداد الإطارات مسبقًا. تُعدّ واجهات برمجة التطبيقات Lazy layout CacheWindow التي تم طرحها في Compose 1.9 طريقة رائعة لإجراء جلب مسبق للمزيد من المحتوى والاستفادة من ميزة "الإنشاء القابل للإيقاف المؤقت" لإنتاج أداء أكثر سلاسة في واجهة المستخدم.

pausable.gif

يساعد الجمع بين ميزة "الإنشاء القابل للإيقاف المؤقت" وميزة "الجلب المسبق الكسول" في الحدّ من مشاكل واجهة المستخدم

لقد حسّنّا أيضًا الأداء في أماكن أخرى، من خلال إجراء تحسينات على Modifier.onPlaced وModifier.onVisibilityChanged وعمليات تنفيذ المعدِّلات الأخرى. سنواصل الاستثمار في تحسين أداء Compose.

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

الاحتفاظ

تقدّم Compose عددًا من واجهات برمجة التطبيقات للاحتفاظ بالحالة وإدارتها خلال دورات حياة مختلفة، مثلاً، remember تحتفظ بالحالة خلال عمليات الإنشاء، وrememberSavable/rememberSerializable للاحتفاظ بالحالة خلال إعادة إنشاء النشاط أو العملية.retain هي واجهة برمجة تطبيقات جديدة تقع بين واجهات برمجة التطبيقات هذه، ما يتيح لك الاحتفاظ بالقيم خلال تغييرات الإعدادات بدون أن يتم نشرها على نحو متسلسل، ولكن ليس خلال إيقاف العملية نهائيًا. بما أنّ الدالة retain لا تنشر حالتك على نحو متسلسل، يمكنك الاحتفاظ بعناصر مثل تعابير لامدا والتدفقات والعناصر الكبيرة مثل الصور النقطية التي لا يمكن نشرها على نحو متسلسل بسهولة. على سبيل المثال، يمكنك استخدام retain لإدارة مشغّل وسائط (مثل ExoPlayer) لضمان عدم انقطاع تشغيل الوسائط بسبب تغيير الإعدادات.

@Composable

fun MediaPlayer() {

    val applicationContext = LocalContext.current.applicationContext

    val exoPlayer = retain { ExoPlayer.Builder(applicationContext).apply { ... }.build() }

    ...

}

نريد أن نتقدّم بالشكر إلى منتدى AndroidDev (خاصةً فريق Circuit) الذي أثّر في تصميم هذه الميزة وساهم فيه.

Material 1.4

يضيف الإصدار 1.4.0 من مكتبة material3 عددًا من المكوّنات والتحسينات الجديدة:

  • TextField يقدّم الآن إصدارًا تجريبيًا يستند إلى TextFieldState، ما يوفّر طريقة أكثر فعالية لإدارة حالة النص. بالإضافة إلى ذلك، يتم الآن تقديم نوعَين جديدَين من SecureTextField و OutlinedSecureTextField. تتوافق الدالة material Text القابلة للإنشاء الآن مع سلوك autoSize.
  • يقدّم مكوّن "الصور الدوّارة" الآن نوعًا جديدًا هو HorizontalCenteredHeroCarousel variant.
  • TimePicker يتيح الآن التبديل بين وضعَي أداة الاختيار والإدخال.
  • يساعد مقبض السحب العمودي المستخدمين في تغيير حجم و/أو موضع لوحة تكيفية.
centered-hero-carousel.webp

الصور الدوّارة الأفقية في المنتصف

يُرجى العِلم أنّه يتم مواصلة تطوير واجهات برمجة التطبيقات Material 3 Expressive في الإصدارات التجريبية من مكتبة material3. لمزيد من المعلومات، اطّلِع على هذا الحديث الأخير:

ميزات الرسوم المتحركة الجديدة

نواصل توسيع نطاق واجهات برمجة التطبيقات للرسوم المتحركة، بما في ذلك التعديلات اللازمة لتخصيص الرسوم المتحركة للعناصر المشترَكة.

العناصر المشترَكة الديناميكية

تحاول الرسوم المتحركة sharedElement() وsharedBounds() تلقائيًا تحريك

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

للتحكّم في ما إذا كان سيحدث الانتقال بين العناصر المشترَكة، يمكنك الآن تخصيص SharedContentConfig الذي يتم تمريره إلى rememberSharedContentState(). تحدّد السمة isEnabled ما إذا كان العنصر المشترَك نشطًا.

SharedTransitionLayout {

        val transition = updateTransition(currentState)

        transition.AnimatedContent { targetState ->

            // Create the configuration that depends on state changing.

            fun animationConfig() : SharedTransitionScope.SharedContentConfig {

                return object : SharedTransitionScope.SharedContentConfig {

                    override val SharedTransitionScope.SharedContentState.isEnabled: Boolean

                        get() =

                            // determine whether to perform a shared element transition

                }

            }

}

يمكنك الاطّلاع على المستندات لمزيد من المعلومات.

‫Modifier.skipToLookaheadPosition()

تمت إضافة معدِّل جديد، هو Modifier.skipToLookaheadPosition()، في هذا الإصدار، ويحتفظ هذا المعدِّل بالموضع النهائي لعنصر قابل للإنشاء عند تنفيذ الرسوم المتحركة للعناصر المشترَكة. يسمح ذلك بتنفيذ تأثيرات انتقالية مثل الرسوم المتحركة من نوع "الكشف"، كما هو موضّح في نموذج Androidify مع الكشف التدريجي عن الكاميرا. يمكنك الاطّلاع على نصيحة الفيديو هنا لمزيد من المعلومات: 

السرعة الأولية في عمليات الانتقال بين العناصر المشترَكة

يضيف هذا الإصدار واجهة برمجة تطبيقات جديدة للانتقال بين العناصر المشترَكة، هي prepareTransitionWithInitialVelocity، ما يتيح لك تمرير سرعة أولية (مثل سرعة الإيماءة) إلى عملية الانتقال بين العناصر المشترَكة:

Modifier.fillMaxSize()

    .draggable2D(

        rememberDraggable2DState { offset += it },

        onDragStopped = { velocity ->

            // Set up the initial velocity for the upcoming shared element

            // transition.

            sharedContentStateForDraggableCat

                ?.prepareTransitionWithInitialVelocity(velocity)

            showDetails = false

        },

    )
fling-shared.gif

عملية انتقال بين العناصر المشترَكة تبدأ بسرعة أولية من إيماءة

عمليات الانتقال المحجوبة

EnterTransition وExitTransition تحدّدان كيفية ظهور أو اختفاء دالة مركّبة AnimatedVisibility/AnimatedContent. يتيح لك خيار الحجاب التجريبي الجديد تحديد لون لحجب المحتوى أو إخفائه، مثلاً، إظهار/إخفاء طبقة سوداء شبه شفافة فوق المحتوى:

veil_2.gif

محتوى متحرك محجوب: يُرجى ملاحظة الحجاب (أو الستارة) شبه الشفاف فوق محتوى الشبكة أثناء الرسوم المتحركة

AnimatedContent(

    targetState = page,

    modifier = Modifier.fillMaxSize().weight(1f),

    transitionSpec = {

        if (targetState > initialState) {

            (slideInHorizontally { it } togetherWith

                    slideOutHorizontally { -it / 2 } + veilOut(targetColor = veilColor))

        } else {

            slideInHorizontally { -it / 2 } +

                    unveilIn(initialColor = veilColor) togetherWith slideOutHorizontally { it }

        }

    },

) { targetPage ->

    ...

}

التغييرات القادمة

إيقاف Modifier.onFirstVisible نهائيًا

طرح الإصدار 1.9 من Compose Modifier.onVisibilityChanged وModifier.onFirstVisible. بعد مراجعة ملاحظاتك، تبيّن أنّه لا يمكن الالتزام بشكلٍ حتمي بعقد Modifier.onFirstVisible، تحديدًا عندما يصبح أحد العناصر مرئيًا لأول مرة. على سبيل المثال، قد يتخلّص تنسيق كسول من العناصر التي يتم تمريرها خارج إطار العرض، ثم يعيد إنشاءها إذا تم تمريرها مرة أخرى إلى إطار العرض. في هذه الحالة، سيتم تشغيل معاودة الاتصال onFirstVisible مرة أخرى، لأنّه عنصر تم إنشاؤه حديثًا. سيحدث سلوك مماثل أيضًا عند الرجوع إلى شاشة تم عرضها سابقًا تحتوي على onFirstVisible. على هذا النحو، قرّرنا إيقاف هذا المعدِّل نهائيًا في إصدار Compose التالي (1.11) وننصحك بالانتقال إلى onVisibilityChanged. يمكنك الاطّلاع على المستندات لمزيد من المعلومات.

إرسال الروتينات الفرعية في الاختبارات

نخطّط لتغيير عملية إرسال الروتينات الفرعية في الاختبارات لتحسين عدم استقرار الاختبارات ورصد المزيد من المشاكل. تستخدم الاختبارات حاليًا UnconfinedTestDispatcher، الذي يختلف عن سلوك الإنتاج، مثلاً، قد يتم تشغيل التأثيرات على الفور بدلاً من وضعها في قائمة الانتظار. في إصدار مستقبلي، نخطّط لطرح واجهة برمجة تطبيقات جديدة تستخدم StandardTestDispatcher تلقائيًا لمطابقة سلوكيات الإنتاج. يمكنك تجربة السلوك الجديد الآن في الإصدار 1.10:

@get:Rule // also createAndroidComposeRule, createEmptyComposeRule

val rule = createComposeRule(effectContext = StandardTestDispatcher())

سيؤدي استخدام StandardTestDispatcher إلى وضع المهام في قائمة الانتظار، لذا عليك استخدام آليات المزامنة مثل composeTestRule.waitForIdle() أو composeTestRule.runOnIdle(). إذا كان اختبارك يستخدم runTest، عليك التأكّد من أنّ runTest وقاعدة Compose تشتركان في مثيل StandardTestDispatcher نفسه للمزامنة.

// 1. Create a SINGLE dispatcher instance

val testDispatcher = StandardTestDispatcher()



// 2. Pass it to your Compose rule

@get:Rule

val composeRule = createComposeRule(effectContext = testDispatcher)



@Test

// 3. Pass the *SAME INSTANCE* to runTest

fun myTest() = runTest(testDispatcher) {

    composeRule.setContent { /* ... */ }

}

الأدوات

تستحق واجهات برمجة التطبيقات الرائعة أدوات رائعة، ويتضمّن استوديو Android عددًا من الإضافات الأخيرة لمطوّري Compose:

لرؤية هذه الأدوات قيد التنفيذ، يمكنك مشاهدة هذا العرض التوضيحي الأخير:

نتمنى لك تجربة إنشاء ممتعة

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

متابعة القراءة