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

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

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

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

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

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

الإنشاء القابل للإيقاف المؤقت في ميزة "التحميل المسبق الكسول"

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

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

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

لقد حسّنّا أيضًا الأداء في أماكن أخرى، من خلال إجراء تحسينات على 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. تتوافق الدالة Text القابلة للإنشاء في Material الآن مع سلوك autoSize.
• يوفّر مكوّن شريط الصور الدوّار الآن متغيرًا جديدًا هو HorizontalCenteredHeroCarousel variant.
• TimePicker تتيح الآن التبديل بين وضعَي أداة الاختيار والإدخال.
• يساعد مقبض السحب العمودي المستخدمين في تغيير حجم و/أو موضع لوحة تكيفية.

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

يُرجى العِلم أنّه يتم مواصلة تطوير واجهات برمجة التطبيقات 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

        },

    )

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

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

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

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

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:

• تحويل واجهة المستخدم: يمكنك تكرار عمليات التصميم من خلال النقر بزر الماوس الأيمن على @Preview واختيار "تحويل واجهة المستخدم"، ثم وصف التغيير باللغة الطبيعية.
• إنشاء @Preview: انقر بزر الماوس الأيمن على دالة مركّبة واختَر Gemini > إنشاء معاينة لـ [اسم الدالة المركّبة] .
• **تخصيص رموز Material** من خلال دعم جديد لمتغيرات الرموز في معالج مواد العرض المتجهة.
• إنشاء رمز من لقطة شاشة أو اطلب من Gemini مطابقة واجهة المستخدم الحالية مع صورة مستهدَفة. يمكن دمج ذلك مع دعم MCP عن بُعد، مثلاً للاتصال بملف Figma وإنشاء واجهة مستخدم Compose من التصاميم.
• إصلاح مشاكل جودة واجهة المستخدم من خلال تدقيق واجهة المستخدم بحثًا عن المشاكل الشائعة، مثل مشاكل تسهيل الاستخدام، ثم اقتراح حلول.

لمشاهدة هذه الأدوات قيد التنفيذ، اطّلِع على هذا العرض التوضيحي الأخير:

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

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