واجهة مستخدم "الإنشاء"

البنية

‫Compose هي مجموعة من 7 أرقام تعريف لمجموعات Maven ضمن androidx. تحتوي كل مجموعة على مجموعة فرعية مستهدَفة من الوظائف، ولكل منها مجموعة خاصة من ملاحظات الإصدار.

يوضّح هذا الجدول المجموعات ويتضمّن روابط لكل مجموعة من ملاحظات الإصدار.

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

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

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

dependencies {
    implementation "androidx.compose.ui:ui:1.12.1"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("androidx.compose.ui:ui:1.12.1")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

الملاحظات

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

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

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

الإصدار 1.13

الإصدار ‎1.13.0-alpha03

‫9 سبتمبر 2026

تم طرح androidx.compose.ui:ui-*:1.13.0-alpha03. يتضمّن الإصدار 1.13.0-alpha03 هذه التعديلات.

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

• تم إيقاف عمليات التحميل الزائد لحقل النص في Material 2 التي تقبل المَعلمات value, onValueChange نهائيًا. يُرجى الانتقال إلى التحميل الزائد الذي يستخدم TextFieldState لرفع حالته. (I6b841، b/556234973)
• أضِف واجهة برمجة تطبيقات شائعة لإيقاف WindowInsetsRulers على مستوى العالم قبل إنشاء أول جذر Compose. إيقاف Android فقط ComposeView.disableWindowInsetsRulers() نهائيًا واستخدام التنسيق الشائع WindowInsetsRulers.disable() (Iadc8f)
• تضيف هذه الحزمة دالتَي PolygonShape.transformed وPolygonShape.scaledToFit في Compose Foundation لتحويل أشكال المضلّعات وتناسبها. (I3f327)
• أعاد المعدِّل تسمية الدالة LineHeight.Trim.isTrimLastLineBottom() إلى LineHeight.Trim.trimsLastLineBottom وLineHeight.Trim.isTrimFirstLineTop إلى LineHeight.Trim.trimsFirstLineTop (I02211)
• تمت إضافة boundsAssertionTolerance إلى PlatformTestConfig ضمن ComposeUiTestConfig.platform للسماح للاختبارات بضبط هامش التفاوت التلقائي لتأكيد الحدود على مستوى البيئة/القاعدة. (I7819d، b/545673912)
• تم إيقاف تحميلات BasicTextField التي تقبل مَعلمات value, onValueChange نهائيًا. يُرجى نقل البيانات إلى الدالة المتعددة الأشكال BasicTextField التي تستخدم TextFieldState لرفع حالتها. (I636bf، b/552879150)
• تماشيًا مع BasicTextField(value, onValueChange)، تم أيضًا إيقاف VisualTransformation نهائيًا لأنّه لا يتم عرضه إلا من خلال إصدار TextField هذا. يجب نقل عمليات التحويل الحالية إلى OutputTransformation. (I636bf، b/552879150)
• تمت إضافة LineHeightStyle.Mode.PerLine لاحتساب ارتفاع السطر بشكل مستقل لكل سطر، ما يتيح استخدام أحجام خطوط مختلفة في الفقرة نفسها بدون تداخل. (I41738)
• تم إيقاف توفير LazyLayoutCacheWindow وLazyListPrefetchStrategy من خلال LazyListState نهائيًا، وأصبح من الأفضل توفير LazyLayoutCacheWindow للدالة المركّبة. (I71f19)
• تمت إضافة واجهة برمجة التطبيقات Modifier.blur { ... } لدعم التمويهات التدريجية (مثل التدرجات اللونية والمظلّلات المخصّصة) (Ie6595، b/481685669)
• تمت إضافة Modifier.interactionBarrier() لحظر التفاعلات مع اللمس والتركيز وإمكانية الوصول. (I7c1b7، b/347038246)
• تمت إضافة السمة isCrossWindowBlurEnabled في WindowInfo للسماح للمطوّرين بالبحث عن حالة التمويه على مستوى جميع النوافذ ومراقبتها على Android. (If38e2، b/538405295)
• تمت إضافة LocalWindow CompositionLocal للسماح باسترداد عنصر android.view.Window الحالي، ما يسهّل التحكّم في واجهات برمجة التطبيقات على مستوى النافذة من داخل العناصر القابلة للإنشاء. (I4d4ff، b/221889664)

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

• مفعَّل isMinimalistLocalsEnabled تلقائيًا. (Ibb4eb، b/523295932)
• تم تفعيل تحسين ارتفاع السطر الواحد تلقائيًا. وقد يؤدي ذلك إلى اختلاف بسيط في بعض مقاييس النص، مثل الارتفاع أو مسار التحديد (I5575a).
• تم تعديل compileSdk لمكتبات Compose إلى الإصدار 37.1. سيتطلّب ذلك تعديل compileSdk بشكل متعدٍّ لجميع التطبيقات والمكتبات التي تستخدم Compose. (I05b0f)
• تم إصلاح مشكلة عدم وضع علامة على مساحات WindowInsetsRulers أداة IME الداخلية على أنّها متحركة أثناء استخدام إيماءة إظهار شاشة الرجوع، وتم إصلاح مشكلة عدم تعديل imePadding عند تبديل التركيز بين حقول النص. (Id4562، b/537386261، b/539686000)
• تم إصلاح مشكلة تجاهل إيماءات الضغط على لوحة التتبُّع عند استضافة ComposeView داخل ViewGroup Android عادي. (I80f79)

المساهمة الخارجية

• تم إصلاح تسريب النشاط عند فصل ComposeView وإعادة ربطه ضمن إطار واحد، مثلاً عند إعادة ترتيبه باستخدام removeView وaddView. (Ib5129، b/547675867)

الإصدار ‎1.13.0-alpha02

‫26 أغسطس 2026

تم طرح androidx.compose.ui:ui-*:1.13.0-alpha02. يتضمّن الإصدار 1.13.0-alpha02 هذه التعديلات.

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

• تمت إضافة السمة الدلالية الجديدة BackgroundColor إلى Modifier.background (I7eec3، b/518049030)
• يمكنك الآن إنشاء Vertices من مصفوفات أولية حالية. (Ifaba8، b/496412761)
• ستشارك السمة VectorPainter الآن مراجع الرسومات الداخلية (ImageBitmap) عند عرض ImageVector نفسه في عناصر متعددة قابلة للإنشاء. يؤدي ذلك إلى تقليل عمليات تحميل النسيج المتكرّرة واستخدام الذاكرة، ما يحسّن الأداء في سيناريوهات مثل القوائم التي تستخدم رموزًا متكرّرة. يمكن إيقاف هذا التحسين من خلال ComposeUiFlags.isVectorDrawCacheSharingEnabled. (I35639، b/331283180)
• إضافة أداة مساعدة requestFocusForChildInLocalBounds (Ib1a48)

الإصدار ‎1.13.0-alpha01

‫12 أغسطس 2026

تم طرح androidx.compose.ui:ui-*:1.13.0-alpha01. يتضمّن الإصدار 1.13.0-alpha01 هذه التعديلات.

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

• تضيف علامة الميزة isVelocityTrackerMinSampleSizeFixEnabled (Ic9b51، b/533444810، b/533775739، b/523705159)
• تمت إزالة فئة التعليقات التوضيحية القديمة ExperimentalVelocityTrackerApi. (I6f9c6، b/483449576)
• إزالة العلامة isClearNestedScrollCoroutineScopeFixEnabled (Iedfd7، b/506963276)
• يحفظ TextFieldState معلومات نمط النص ويستعيدها الآن. أصبحت AnnotatedString.Annotation.Saver متاحة للجميع الآن للسماح بحفظ واستعادة عناصر AnnotatedString.Annotation. (I8b533، b/135556699)
• تمت إضافة TestFailurePolicy وTestFailureHandler في ComposeTestConfig لدعم معالجات أحداث الأعطال المخصّصة وسياق العنصر الذي تعذّر تحميله في اختبارات واجهة مستخدم Compose. (Ib1a85 وb/414802953 وb/291106656 وb/430644575)
• تمت إضافة SemanticsProperties.alpha لعرض قيم ألفا المركّبة التي تم حلّها للعناصر الرئيسية والفرعية لعُقد التصميم بغرض الاختبار. (Ifddb6، b/524035059)
• تم إيقاف التحميل الزائد createComposeRule وcreateAndroidComposeRule وcreateEmptyComposeRule نهائيًا في حزمة الإصدار الثاني من ui-test-junit4 التي تتضمّن مَعلمات فردية. استخدِم عمليات التحميل الزائد التي تقبل ComposeUiTestConfig أو عمليات التحميل الزائد بدون مَعلمات التي تستخدم قيمة تلقائية ComposeUiTestConfig. يُرجى العِلم أنّ قيمة ComposeUiTestConfig التلقائية تضبط وضع الإدخال الأولي على InputMode.Touch في بداية كل اختبار. قد يؤدي ذلك إلى تعذُّر إجراء الاختبارات الحالية التي تتطلّب وضع لوحة المفاتيح (InputMode.Keyboard). لإصلاح الاختبارات المتأثّرة، عليك تمرير ComposeUiTestConfig(inputMode = InputMode.Keyboard) بشكلٍ صريح وإزالة أي منطق إعداد يدوي لأوضاع الإدخال. بدلاً من ذلك، يمكنك ضبط AndroidComposeUiTestFlags.isInputModeSetForDeviceTests = false لإيقاف ضبط وضع الإدخال التلقائي مؤقتًا في بداية كل اختبار والاحتفاظ بالسلوك القديم أثناء نقل اختباراتك. ستتم إزالة هذا الخيار في المستقبل، لذا إذا لم تنجح إلا مجموعة صغيرة من الاختبارات، ننصحك بحلّ المشاكل مباشرةً عن طريق تغيير إعداداتها بدلاً من ذلك. (Idfb86، b/504195741)
• تستخدم طلبات عدم توفّر وسيطة إلى createComposeRule وcreateAndroidComposeRule (مثل createComposeRule() أو createAndroidComposeRule<MyActivity>()) الآن ComposeUiTestConfig تلقائيًا، ما يضبط وضع الإدخال الأولي على InputMode.Touch في بداية كل اختبار، ما يضمن أن يكون الجهاز في حالة نظيفة ويمنع تسريب تغييرات وضع الإدخال السابقة بين الاختبارات. ومع ذلك، قد يؤدي وضع اللمس التلقائي الجديد هذا إلى تعذُّر اجتياز الاختبارات الحالية التي تتوقّع وضع لوحة المفاتيح (InputMode.Keyboard). لإصلاح الاختبارات المتأثّرة، يجب اجتياز ComposeUiTestConfig(inputMode = InputMode.Keyboard) بشكلٍ صريح وإزالة أي منطق إعداد يدوي لأوضاع الإدخال. بدلاً من ذلك، يمكنك ضبط AndroidComposeUiTestFlags.isInputModeSetForDeviceTests = false لإيقاف ضبط وضع الإدخال التلقائي مؤقتًا في بداية كل اختبار والاحتفاظ بالسلوك القديم أثناء نقل اختباراتك. ستتم إزالة هذا الخيار في المستقبل، لذا إذا لم تنجح إلا مجموعة صغيرة من الاختبارات، ننصحك بحلّ المشاكل مباشرةً عن طريق تغيير إعداداتها بدلاً من ذلك. (Idc4dd، b/267253920، b/504195741)
• تمت إضافة تعليقات توضيحية إلى طرق أساسية فارغة قابلة للتجاوز في Compose باستخدام @EmptySuper للإشارة إلى أنّه يجب ألا تستدعي عمليات التنفيذ المتجاوزة super. (Id407b)
• أصبحت ExposedDropdownMenu الآن دالة إضافة في ExposedDropdownMenuBoxScope بدلاً من أن تكون عضوًا. قد تحتاج إلى تعديل الرمز باستخدام عملية استيراد جديدة. (Ie8a65، b/356452026)
• تمت إضافة السمات blurBehindRadius وbackgroundBlurRadius وscrimAlpha وwindowShape إلى DialogProperties، بالإضافة إلى blurBehindRadius وscrimAlpha إلى PopupProperties. يمكن للمطوّرين الآن ضبط تمويه الخلفية وتمويه النافذة وعتامة طبقة التعتيم مباشرةً في مربّعات الحوار والنوافذ المنبثقة. يسمح الإعداد windowShape بتعتيم خلفية مربّع حوار قص الشاشة عند الزوايا الدائرية. (I5d437)
• تمت إزالة علامة الميزة - تحتفظ أزرار "إنشاء" الآن بتركيز تسهيل الاستخدام بشكل صحيح ولا تومض عندما تكون ميزة "الاستكشاف باللمس" مفعّلة، وذلك لأنّه يتم وضع علامة على أحداث التمرير على أنّها معالَجة بشكل صحيح. (Ib1c80)
• تمت إضافة عمليات تحميل زائدة للدمج إلى FontVariation.Settings لدمج مجموعات الإعدادات الأخرى أو تجاهل الإعدادات المضمّنة. (I6340c)
• تم عرض variationSettings في واجهة "الخط"، مع ضبط القيمة التلقائية على FontVariation.Empty الجديد. تم تحسين أداة إنشاء FontVariation.Settings vararg لاستخدام asList() لتجنُّب عمليات تخصيص نسخ المصفوفات. (I9c22f)
• تم تعديل السمة NestedScrollDispatcher.coroutineScope لعرض CoroutineScope تم إلغاؤه بأمان عند عدم ربطه أو فصله. (I9b112، b/535290281)
• تم إيقاف التحميل الزائد runComposeUiTest وrunAndroidComposeUiTest وAndroidComposeUiTestEnvironment نهائيًا والذي يقبل المَعلمات الفردية effectContext وrunTestContext وtestTimeout. استخدِم عمليات التحميل الزائد التي تقبل ComposeUiTestConfig أو عمليات التحميل الزائد بدون مَعلمات التي تستخدم قيمة تلقائية ComposeUiTestConfig. يُرجى العِلم أنّ قيمة ComposeUiTestConfig التلقائية تضبط وضع الإدخال الأولي على InputMode.Touch في بداية كل اختبار. قد يؤدي ذلك إلى تعذُّر إجراء الاختبارات الحالية التي تتطلّب وضع لوحة المفاتيح (InputMode.Keyboard). لإصلاح الاختبارات المتأثّرة، عليك تمرير ComposeUiTestConfig(inputMode = InputMode.Keyboard) بشكلٍ صريح وإزالة أي منطق إعداد يدوي لأوضاع الإدخال. بدلاً من ذلك، يمكنك ضبط AndroidComposeUiTestFlags.isInputModeSetForDeviceTests = false لإيقاف ضبط وضع الإدخال التلقائي مؤقتًا في بداية كل اختبار والاحتفاظ بالسلوك القديم أثناء نقل اختباراتك. ستتم إزالة هذا الخيار في المستقبل، لذا إذا تعذّر اجتياز عدد صغير فقط من الاختبارات، ننصحك بحلّ المشاكل مباشرةً عن طريق تغيير إعدادات الاختبارات بدلاً من ذلك. (Ia6d55، b/504195741)
• تستخدم الآن عمليات استدعاء runComposeUiTest وrunAndroidComposeUiTest وAndroidComposeUiTestEnvironment التي تتضمّن تعبير lambda لاحقًا فقط قيمة ComposeUiTestConfig تلقائية، ما يضبط وضع الإدخال الأوّلي على InputMode.Touch في بداية كل اختبار، ويضمن أن يكون الجهاز في حالة نظيفة ويمنع تسريب تغييرات وضع الإدخال السابقة إلى الاختبارات. ومع ذلك، قد يؤدي وضع اللمس التلقائي الجديد هذا إلى تعذُّر اجتياز الاختبارات الحالية التي تتوقّع وضع لوحة المفاتيح (InputMode.Keyboard). لإصلاح الاختبارات المتأثّرة، يجب اجتياز ComposeUiTestConfig(inputMode = InputMode.Keyboard) بشكلٍ صريح وإزالة أي منطق إعداد يدوي لأوضاع الإدخال. بدلاً من ذلك، يمكنك ضبط AndroidComposeUiTestFlags.isInputModeSetForDeviceTests = false لإيقاف ضبط وضع الإدخال التلقائي مؤقتًا في بداية كل اختبار والاحتفاظ بالسلوك القديم أثناء نقل اختباراتك. ستتم إزالة هذا الخيار في المستقبل، لذا إذا تعذّر اجتياز عدد صغير فقط من الاختبارات، ننصحك بحلّ المشاكل مباشرةً عن طريق تغيير إعدادات الاختبارات بدلاً من ذلك. (I8c85d، b/504195741)
• تمت إضافة ‎ @CheckResult إلى SemanticsNodeInteraction.isDisplayed() وisNotDisplayed() لضمان تأكيد القيم المعروضة، ما يمنع حدوث حالات تعذُّر الاختبار بدون إشعار عندما يستخدمها المطوّرون عن طريق الخطأ بدلاً من واجهات برمجة تطبيقات التأكيد. (I1b447، b/508178494)
• ستؤدي العلامة AndroidComposeUiFlag.isDelayAndroidViewsHandlerCreationEnabled إلى إنشاء مثيل ViewGroup الذي يحتوي على AndroidView فقط عند إضافة AndroidView لتحسين أداء ComposeView التي لا تحتوي على AndroidView. عند إيقاف العلامة، يتم إنشاء ViewGroup الحاوي وإرفاقه عند إرفاق ComposeView بالنافذة. (I306a3، b/524283041)
• إضافة coroutineScopeOrNull() في NestedScrollDispatcher، وهي واجهة برمجة تطبيقات بديلة للوصول إلى نطاق الروتين الفرعي الرئيسي للمرسل (I18c0f)
• غيِّر clearCallbacks إلى runAndClearCallbacks للتأكّد من تنفيذ إجراءات التنظيف دائمًا. (If4720، b/526700075)
• تمت إعادة تسمية ComposeTestConfig إلى ComposeUiTestConfig ونقلها من حزمة الإصدار 2 إلى حزمة androidx.compose.ui.test الرئيسية. (I1d2a1، b/504195741)
• تمت إضافة المَعلمة timeoutMillis (القيمة التلقائية هي 2000 ملي ثانية) إلى SemanticsNodeInteraction.captureToImage() للسماح بإعداد مهلة مخصّصة عند انتظار عمليات إعادة الرسم. (Ib7d62، b/249501063)
• إضافة معلومات سابقة إلى التغييرات في إدخال المؤشر غير المباشر (Ie62d2، b/526961645)
• تمت إضافة السمة الدلالية hintText الجديدة لتمثيل نص التلميح في حقول النص، ما يؤدي إلى تحسين إمكانية الوصول من خلال الربط بـ AccessibilityNodeInfo.hintText. (Ib65da، b/448376876)
• تم تحسين دقة CompositionLocal من خلال حلّها بشكل ديناميكي من LocalOwner وLocalAndroidComposeView عند الطلب، ويمكن تفعيل هذا الخيار أو إيقافه باستخدام ComposeUiFlags.isMinimalistLocalsEnabled. (I2bf6d)
• لدى "androidx.benchmark" الآن minSdk يبلغ 24. (Ic2a85)
• تمت إضافة علامة تجريبية isPropagateHideFromAccessibilityToMergingChildrenEnabled إلى AndroidComposeUiFlags للتحكّم في نقل hideFromAccessibility إلى العناصر الفرعية التي يتم دمجها. (Ie41ff، b/483506400)
• تمت ترقية ComposeUiTest واختبار واجهات برمجة التطبيقات ذات الصلة (بما في ذلك الإصداران ComposeTestRule وwaitUntil) من إصدار تجريبي إلى إصدار ثابت. (Iaec77، b/471148519، b/485124363)
• تم إصلاح ترتيب التنقّل TalkBack في مجموعات التنقّل المدمَجة. ويمكن التراجع عن هذا التغيير إذا لزم الأمر من خلال إيقاف AndroidComposeUiFlags.isTraversalGroupSortingEnabled. (I5ae09، b/285043826)
• تزيل هذه السمة الدالة المساعدة التجريبية القديمة IndirectPointerEvent. (I05dee، b/499336763، b/501098299، b/501098376، b/513249467)
• استبدِل واجهة برمجة التطبيقات التجريبية ‎ @AnimationToolingApi بواجهة برمجة التطبيقات ‎ @RestrictTo التي توفّر ضمانات أكثر صرامة للتتبُّع. (Ia4fd1، b/524317805)
• تمت إضافة أداة الاختيار onDescendants() للعثور على جميع عقد الدلالات ضمن الشجرة الفرعية لعقدة معيّنة. (Id6b9b، b/444588117)
• تم إيقاف واجهات برمجة التطبيقات المساعدة waitUntilNodeCount وwaitUntilAtLeastOneExists وwaitUntilExactlyOneExists وwaitUntilDoesNotExist نهائيًا لأنّها لا تقبل useUnmergedTree. تمت إضافة عمليات تحميل زائد جديدة تقبل useUnmergedTree للسماح بانتظار العُقد في شجرة الدلالات غير المدمجة. (If675f، b/268432145)
• تمت إضافة المَعلمة tolerance إلى تأكيدات الحجم والموضع SemanticsNodeInteraction (assertWidthIsEqualTo وassertHeightIsEqualTo وassertTouchWidthIsEqualTo وassertTouchHeightIsEqualTo وassertPositionInRootIsEqualTo وassertTopPositionInRootIsEqualTo وassertLeftPositionInRootIsEqualTo) للسماح للمطوّرين بضبط حد المقارنة، ما يؤدي إلى تحسين قوة الاختبار على مستوى كثافات الشاشة المختلفة. (I3a477، b/202752461)
• تتيح اختبارات Compose الآن مزامنة سلسلة التعليمات الرئيسية. يمكنك الآن استدعاء واجهات برمجة التطبيقات للمزامنة (مثل waitForIdle() وrunOnIdle()) وتنفيذ تأكيدات أو إجراءات Compose بأمان مباشرةً ضمن عمليات معاودة الاتصال لواجهة المستخدم/سلسلة التعليمات البرمجية الرئيسية. (I0247a، b/498478569)
• تم تقديم نموذج إعداد جديد (ComposeTestConfig) لواجهات برمجة التطبيقات الخاصة باختبار Compose من أجل تبسيط إدارة المَعلمات وتحسين قابلية التوسّع. تمت إضافة إمكانية ضبط وضع الإدخال (اللمس/لوحة المفاتيح) مباشرةً من خلال ComposeTestConfig، ما يضمن الإعداد وإعادة الضبط تلقائيًا لمنع حدوث أخطاء متقطّعة في الاختبار بسبب تسرُّب الحالة. تمت إضافة عمليات تحميل زائدة جديدة للدالتين run*ComposeUiTest وcreate*ComposeRule تقبل العنصر ComposeTestConfig. (Ia3da9، b/267253920، b/504195741)
• تم إصلاح عُطل في "معاينة Compose" عند استخدام PreviewParameterProvider مع خصائص طلبات البحث عن الوسائط (Posture وPointerPrecision وما إلى ذلك) من خلال تغيير التمثيل الأساسي من String إلى Int. (Ic8f92، b/489939558)
• تمت إضافة المَعلمة includeInputText إلى hasTextExactly وassertTextEquals لتفعيل المطابقة التامة للنص الخام المدخَل مع النص المرئي. (Iee329، b/519026043)

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

• تم تحسين SaveableStateRegistry.performSave() لمنع عمليات تخصيص HashMap. يستخدم ScatterMap داخليًا. (I7d510)
• تمت إضافة ألوان النص إلى AccessibilityNodeInfo.ExtraRenderingInfo لعناصر Text Composables. (I11c94، b/518049030)
• تم إصلاح مشكلة كانت تؤدي إلى ظهور الخطأ IllegalStateException بدلاً من عرض null عند محاولة الوصول إلى NestedScrollDispatcher.coroutineScopeOrNull أثناء فصل عقدة التنسيق. (I55634، b/533444810)
• تم تحسين عملية تهيئة compose:ui خصائص فئة القيم ذات المستوى الأعلى على مستوى الملف باستخدام دوال جلب ديناميكية. (I34184)
• تم تحسين عملية تهيئة العنصر المصاحب لفئات ui-unit التي تتضمّن قيمة (TextUnit) من خلال استخدام دوال جلب ديناميكية. (If4a99)
• تم تحسين عملية تهيئة العنصر المصاحب المحسّن للقيمة ui-graphics في فئات (BlendMode وColor وما إلى ذلك) من خلال استخدام دوال جلب ديناميكية. (Iaa86a)
• تحسين عملية تهيئة الكائن المصاحب لفئات القيم compose:ui:ui (Key وCompositingStrategy وما إلى ذلك) باستخدام أدوات الجلب الديناميكية. (I1a340)
• تحسين عملية تهيئة عناصر مصاحبة لcompose:ui فئات قيم نصية (TextAlign وTextOverflow وImeAction وما إلى ذلك) من خلال استخدام دوال جلب ديناميكية (I776e0)
• تحسين عملية تهيئة العنصر المرافق لأدوات compose:ui وفئات قيم الاختبار (AnimatedVisibilityState وMouseButton وScrollWheel) من خلال استخدام دوال جلب ديناميكية (I23e1b)
• تحسين عملية تهيئة عناصر الكائنات المصاحبة compose:uiلفئات قيم الوحدات (Dp وDpOffset وTextUnitType وما إلى ذلك) من خلال استخدام دوال جلب ديناميكية (If5eb5)
• تم تحسين عملية تهيئة عناصر الكائنات المصاحبة لفئات قيم الأشكال الهندسية compose:ui (Offset وSize وCornerRadius) من خلال استخدام دوال جلب ديناميكية. (I3b110)
• تحسين عملية تهيئة عناصر الكائنات المصاحبة compose:uiلفئات القيم (Role وFocusDirection وPointerEventType وما إلى ذلك) من خلال استخدام دوال جلب ديناميكية (Ie35dd)
• التعامل بشكل صحيح مع BaselineShift.None وBaselineShift.Unspecified وBaselineShift(0f) لتجنُّب عمليات بطيئة غير ضرورية لتحديد موضع العناصر (I4350c)
• تم إصلاح مشكلة كانت تتسبّب في اختلاف سلوك قيم Dp التي تحتوي على صفر سالب (-0.0) في عمليات المقارنة أو عمليات التحقّق من المساواة عن عمليات المقارنة أو عمليات التحقّق من المساواة في النقطة العائمة. (I7dbcf، b/525506543)
• تنظيف معلومات واجهة برمجة التطبيقات (Ia8066)

المساهمة الخارجية

• أصبحت Alignment.topRatio وTrim.isTrimFirstLineTop() وTrim.isTrimLastLineBottom() واجهات برمجة تطبيقات عامة الآن (I84f62)

الإصدار 1.12

الإصدار 1.12.1

‫9 سبتمبر 2026

تم طرح androidx.compose.ui:ui-*:1.12.1. يتضمّن الإصدار 1.12.1 هذه التعديلات.

الإصدار 1.12.0

‫12 أغسطس 2026

تم طرح androidx.compose.ui:ui-*:1.12.0. يتضمّن الإصدار 1.12.0 هذه التعديلات.

### الخطوط المتغيّرة القابلة للتنزيل والإعداد بدون ضبط (ui-text-google-fonts)

• خطوط متغيّرة وشهادات GMS بدون إعدادات!

    import androidx.compose.ui.text.font.FontFamily                                                                                                                                                                         
    import androidx.compose.ui.text.font.FontVariation                                                                                                                                                                      
    import androidx.compose.ui.text.googlefonts.Font                                                                                                                                                                        
    import androidx.compose.ui.text.googlefonts.GoogleFont                                                                                                                                                                  
                                                                                                                                                                                                                            
    val fontFamily = FontFamily(                                                                                                                                                                                            
        Font(                                                                                                                                                                                                               
            googleFont = GoogleFont("Google Sans Flex"),                                                                                                                                                                    
            // Automatically uses default GMS certificates!                                                                                                                                                                 
            variationSettings = FontVariation.Settings(                                                                                                                                                                     
                FontVariation.weight(900),                                                                                                                                                                                  
                FontVariation.slant(0f)                                                                                                                                                                                     
            )                                                                                                                                                                                                               
        )                                                                                                                                                                                                                   
    )

──────                                                                                                                                                                                                                  

### إتاحة نطاق واسع من الألوان (WCG) (ui-graphics)

الحفاظ على نطاق الألوان الواسع: * يتم الحفاظ على مساحات الألوان غير sRGB (مثل AdobeRgb وDisplayP3) التي تم ضبطها على Paint أو Shader في المستوى 29 من واجهة برمجة التطبيقات والإصدارات الأحدث. * يتم الرجوع إلى sRGB في مستويات واجهة برمجة التطبيقات القديمة.

    import androidx.compose.ui.graphics.Color                                                                                                                                                                               
    import androidx.compose.ui.graphics.Paint                                                                                                                                                                               
    import androidx.compose.ui.graphics.colorspace.ColorSpaces                                                                                                                                                              
                                                                                                                                                                                                                            
    val wcgColor = Color(0.9f, 0.5f, 0.1f, colorSpace = ColorSpaces.AdobeRgb)                                                                                                                                               
    val paint = Paint().apply {                                                                                                                                                                                             
        color = wcgColor // Preserved on API 29+                                                                                                                                                                            
    }

──────                                                                                                                                                                                                                  

### Hardware-Accelerated Mesh Gradients (ui)

• واجهة برمجة التطبيقات Painter API: تم استبدال Modifier.meshGradient بـ MeshGradientPainter، الذي يستخدم Canvas.drawMesh المتوافق مع تسريع الأجهزة.
• الاستخدام: استخدِم MeshGradientPainter داخل Modifier.paint.

import androidx.compose.ui.draw.paint                                                                                                                                                                                   
import androidx.compose.ui.geometry.Offset                                                                                                                                                                              
import androidx.compose.ui.graphics.Color                                                                                                                                                                               
import androidx.compose.ui.graphics.MeshGradientPainter                                                                                                                                                                 

val meshPainter = remember {                                                                                                                                                                                            
    MeshGradientPainter(rows = 1, columns = 1, hasBicubicColor = true) {                                                                                                                                                
        setVertex(0, 0, Offset(0f, 0f), Color.Red)                                                                                                                                                                      
        setVertex(0, 1, Offset(1f, 0f), Color.Blue)                                                                                                                                                                     
        setVertex(1, 0, Offset(0f, 1f), Color.Green)                                                                                                                                                                    
        setVertex(1, 1, Offset(1f, 1f), Color.Yellow)                                                                                                                                                                   
    }                                                                                                                                                                                                                   
}                                                                                                                                                                                                                       
Box(Modifier.fillMaxSize().paint(meshPainter))                                                                                                                                                                          
──────                                                                                                                                                                                                                  

### 4. دمج Credential Manager (واجهة المستخدم)

التعبئة التلقائية: * تضيف هذه السمة خاصية دلالية منخفضة المستوى credentialRequest لحقول النص في المستوى 34 من واجهة برمجة التطبيقات والإصدارات الأحدث.

    import androidx.compose.ui.semantics.credentialRequest                                                                                                                                                                  
    import androidx.compose.ui.semantics.CredentialRequestData                                                                                                                                                              
    import androidx.compose.ui.semantics.semantics                                                                                                                                                                          
                                                                                                                                                                                                                            
    BasicTextField(                                                                                                                                                                                                         
        value = value,                                                                                                                                                                                                      
        onValueChange = onValueChange,                                                                                                                                                                                      
        modifier = Modifier.semantics {                                                                                                                                                                                     
            if (Build.VERSION.SDK_INT >= 34) {                                                                                                                                                                              
                credentialRequest = CredentialRequestData(request, callback)                                                                                                                                                
            }                                                                                                                                                                                                               
        }                                                                                                                                                                                                                   
    ) 

──────                                                                                                                                                                                                                  

### 5. أصوات التفاعل التلقائي (ui)

أصوات النقر والتنقّل: * إتاحة أصوات النقر والتنقّل المتوافقة مع Android باستخدام إعدادات الصوت في النظام الأساسي * إيقاف الميزة: استخدِم برنامج تضمين SoundEffectOnInteraction لإيقاف الأصوات لشجرة فرعية.

    import androidx.compose.ui.platform.SoundEffectOnInteraction                                                                                                                                                            
                                                                                                                                                                                                                            
    // Opt-out of sounds for everything inside                                                                                                                                                                              
    SoundEffectOnInteraction(enabled = false) {                                                                                                                                                                             
        Button(onClick = {}) {                                                                                                                                                                                              
            Text("Silent Button")                                                                                                                                                                                           
        }                                                                                                                                                                                                                   
    }                                                                                                                                                                                                                       

### 6. دمج Espresso للواجهات المختلطة (ui-test)
يمكنك حصر تفاعلات Compose على هيكلية طرق العرض المطابقة لـ Espresso ViewInteraction.

    import androidx.compose.ui.test.junit4.onRootWithViewInteraction                                                                                                                                                        
    import androidx.test.espresso.Espresso.onView                                                                                                                                                                           
                                                                                                                                                                                                                            
    // Match RecyclerView row using Espresso                                                                                                                                                                                
    val specificRow = onView(allOf(withId(R.id.row), hasDescendant(withText("Item #5"))))                                                                                                                                   
                                                                                                                                                                                                                            
    // Scope Compose interactions to that row                                                                                                                                                                               
    composeTestRule.onRootWithViewInteraction(specificRow)                                                                                                                                                                  
        .onNodeWithTag("fav_icon")                                                                                                                                                                                          
        .performClick()

الإصدار ‎1.12.0-rc01

‫29 يوليو 2026

تم طرح androidx.compose.ui:ui-*:1.12.0-rc01. يتضمّن الإصدار 1.12.0-rc01 هذه التعديلات.

الإصدار ‎1.12.0-beta02

‫01 يوليو 2026

تم طرح androidx.compose.ui:ui-*:1.12.0-beta02. يتضمّن الإصدار 1.12.0-beta02 هذه التعديلات.

الإصدار ‎1.12.0-beta01

‫17 يونيو 2026

تم طرح androidx.compose.ui:ui-*:1.12.0-beta01. يتضمّن الإصدار 1.12.0-beta01 هذه التعديلات.

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

• لا ينطبق (نقل علامة الميزة الخاصة بالمطوّرين الداخليين) (Iaf2c4، b/368702588)
• لا ينطبق - تم نقل علامة ميزة. (I24668، b/521811270)
• تمت إضافة علامة الميزة التجريبية ComposeUiFlags.isTrackpadPinchReinterpretationEnabled لإعادة تفسير إيماءات التصغير أو التكبير بإصبعين على لوحة اللمس كأحداث ماوس مع عوامل قياس (Id3477، b/478053727)
• إعادة تسمية دالة الاختبار لتشغيل أحداث المؤشر غير المباشرة (I3ee35، b/509618414)
• تمت إضافة تحسين إلى BasicText وBasicTextField حيث يتم الآن احتساب ارتفاع السطر لنص softwrap=false بشكلٍ أفضل (I2150a)

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

• تحسين عملية نشر حالة التقاط التمرير عبر عمليات الإنشاء الفرعية لمنع إعادة إنشاء واجهة المستخدم بشكل غير ضروري (I05830)
• تم تفعيل علامة الميزة التجريبية ComposeUiFlags.isTrackpadPinchReinterpretationEnabled تلقائيًا. (I35ab8، b/478053727)
• تم إصلاح مشكلة في تحليل موارد الرسومات المتجهة القابلة للرسم، حيث تم تجاهل عناصر <clip-path> الرئيسية إذا كانت تحتوي على عناصر <group> متداخلة. (Id4ea9، b/474530439)
• تمت إضافة إمكانية استخدام قواعد إعادة محاولة اختبار JUnit 4 العادية في AndroidComposeTestRule من خلال إعادة إنشاء بيئة الاختبار الداخلية ونطاق الروتين الفرعي بين محاولات التنفيذ. (Iafaa7، b/235383900)

المساهمة الخارجية

• عرض واجهة AndroidClipboard للاختبار من أجل توفير طريقة لمحاكاة تنفيذ الحافظة (Ie4d72، b/512924975)
• إضافة توافق مع الأنظمة القديمة لإصدارات TextAttribute من commitText() وsetComposingText() في الإصدار 37 من حزمة تطوير البرامج (SDK) أو الإصدارات الأحدث، ستتمكّن خدمات تسهيل الاستخدام من الإعلان عمّا إذا تم اختيار نص بديل مقترَح أم لا. بالنسبة إلى الإصدارات الأقدم من 37 من حزمة تطوير البرامج (SDK)، لن يؤثّر ذلك في الملاحظات الصوتية (أي السلوك الحالي). (I90e3d، b/439879822)

الإصدار ‎1.12.0-alpha03

‫19 مايو 2026

تم طرح androidx.compose.ui:ui-*:1.12.0-alpha03. يتضمّن الإصدار 1.12.0-alpha03 هذه التعديلات.

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

• تمت إضافة السمة الجديدة credentialRequest Semantics والأداة المساعدة CredentialRequestData في الإصدار 34 من واجهة برمجة التطبيقات أو الإصدارات الأحدث للسماح لِحقول Jetpack Compose النصية بالاندماج مع "مدير بيانات الاعتماد" في Android من خلال إطار عمل "الملء التلقائي". (Ida2bf، b/488446455)
• تمت إضافة دالة مصنع ParagraphIntrinsics تأخذ الوسيط softWrap من بين وسيطات أخرى. يمكننا استخدامها داخليًا كإشارة إلى أنّ النص معروض على سطر واحد وإجراء بعض التحسينات. (I66ca4، b/485495112)
• تمت إضافة إمكانية استخدام أصوات التفاعل التلقائي (النقرات والتنقّل باستخدام التركيز) إلى مكوّنات Compose، مع إضافة SoundEffectOnInteraction Composable جديد للسماح بإيقاف هذه الميزة. يُرجى العِلم أنّه نتيجةً لهذا التغيير، يجب الآن استدعاء أدوات معالجة النقرات الدلالية من سلسلة التعليمات الرئيسية، ما قد يؤثّر في عدد صغير من حالات الاختبار. (I78f65)
• دالة المصنع Font الثابتة التي تستغرق variationSettings. (I183f2)
• السمة ResourceFont loadingStrategy المستقرة والطريقة copy (I40d84)
• واجهتا برمجة التطبيقات InterceptPlatformTextInput وPlatformTextInputInterceptor الثابتتان (Id2784)
• لتحسين فصل المنصات، تم نقل registerIdlingResource وunregisterIdlingResource إلى وظائف الإضافة، وقد تحتاج إلى تعديل عمليات الاستيراد. (I21d3d، b/471148519)
• تمت إضافة runWithoutImplicitWait إلى ComposeTestRule وComposeUiTest لتحسين أداء الاختبار أثناء فحص الحالة. تتيح واجهة برمجة التطبيقات هذه تنفيذ مجموعة من الرموز البرمجية مع إيقاف المزامنة الضمنية، ما يؤدي إلى تجنُّب الحمل الزائد للمزامنات المتكررة لكل طلب بحث عن عقدة. ويؤدي ذلك إلى تنفيذ الاختبارات بشكل أسرع بكثير، خاصةً الاختبارات التي تتضمّن التنقّل يدويًا بين اللقطات وأخذ عيّنات من خصائص متعددة، مثل اختبارات الصور المتحركة. (Ie00e9، b/490270394)
• يمكن الآن تطبيق التعليق التوضيحي @PreviewWrapper على فئات التعليقات التوضيحية MultiPreview، ما يتيح للمطوّرين إنشاء إعدادات معاينة قابلة لإعادة الاستخدام ومغلّفة مسبقًا. (I8ae66، b/511170361)
• تمت إضافة MeshGradientPainter لعرض تدرّجات شبكية.تمت إزالة Modifier.meshGradient، لذا استخدِم MeshGradientPainter مع Modifier.paint بدلاً من ذلك. MeshGradientRenderer داخلي الآن. (I2d170، b/508110246)
• يمكن الآن توفير المسطرة بشكل فردي من خلال تقديم دالة lambda تحدّد ما إذا كان يمكن توفير المسطرة، بالإضافة إلى دالة lambda منفصلة توفّر قيمة المسطرة. لا يتم رصد تعبير lambda isRulerProvided، ويجب أن يكون متفائلاً بشأن إمكانية تقديم قيمة. تتم مراقبة دالة lambda rulerProvider، وبالتالي إذا تغيّرت أي قيمة، سيتم تعديل قيمة المسطرة وجميع القراء الذين يستخدمونها. (Ie9089)
• في واجهة برمجة التطبيقات التجريبية Style API، تمّت إضافة إمكانية إنشاء أنواع أنماط مخصّصة يمكن أن تتضمّن نطاقات أنماط مخصّصة. يتيح ذلك تقسيم السمات التي يمكن ضبطها بواسطة نمط (مثل إزالة طبقة الرسومات أو خصائص النص بالكامل)، بالإضافة إلى السماح بتوسيع النطاق بشكل مستقل عن الأنماط الأخرى (مثل عدم إتاحة بنية playing { } إلا في عنصر MediaPlayer قابل للإنشاء). يؤدي هذا التغيير إلى إيقاف التوافق الثنائي وتوافق المصدر. التغيير الأساسي الذي يؤدي إلى عدم توافق الرمز المصدري هو نقل الدوال المساعدة في StyleScope لتصبح دوال إضافية (على سبيل المثال، أصبحت fun contentProperty(all: Dp) الآن دالة إضافية). يجب أن يكون استيراد دوال الإضافة المطلوبة أو استيراد جميع الرموز من androidx.compose.foundation.styles هو كل ما هو مطلوب لتجميع الرمز الذي يستدعي هذه الطرق بشكل صحيح. (I1ef27، b/493676648)
• تضيف هذه السمة updatePointerBy() مع وسيط تلقائي لمعرّف المؤشر. (I99f30، b/502001776)
• لم يعُد DeferredTargetAnimation تجريبيًا، يُرجى إزالة خيار الاشتراك" إلى androidx-main
• تمت إضافة العلامة isClearNestedScrollCoroutineScopeFixEnabled للتحكّم في الإصلاح. (Ibd394، b/505343254)
• لم تعُد ميزة "DeferredTargetAnimation" تجريبية، يُرجى إزالة الموافقة. (I1e4ae، b/500030165)
• تعداد جديد لإتاحة المشغّلات في أدوات واجهة المستخدم (I6e198، b/478807872)
• يُسمح بإنشاء ComposeViewContext بدون إرفاق "العرض المرجعي". سيظلّ يتطلّب إرفاق View المرجعي قبل استدعاء setContent(). (Id0952)

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

• تم إصلاح المشكلة التي تمنع focusRestorer من استعادة التركيز بشكل صحيح عند إجراء عدة عمليات حفظ للتنسيق نفسه (I10277، b/505371994)
• كان لتحسين سابق في الأداء تأثير جانبي يتمثّل في عدم السماح بقياس ComposeViews غير المرفقة. يتيح هذا التغيير الآن إجراء ذلك بدون إعادة طرح مشكلة الأداء. (I9b2c5، b/508650647)
• تتم إعادة إنشاء التركيبة الآن عند إجراء تغيير على ComposeViewContext لتوفير وصول أسرع إلى ComposeViewContext. (I3b3a8، b/487364963)
• السماح لـ Compose بضبط ألوان غير sRGB على الطلاء وأداة التظليل على Android، مع الحفاظ على نطاق الألوان الواسع من خلال ربط مساحات الألوان Compose بشكل صحيح بمساحات الألوان المكافئة على النظام الأساسي سيتم تلقائيًا استخدام مساحة الألوان Srgb في مساحات الألوان غير المتوافقة مع عمليات العرض على النظام الأساسي (مثل CIE XYZ وCIE Lab وOklab) أو غير المتوفّرة في مستوى واجهة برمجة التطبيقات الحالي. (I3efb5، b/388511109)

المساهمة الخارجية

• تم إيقاف نوع الاسم المستعار androidx.compose.ui.platform.NativeClipboard نهائيًا، لذا استخدِم android.content.ClipboardManager مباشرةً بدلاً منه (Ibc611)
• استبدِل السمة Clipboard.nativeClipboard بالامتداد Clipboard.nativeClipboardManager لتجنُّب عرض نوع المنصة في مجموعة المصادر commonMain من خلال typealias (Ibc611).

الإصدار ‎1.12.0-alpha02

‫6 مايو 2026

تم طرح androidx.compose.ui:ui-*:1.12.0-alpha02. يتضمّن الإصدار 1.12.0-alpha02 هذه التعديلات.

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

• تُقدّم هذه السمة المعدِّل MeshGradient. (Ia9a08، b/455752719)
• يزيل عمليات معاودة الاتصال المضمّنة لتصحيح أخطاء الملء التلقائي. يمكن تحقيق الوظيفة نفسها من خلال تسجيل الدخول من AutofillManager.AutofillCallback. (I631c7، b/502279690)
• إتاحة إعدادات خيارات الخطوط القابلة للتنزيل (Ic25c7، b/496278020)
• تم تعديل mediaQuery وderivedMediaQuery لعرض نوع عام بدلاً من Boolean، ما يتيح استخدامًا أكثر مرونة عند إنشاء واجهات مستخدم قابلة للتكيّف. (I93830، b/498698350)

الإصدار ‎1.12.0-alpha01

‫22 أبريل 2026

تم طرح androidx.compose.ui:ui-*:1.12.0-alpha01. يتضمّن الإصدار 1.12.0-alpha01 هذه التعديلات.

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

• إزالة علامة الميزة ComposeUiFlags.isIndirectPointerNavigationGestureDetectorEnabled (I82be3، b/455601135)
• تم تحويل mediaQuery إلى دالة مضمّنة (Ie9457، b/498698350)
• تم نقل ComposeViewContext من مرحلة الإصدار التجريبي، وتمت إزالة التعليق التوضيحي ExperimentalComposeViewContextApi (I32eca)
• لم تعُد ميزة "ComposeView.disableWindowInsetsRulers()" تجريبية (Ia81a5)
• تمت إضافة واجهة برمجة التطبيقات hasPendingWork() للسماح بالتحقّق بشكل غير مباشر مما إذا كانت واجهة مستخدم Compose لديها حاليًا عمل معلّق بدون بدء عملية انتظار أو تقديم الوقت. ويكون ذلك مفيدًا لاختبارات الساعة اليدوية لتحديد وقت انتهاء الحركات أو العمل الآخر في الخلفية. (Ic54e3)
• تمت إزالة علامة الميزة AndroidComposeUiFlags.isForceChildLayoutAfterMeasurementEnabled (I7fd25، b/491111451)
• تمت إزالة علامة الميزة AndroidComposeUiFlags.isSharedFontEnabled (I2cebe، b/479898293)
• تضيف هذه السمة خيارات KeyboardType إضافية لإكمال مجموعة خيارات لوحة المفاتيح المتوافقة على Android، بما في ذلك التاريخ والوقت والتاريخ والوقت معًا والعلامة العشرية الموقّعة وغير ذلك. (I3713e، b/202353328)
• تمت إزالة العلامة AndroidComposeUiFlags.isSharedHapticsEnabled (I6a1d4، b/479895628)
• تمت إزالة العلامة AndroidComposeUiFlags.isSharedClipboardManagerEnabled (I41e3c، b/479895130)
• تمت إزالة العلامة AndroidComposeUiFlags.isSharedViewConfigurationEnabled (I6d3aa، b/479890645)
• تمت إزالة علامة الميزة AndroidComposeUiFlags.isSharedDrawingEnabled. (I27912، b/479849019)
• تمت إزالة علامة الميزة AndroidComposeUiFlags.isSharedAccessibilityManagerEnabled (I6b726، b/479845566)
• إزالة علامة AndroidComposeUiFlags.isSharedWindowInfoEnabled (Ife9a9، b/479837249)
• أزِل العلم AndroidComposeUiFlags.isSharedComposeViewContextEnabled. (Ic522a، b/479834257)
• إضافة إعدادات خيارات المنتج لتخصيص الخطوط المتغيّرة القابلة للتنزيل (Ifdc93، b/223262013)
• إضافة إعدادات خيارات لتخصيص الخطوط المتغيّرة القابلة للتنزيل (I390af، b/223262013)
• إزالة البلاغ isTraversableDelegatesFixEnabled (Ia7dfe، b/485962494)
• تم تقديم runWhenIdle وawaitAndRunWhenIdle (النوع المعلق) في ComposeTestRule وComposeUiTest لتحسين أداء الاختبار وثبات الحالة. تعمل واجهات برمجة التطبيقات هذه على مزامنة واجهة المستخدم مرة واحدة، ثم تنفيذ مجموعة من الرموز بدون الحاجة إلى عمليات مزامنة متكررة لكل عملية. ويؤدي ذلك إلى تنفيذ الاختبار بشكل أسرع وأكثر استقرارًا، خاصةً للاختبارات التي تتضمّن العديد من السمات، مثل اختبارات الرسوم المتحركة. (Iabf66، b/490270394)
• تضيف LayerOutsets إلى GraphicsLayer وModifier.graphicsLayer، ويمكن استخدامها لزيادة الحدود المرئية للطبقة إلى ما يتجاوز حجمها المقاس. يمكن استخدام ذلك لتجنُّب السلوك الضمني clipToBounds عند ترقية الطبقة إلى مخزن مؤقت خارج الشاشة. (Ic1189)
• تم إيقاف تسجيل أحداث إدخال الملء التلقائي تلقائيًا. ويمكنك الآن تفعيلها من خلال الاتصال بالرقم ComposeView.setAutofillDebugEnabled. (I5b430، b/487947860)
• تم تغيير VelocityTracker لاستخدام التنفيذ الذي يوفّره إطار عمل Android (يمكن ضبطه باستخدام AndroidComposeUiFlags.isFrameworkVelocityTrackerEnabled). (Ibc7e2، b/359962905)
• عندما تكون قيمة AndroidComposeUiFlags.isForceChildLayoutAfterMeasurementEnabled صحيحة، سيتم دائمًا استدعاء التنسيق بعد القياس أثناء عملية التنسيق. لا ترتّب Compose العناصر التابعة دائمًا بعد القياس، ولكن تتطلّب "طرق العرض" ذلك لإدارة الحالة بشكل سليم. (Ib4fe9، b/430974758)
• إضافة isVirtual إلى LayoutInfo (I3e5cd، b/494243978)
• تمت إزالة العلامة isGraphicsLayerShapeSemanticsEnabled. (I44be0، b/455600081)
• تمت إضافة واجهة برمجة تطبيقات جديدة للخطوط لاستخدام الخطوط القابلة للتنزيل بدون الحاجة إلى إضافة شهادات الخطوط إلى قاعدة الرموز البرمجية يدويًا. (I30b86، b/479454159)
• تمت إضافة onRootWithViewInteraction لتحديد نطاق عمليات البحث الدلالية في Compose لتشمل "طرق عرض" معيّنة في Android . يسهّل ذلك اختبار واجهات المستخدم المختلطة، مثل RecyclerViews، بدون الحاجة إلى علامات اختبار فريدة في رمز الإنتاج . (Ic02c4، b/175226753)

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

• تتيح لك واجهة برمجة التطبيقات captureToImage() الآن التقاط نافذة منبثقة أو مربّع حوار مع عنصر الربط الخاص بهما في صورة نقطية واحدة. (I9b83a، b/443137545)
• تم تعديل Compose compileSdk إلى الإصدار 37 من واجهة برمجة التطبيقات. وهذا يعني أنّه يجب استخدام الإصدار 9.2.0 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" على الأقل عند استخدام Compose. (Id45cd، b/413674743)
• يؤدي ضبط ContentDataType.None في الدلالات الآن إلى منع Compose من إرسال أحداث الملء التلقائي. من المفترض أن يمنع ذلك تكاليف الإعداد المرتبطة بطلب خدمات الملء التلقائي. (I8fbda، b/487947860)

الإصدار 1.11

الإصدار 1.11.4

‫01 يوليو 2026

تم طرح androidx.compose.ui:ui-*:1.11.4. يتضمّن الإصدار 1.11.4 هذه التعديلات.

الإصدار 1.11.3

‫17 يونيو 2026

تم طرح androidx.compose.ui:ui-*:1.11.3. يتضمّن الإصدار 1.11.3 هذه التعديلات.

الإصدار 1.11.2

‫19 مايو 2026

تم طرح androidx.compose.ui:ui-*:1.11.2. يتضمّن الإصدار 1.11.2 هذه التعديلات.

الإصدار 1.11.1

‫6 مايو 2026

تم طرح androidx.compose.ui:ui-*:1.11.1. يتضمّن الإصدار 1.11.1 هذه التعديلات.

الإصدار 1.11.0

‫22 أبريل 2026

تم طرح androidx.compose.ui:ui-*:1.11.0. يتضمّن الإصدار 1.11.0 هذه التعديلات.

الإصدار ‎1.11.0-rc01

‫8 أبريل 2026

تم طرح androidx.compose.ui:ui-*:1.11.0-rc01. يتضمّن الإصدار 1.11.0-rc01 هذه التعديلات.

الإصدار ‎1.11.0-beta02

‫25 مارس 2026

تم طرح androidx.compose.ui:ui-*:1.11.0-beta02. يتضمّن الإصدار 1.11.0-beta02 هذه التعديلات.

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

• إعادة تسمية واجهة برمجة التطبيقات Rename PreviewWrapper لتحقيق الاتساق (I62659، b/490085948)
• تسمح السمة ComposeViewContext بإنشاء ComposeView بدون ربطها بهيكلية طرق العرض. استخدِم AbstractComposeView.createComposition(composeViewContext) لبدء إنشاء رسالة بدون إرفاق ComposeView. (I46e6f)
• تمت إضافة delayMillis إلى واجهات برمجة التطبيقات لاختبار لوحة اللمس في panEnd وscaleEnd (If80fe)

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

• تطلب Clipboard وClipboardManager الآن خدمة تابعة لنظام التشغيل عند طلب الإجراء الأول (If0016، b/487947860)
• سيتم استعادة التركيز بشكل صحيح داخل الحاويات الكسولة التي تتم فيها إعادة استخدام عقد التركيز والمجموعات (I18d36، b/481564275)
• تستخدم النافذة المنبثقة التي تتضمّن clippingEnabled = false الآن حدود النافذة الكاملة بشكل صحيح لعرض المحتوى من الحافة إلى الحافة (I206408، b/327017902).

الإصدار ‎1.11.0-beta01

‫11 مارس 2026

تم طرح androidx.compose.ui:ui-*:1.11.0-beta01. يتضمّن الإصدار 1.11.0-beta01 هذه التعديلات.

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

• تمت إضافة دعم windowToken المخصّص إلى مربّع الحوار في Jetpack Compose (Ic7728)
• تمت إضافة إمكانية استخدام windowToken وwindowType مخصّصَين إلى النوافذ المنبثقة في Jetpack Compose. (I0a04f)
• تقديم واجهة PreviewWrapper وموفّر تعليقات توضيحية سيتيح ذلك للمطوّرين تضمين معايناتهم بسلاسة مع سلوك مخصّص. (I29f54، b/484306729)
• عندما تكون قيمة AndroidComposeUiFlags.isSharedFontEnabled صحيحة، يمكن مشاركة مثيلات العناصر ذات الصلة بالخطوط، مثل FontLoader وFontFamilyResolver، بين مثيلات ComposeView داخل ComposeViewContext. (I403e8)
• ستستخدم معالجات دلالات الإنشاء view.handler بدلاً من mainLooper، ما يؤدي إلى تجنُّب الأعطال في طرق العرض التي تستخدم معالجات غير رئيسية. (I671c3، b/486235925)
• تمت إضافة علامة isSkipNonImportantSemanticsNodesHitTestEnabled تحمي إصلاح خطأ في اختبار النتائج الدلالية، ما يؤثر في ميزة "النقر للاستكشاف" في TalkBack. (I2933f وb/481011169 وb/454377558 وb/461360154)
• تمت إضافة إمكانية عرض مربّعات حوار Jetpack Compose من "خدمات Android". من خلال توفير نوع نافذة مخصّص من خلال المَعلمة الجديدة windowType في DialogProperties، يمكن للمطوّرين الآن عرض مربّعات الحوار في نوافذ متراكبة. (I7c504، b/478214962)
• إعادة تسمية السمتَين PointerInputChange وHistoricalChange لاسترداد قيم التكبير/التصغير والتحريك (I989a8، b/481333653)
• تضيف هذه السمة المزيد من الوظائف إلى واجهات برمجة التطبيقات الخاصة باختبار لوحة اللمس، وذلك لمحاكاة المنحنيات والمدخلات المختلفة لإيماءة لوحة اللمس. (I290fb، b/473603145، b/479213358)
• تقسيم PointerEventType.Pan الجديد إلى PointerEventType.PanStart وPointerEventType.PanMove وPointerEventType.PanEnd وبالمثل، تم تقسيم PointerEventType.Scale إلى PointerEventType.ScaleStart وPointerEventType.ScaleChange وPointerEventType.ScaleEnd. يتيح هذا التقسيم تمرير معلومات إضافية حول بداية ونهاية إيماءات التحريك والتكبير/التصغير التي تفسّرها المنصة، ما يسمح بعد ذلك لمعالجات إدخال المؤشر في Compose باستخدام هذه المعلومات لرصد الأحداث بشكل مناسب، ومعرفة متى يتم التحريك أو التكبير/التصغير على وجه الخصوص. (I4daf6، b/479285849، b/481333653)
• عندما تكون قيمة AndroidComposeUiFlags.isSharedHapticsEnabled صحيحة، يحتوي ComposeViewContext على مثيل وحدة التحكّم في ردود الفعل اللمسية المشتركة. (Icd79a)
• تم طرح واجهات برمجة التطبيقات التجريبية mediaQuery وderivedMediaQuery وUiMediaScope (المصنّفة على أنّها @ExperimentalMediaQueryApi) لتفعيل تطوير واجهات مستخدم تكيّفية تعريفية استنادًا إلى أبعاد النافذة ووضع النافذة وإمكانات أخرى للجهاز والبيئة. (I2d21e، b/479800750)

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

• تم إصلاح مشكلة عدم إعادة رسم Modifier.dropShadow وModifier.innerShadow على مستوى نطاق الحظر عند تغيير مَعلمة الشكل ديناميكيًا. (Ida262، b/486202623)
• تم إصلاح الخطأ الذي يتسبب في وضع المحتوى المضمّن في غير مكانه في التصاميم من اليمين إلى اليسار التي تتضمّن نصًا من اليسار إلى اليمين أو التصاميم من اليسار إلى اليمين التي تتضمّن نصًا من اليمين إلى اليسار. (I09789)
• تم إصلاح الخطأ الذي كان يتسبّب في ظهور استثناء عند استخدام ComposeView في عملية انتقال جزء من الشاشة. (Ia425f، b/484100557)

المساهمة الخارجية

• أضِف السمة InputTextSuggestionState للمساعدة في تحديد الحالات المختلفة التي يمكن أن يكون فيها إدخال الكتابة الصوتية عند توفّر اقتراحات استبدال النص. تضيف هذه السمة أيضًا TextCompositionRange لتتبُّع نطاق تركيبة النص الحالي للترجمة الصوتية، وتشير القيمة الفارغة إلى عدم توفّر أي تركيبة. (I7a67f، b/476472318)

الإصدار ‎1.11.0-alpha06

‫25 فبراير 2026

تم طرح androidx.compose.ui:ui-*:1.11.0-alpha06. يتضمّن الإصدار ‎1.11.0-alpha06 هذه التعديلات.

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

• تم استبدال العلامة ComposeUiFlags.areWindowInsetsRulersEnabled بواجهة برمجة التطبيقات ComposeView.disableWindowInsetsRulers(). (Idcdb4، b/455590696)
• نقلنا علامة الميزة التجريبية isAccessibilityShowOnScreenNestedScrollingEnabled المخصّصة لنظام Android فقط إلى (I1c13a)
• إضافة دعم للمشي صعودًا (I1c13a)
• الإبلاغ عن عُقد الدلالات خارج الشاشة التي تكون عناصر فرعية لعُقد الدمج المرئية جزئيًا في الحاويات القابلة للتمرير من أجل تحسين تجربة المستخدمين مع برامج قراءة الشاشة وخدمات تسهيل الاستخدام المشابهة (I71df9، b/434782764)
• عندما تكون قيمة AndroidComposeUiFlags.isSharedClipboardManagerEnabled صحيحة، يمكن مشاركة مثيلات ذات صلة بلوحة الحافظة على مستوى ComposeViews باستخدام ComposeViewContext (I65e2c).
• تمت إزالة ComposeUiFlags.isRectManagerOffsetUsageFromLayoutCoordinatesEnabled (I6e14a، b/455601894)

الإصدار ‎1.11.0-alpha05

‫11 فبراير 2026

تم طرح androidx.compose.ui:ui-*:1.11.0-alpha05. يتضمّن الإصدار ‎1.11.0-alpha05 هذه التعديلات.

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

• تنقل AndroidComposeUiFlags.isSharedWindowInfoEnabled معلومات WindowInfo إلى ComposeViewContext. يؤدي إيقاف العلامة إلى ترك WindowInfo تحت سيطرة AndroidComposeView (I3b364)
• سيتم نقل البُنى الشائعة في ComposeView إلى ComposeViewContext المشتركة. هذا هو التغيير الأول الذي ينقل CoroutineContext إلى ComposeViewContext. عندما تكون قيمة AndroidComposeUiFlags.isSharedComposeViewContextEnabled صحيحة، تتم مشاركة القيم تلقائيًا. عندما تكون القيمة خطأ، لا تتم مشاركتها. (I9364d، b/461566955)
• تضيف هذه السمة إمكانية استخدام إيماءات لوحة اللمس والتحويل من أحداث إدخال لوحة اللمس إلى الماوس. من خلال هذا التغيير، سيتم بشكل عام تسجيل أحداث مؤشر لوحة اللمس التي تتحكّم في المؤشر كما هو الحال على الأجهزة اللوحية أو أجهزة الكمبيوتر المحمولة كمؤشرات للماوس، ما يحسّن السلوك المتعلق بانحراف المؤشر والتمرير والتمرير فوق العناصر. سيتم أيضًا تسجيل إيماءات التحريك والتكبير/التصغير مع توفير معلومات إضافية في تغييرات حدث المؤشر، مع ظهور PointerEventType.Pan وPointerEventType.Scale جديدَين يشيران إلى أنّه سيتم ضبط هذه القيم (Id071a وb/315527861 وb/459831570).

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

• أرسِل CONTENT_CHANGE_TYPE_CHECKED لتغيير السمة القابلة للتبديل. (I6ac64، b/476894689، b/474538004، b/475754416)

المساهمة الخارجية

• تم إيقاف نوع الاسم المستعار androidx.compose.ui.graphics.NativePaint نهائيًا، استخدِم android.graphics.Paint مباشرةً بدلاً من ذلك (I6303c، b/477394763)
• استبدال الإضافة Paint.asFrameworkPaint() بالإضافة Paint.nativePaint لتجنُّب عرض نوع النظام الأساسي في مجموعة المصادر commonMain من خلال typealias (I6303c، b/477394763)
• إضافة دعم لمفاتيح حركة NumPad (I1ff12)

الإصدار ‎1.11.0-alpha04

‫28 يناير 2026

تم طرح androidx.compose.ui:ui-*:1.11.0-alpha04. يتضمّن الإصدار 1.11.0-alpha04 هذه التعديلات.

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

• تم عرض TestCoroutineScheduler لتفعيل استخدام runCurrent() وضمان الوصول إلى مثيل أداة الجدولة المشتركة. (Iea662، b/254115946)
• إضافة إمكانية التنقّل للأعلى في التمرير المتداخل استجابةً لطلب android.R.id.accessibilityActionShowOnScreen من "تسهيل الاستخدام" (Ib2723، b/431148846)

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

• تم إصلاح عملية تحويل مساحة ألوان RGB المخصّصة على Android. تم تحويل عمليات تحويل التدرّج الرمادي المخصّص بشكل غير صحيح بين مساحات ألوان RGB المخصّصة في Compose وAndroid.(ebd45،b/377021410)

الإصدار ‎1.11.0-alpha03

‫14 يناير 2026

تم طرح androidx.compose.ui:ui-*:1.11.0-alpha03. يتضمّن الإصدار ‎1.11.0-alpha03 هذه التعديلات.

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

• تمت إزالة العلامة ComposeUiTestFlags.isStandardTestDispatcherSupportEnabled. تستخدم واجهتا برمجة التطبيقات run*ComposeUiTest وcreate*ComposeRule في الإصدار 2 الآن StandardTestDispatcher تلقائيًا. لمواصلة استخدام UnconfinedTestDispatcher، يمكنك استخدام صيغ واجهة برمجة التطبيقات المتوقّفة نهائيًا، ولكن ننصحك بشدة بنقل البيانات إلى الإصدار 2 من واجهات برمجة التطبيقات للتحكّم بشكل أفضل في تنفيذ الروتينات الفرعية. (Iecc9c، b/455601592)
• تم طرح واجهات برمجة التطبيقات androidx.compose.ui.test.junit4.v2.create*ComposeRule. تستخدم واجهات برمجة التطبيقات الجديدة هذه StandardTestDispatcher تلقائيًا لمحاكاة سلوك الإنتاج بشكل أفضل حيث يتم وضع الروتينات الفرعية في قائمة الانتظار بدلاً من تنفيذها على الفور. لمزيد من المعلومات، راجِع إرشادات نقل البيانات. (I1870e، b/254115946)
• تم طرح واجهات برمجة التطبيقات androidx.compose.ui.test.v2.run*ComposeUiTest. تستخدم واجهات برمجة التطبيقات الجديدة هذه StandardTestDispatcher تلقائيًا لمحاكاة سلوك الإنتاج بشكل أفضل حيث يتم وضع الروتينات الفرعية في قائمة الانتظار بدلاً من تنفيذها على الفور. لمزيد من المعلومات، راجِع إرشادات نقل البيانات. (I4f782، b/254115946)
• يمكن الآن مشاركة البُنى الشائعة ضمن ComposeView. عندما تكون قيمة ComposeUiFlags.isSharedComposeViewContextEnabled صحيحة، تتم مشاركة القيم تلقائيًا. عندما تكون القيمة خطأ، لا تتم مشاركتها. (I0d1b4، b/463540495، b/460468959، b/461503366، b/463641813)

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

• تم إصلاح الخطأ الذي كان يؤدي إلى عدم إزالة المحتوى المرسوم عند إزالة كل المحتوى من ComposeView. (I8b382، b/299503084)
• تم إصلاح عُطل في التركيب القابل للإيقاف المؤقت عند تحريكه باستخدام LookaheadScope. (I7e649، b/469669851)
• تم حلّ مشكلة كانت تؤدي إلى تعطُّل خدمة الملء التلقائي عند إرسال سلاسل طويلة جدًا إليها. لمنع حدوث ذلك، يتم الآن اقتطاع النص تلقائيًا إلى طول صالح قبل إرساله.
• تم إصلاح الخطأ الذي يمكن أن يتسبّب فيه الخروج من التمرير فوق عنصر في حدوث نقرة في ظروف معيّنة جدًا (a3d5a0f)
• إصلاح عملية إرسال حدث التمرير فوق الشاشة باستخدام قلم الشاشة للاختبارات وإعداد اختبارات الماوس لاختبارات قلم الشاشة الجديدة (9ca9bc9)
• تتيح هذه السمة إمكانية إزالة عناصر واجهة المستخدم أو وضعها باستخدام إدخال المؤشر. (d0742b0، b/BUD_ID)
• تم إصلاح خطأ في Jetpack Compose Popup كان يؤدي إلى تمرير الإحداثيات المطلقة لحدود العنصر الأساسي إلى PopupPositionProvider، ما يؤدي إلى مواضع غير صحيحة للعناصر المنبثقة. تستخدم الآن عمليات احتساب موضع النوافذ المنبثقة الإحداثيات النسبية الصحيحة.(1f7edf،b/469940907)

الإصدار ‎1.11.0-alpha02

‫17 ديسمبر 2025

تم طرح androidx.compose.ui:ui-*:1.11.0-alpha02. يتضمّن الإصدار 1.11.0-alpha02 هذه التعديلات.

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

• أصبحت واجهات برمجة التطبيقات MultiModalInjectionScope ثابتة الآن. ويشمل ذلك performKeyInput وperformRotaryScrollInput وواجهات برمجة التطبيقات الأساسية الخاصة بهما. تمت إزالة التعليق التوضيحي التجريبي. (Ie8bbc، b/261561237)
• تضيف هذه الحزمة واجهات برمجة تطبيقات لاختبار لوحة اللمس. وهي تشبه واجهات برمجة التطبيقات لاختبار الماوس، وتُدخل أحداثًا تحاكي سلوك لوحة التتبُّع على جهاز لوحي أو كمبيوتر محمول. نقاط الدخول الأساسية هي SemanticsNodeInteraction.performTrackpadInput وMultiModalInjectionScope.trackpad (I2ce67)، b/432326139.

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

• إصلاح إمكانية التشغيل التفاعلي لإدخال التمرير بعجلة الماوس بحيث لا يتم استخدامه إلا إذا تم استخدامه في Compose، وليس إذا تم إرساله في Compose. (I5e0c4)،

الإصدار ‎1.11.0-alpha01

‫3 ديسمبر 2025

تم طرح androidx.compose.ui:ui-*:1.11.0-alpha01. يتضمّن الإصدار 1.11.0-alpha01 هذه التعديلات.

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

• تزيل هذه السياسة العلامة isSemanticAutofillEnabled لواجهة المستخدم لأنّ ميزة "الملء التلقائي الدلالي" مفعّلة تلقائيًا. (I849cf، b/455587954)
• تم تغيير طريقة عثور الطريقة find findNearestAncestor القابلة للتنقّل على العُقد ذات الصلة. ستظهر الآن عناصر التحكّم من النوع نفسه (NodeKind) أثناء التنقّل. يتم حماية التغيير بالعلامة isTraversableDelegatesFixEnabled. (Ia3165، b/280804097)
• إضافة عملية ربط TextEntryKey لـ ANI#isTextEntryKey (Ifde7b، b/399540654)
• تم إيقاف Modifier.onFirstVisible() نهائيًا لأنّ سلوكه مضلّل ولا يتوافق دائمًا مع العقد الذي يدّعي الاسم أنّه يتبعه. على سبيل المثال، عند إضافتها إلى عنصر من LazyColumn، سيتم استدعاء دالة ردّ الاتصال هذه في كل مرة يصبح فيها هذا العنصر مرئيًا بعد التمرير. وهذا ليس ما قد يتوقّعه مستخدمو المعدِّل بهذا الاسم. ننصحك باستخدام Modifier.onVisibilityChanged() بدلاً من ذلك وتتبُّع ما إذا كان التنسيق مرئيًا من قبل يدويًا استنادًا إلى متطلبات حالة الاستخدام المحدّدة. (Ia7095، b/447601783)
• تم تقديم MeasuredSizeAwareModifierNode، وهو مطلوب عند الحاجة إلى معاودة الاتصال onRemeasured(). يُرجى استخدام هذه الواجهة مباشرةً بدلاً من استخدام LayoutAwareModifierNode أكثر عمومية عندما لا تحتاج إلى عمليات ردّ الاتصال الأخرى. (If6fb0)

الإصدار 1.10

الإصدار 1.10.6

‫25 مارس 2026

تم طرح androidx.compose.ui:ui-*:1.10.6. يتضمّن الإصدار 1.10.6 هذه التعديلات.

الإصدار 1.10.5

‫11 مارس 2026

تم طرح androidx.compose.ui:ui-*:1.10.5. يتضمّن الإصدار 1.10.5 هذه التعديلات.

الإصدار 1.10.4

‫25 فبراير 2026

تم طرح androidx.compose.ui:ui-*:1.10.4. يتضمّن الإصدار 1.10.4 هذه التعديلات.

الإصدار 1.10.3

‫11 فبراير 2026

تم طرح androidx.compose.ui:ui-*:1.10.3. يتضمّن الإصدار 1.10.3 هذه التعديلات.

الإصدار 1.10.2

‫28 يناير 2026

تم طرح androidx.compose.ui:ui-*:1.10.2. يتضمّن الإصدار 1.10.2 هذه التعديلات.

الإصدار 1.10.1

‫14 يناير 2026

تم طرح androidx.compose.ui:ui-*:1.10.1. يتضمّن الإصدار 1.10.1 هذه التعديلات.

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

• تم إصلاح عُطل في التركيب القابل للإيقاف المؤقت عند تحريكه باستخدام LookaheadScope (I7e649، b/469669851)
• تم إصلاح خطأ في Jetpack Compose Popup كان يؤدي إلى تمرير الإحداثيات المطلقة لحدود العنصر الأساسي إلى PopupPositionProvider، ما يؤدي إلى مواضع غير صحيحة للعناصر المنبثقة. تستخدم الآن عمليات احتساب موضع النوافذ المنبثقة الإحداثيات النسبية الصحيحة.(1f7edf،b/469940907)

الإصدار 1.10.0

‫3 ديسمبر 2025

تم طرح androidx.compose.ui:ui-*:1.10.0. يتضمّن الإصدار 1.10.0 هذه التعديلات.

الإصدار ‎1.10.0-rc01

‫19 نوفمبر 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-rc01. يتضمّن الإصدار 1.10.0-rc01 هذه التعديلات.

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

• إرسال عمليات ردّ الاتصال visibilityChanged بشكل صحيح مع القيمة false عندما لا تكون قيمة minDurationMs صفرًا (2ac08b8، b/456384555)
• لا تستدعِ الدالة onVisibilityChanged عند عدم ظهور العقدة في البداية. (3969e8d، b/447364998)

الإصدار ‎1.10.0-beta02

‫5 نوفمبر 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-beta02. يتضمّن الإصدار ‎1.10.0-beta02 هذه التعديلات.

الإصدار ‎1.10.0-beta01

‫22 أكتوبر 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-beta01. يتضمّن الإصدار 1.10.0-beta01 هذه التعديلات.

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

• تضيف هذه السمة تحسينًا لإرسال تغيير التركيز. يمكن إيقاف هذه الميزة باستخدام isOptimizedFocusEventDispatchEnabled = false (I919fb، b/449228515)
• تعديل جميع واجهات برمجة التطبيقات التي تتضمّن اللمس غير المباشر لاستخدام اسم واجهات برمجة التطبيقات التي تتضمّن المؤشر غير المباشر لتتطابق مع واجهات برمجة التطبيقات التي تتضمّن إدخال المؤشر (I238ce، b/451607214)
• تُصدر الدوال TextDirection وTextAlign وHyphens وFontSynthesis وvalueOf الآن الخطأ IllegalArgumentException عند تلقّي قيمة غير معروفة. (I07c67)
• عدِّل CompositionDataTree.makeTree لتمرير القيم التلقائية بدلاً من دالة التغليف. (Id64a6، b/445229688)
• إنّ واجهات برمجة التطبيقات لقواعد الاختبار createComposeRule وcreateAndroidComposeRule وcreateEmptyComposeRule التي تقبل المَعلمة effectContext ثابتة، وتكون القيمة التلقائية للمَعلمة هي EmptyCoroutineContext. (If400c، b/450540702)
• تم تغيير اسم UnplacedStateAwareModifierNode إلى UnplacedAwareModifierNode (I6a551، b/449719932)
• التراجع عن ميزة "تحسين عملية التقاط المحتوى" (Ic000b، b/442364065)
• تمت إضافة مفتاح إيقاف أو تفعيل الميزة ComposeUiFlags.isRectManagerOffsetUsageFromLayoutCoordinatesEnabled. وقد أتاحت تحسين الأداء حيث تستخدم طلبات الإحداثيات، مثل LayoutCoordinates.positionInRoot()، الإزاحات المخزّنة مؤقتًا المتوفّرة لدينا في RectManager، بدلاً من الانتقال إلى الشجرة بأكملها في كل طلب. (Ieaadc)

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

• تستخدم PlaceholderSpan الآن الضبط غير الخطي لحجم الخط بشكل صحيح (Id2ead، b/324462728)
• استخدِم ViewCompat لتنفيذ ثوابت التجاوب الحسّي التي تتوافق مع مستوى النظام الأساسي، مع الاعتماد على دعمها الاحتياطي للثوابت الأحدث. (Ib5a00)

الإصدار ‎1.10.0-alpha05

‫8 أكتوبر 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-alpha05. يتضمّن الإصدار 1.10.0-alpha05 هذه التعديلات.

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

• تم إصلاح الخطأ الذي تسبَّب في تحديد موضع غير صحيح للنوافذ المنبثقة المتداخلة في أعلى الشاشة، وأصبحت الآن مرتبطة بشكل صحيح بالنافذة المنبثقة الرئيسية. (Id4603، b/191279752)
• تم إصلاح مشكلة التفاف التركيز مع طرق العرض الأخرى في التسلسل الهرمي. (I95223، b/446028624)
• إصلاح الحقول التي تتضمّن مَعلمات مضمّنة غير متوفّرة في "نافذة الفحص" في تعبيرات lambda التي تم إنشاؤها بواسطة الإصدار 2.2.20 من Kotlin (‫I9855d، b/447110005)
• إصلاح مشكلة حجب أسماء موارد الملء التلقائي بين واجهة المستخدم والوحدات الأساسية (I5da5a)

المساهمة الخارجية

• تمت إعادة تسمية العنصر UiModes إلى AndroidUiModes للإشارة إلى أنّه تم استخراج ثوابته من Android API. (Ia0a77)

الإصدار ‎1.10.0-alpha04

‫24 سبتمبر 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-alpha04. يتضمّن الإصدار 1.10.0-alpha04 هذه التعديلات.

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

• تمت ترقية صيغة قاعدة الاختبار في Compose التي تقبل المَعلمة CoroutineContext إلى إصدار ثابت. تمت إزالة التعليق التوضيحي التجريبي، ولم يعُد على المطوّرين الموافقة على استخدام واجهة برمجة التطبيقات هذه. (I74e6e)
• تمت إزالة الحقل "ComposeUiFlags.isRectTrackingEnabled". لا يتم تفعيل هذه المنطق دائمًا. (Id78df)
• تم إيقاف التحميل الزائد المضمّن لـ Updater#set نهائيًا لأنّه كان يغلف القيمة المقدَّمة عدة مرات (Id679e)
• وضع علامة على السمة الدلالية onAutofillText على أنّها متوقّفة نهائيًا (I6f81c)
• تم طرح UnplacedStateAwareModifierNode. يوفّر هذا الإجراء دالة ردّ يتم استدعاؤها عندما لا يتم عرض التصميم الذي تم وضعه سابقًا. (I8fdd8، b/309776096)
• تم تصحيح المحتوى المتعلق بالسمة RetainObserver.onRetained وأضفنا السمة RetainObserver.onUnused التي تشبه السمة RememberObserver.onAbandoned. (Ia6fc5)
• تمت إضافة onVisibilityChangedNode()، التي تنتج Modifier.Node، ويستخدمها Modifier.onVisibilityChanged() من خلال التفويض، ما يتيح توسيع نطاق هذه الوظيفة في Modifier.Node المخصّصة. (I70d84، b/443001320)

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

• تم إصلاح مشكلة عدم عرض المحتوى المضمّن عند وضعه على السطر الأخير من النص المتعدد الأسطر الذي تم اقتطاعه باستخدام علامات الحذف، على الرغم من أنّ العنصر النائب يسبق المنطقة التي تم اقتطاعها. (I76aaf، b/441829208)

الإصدار ‎1.10.0-alpha03

‫10 سبتمبر 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-alpha03. يتضمّن الإصدار 1.10.0-alpha03 هذه التعديلات.

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

• تتم إعادة تسمية DelegatableNode.invalidateLayoutForSubtree إلى DelegatableNode.invalidateMeasurementForSubtree. (I94257، b/430106107)
• يزيل أداة مطابقة isInHiddenAccessibilitySubtree المكرّرة. (I4476c، b/443792965)
• تتضمّن هذه الإصدارات تتبُّع تسلسل استدعاء الدوال البرمجية في Compose المستند إلى مفتاح المجموعة، والذي يتم تفعيله تلقائيًا لجميع التطبيقات المصغّرة. سيتم إنشاء ملف ربط Proguard لهذه التتبُّعات من خلال المكوّن الإضافي Compose Compiler Gradle بدءًا من الإصدار 2.3.0 من Kotlin. (Ifbcb5)
• تستخدم Modifier.skipToLookaheadSize الآن دالة lambda مفعَّلة تلقائيًا لا تتيح تخطّي تغيير الحجم إلا عندما يكون الانتقال المشترَك نشطًا، تمامًا مثل Modifier.skipToLookaheadPosition. (Ibe0f5، b/432485585)
• تمت إزالة ComposeUiFlags.isOutOfFrameDeactivationEnabled وأصبحت هذه الوظيفة مفعَّلة دائمًا. (I421ed)
• نقل دوال المصنع لإنشاء مثيلات FillableData إلى العنصر المرافق بدلاً من استدعاء FillableData(value)، استخدِم طرق الإنشاء الجديدة: FillableData.createFrom(value). (I2e200، b/441719650)
• إضافة BeyondBoundsLayoutModifierNode عقدة معدِّل جديدة لتنفيذ تخطيط خارج الحدود للبحث عن التركيز (I39be1، b/416133658)
• يرسل FocusTargetModifierNode.requestFocus() التركيز إلى أحد العناصر الفرعية عندما لا يكون قابلاً للتركيز عليه. أصبحت هذه القيمة متوافقة الآن مع FocusRequester.requestFocus() وFocusRequesterModifierNode.requestFocus(). إذا لم تكن بحاجة إلى هذا السلوك، اضبط العلامة ComposeUiFlags.isRequestFocusOnNonFocusableFocusTargetEnabled على "خطأ" في تطبيقك. (Icca5c، b/436863604)
• توفير حجم النافذة المستند إلى وحدات البكسل المستقلة عن الكثافة في WindowInfo (I9322b، b/424442112)
• تمت إزالة العلامة isNestedScrollDispatcherNodeFixEnabled. (If451a)
• إضافة إمكانية استخدام قيم التاريخ في ميزة "الملء التلقائي" في واجهة برمجة التطبيقات FillableData تمت إضافة val dateMillisValue: Long لاسترداد معلومات التاريخ، وتمت إضافة أداة إنشاء FillableData(dateMillisValue: Long) مقابلة لإنشاء مثيلات FillableData مستندة إلى التاريخ. (Id072a)

المساهمة الخارجية

• تم تقديم العنصر UiModes للإعلان عن الثوابت المستخدَمة في التعليق التوضيحي UiMode (I03cb8)

الإصدار ‎1.10.0-alpha02

‫27 أغسطس 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-alpha02. يتضمّن الإصدار 1.10.0-alpha02 هذه التعديلات.

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

• عدِّل FillableData ليتوافق مع المكوّنات غير النصية، مثل أزرار التبديل والقوائم، بما في ذلك القيم المنطقية والصحيحة داخل FillableData ومنشئات المصنع لإنشاء مثيلات منطقية وقائمة من FillableData التي يتم تحويلها إلى AutofillValue في النظام الأساسي. تتم أيضًا إضافة السمة الدلالية والإجراء ذي الصلة. (Ia8105، Icc5cf)
• في وضع عدم اللمس، يحدّد نظام العرض التركيز الأوّلي/التلقائي على أحد العناصر التي يمكن التركيز عليها على الشاشة. تتم إضافة هذه الميزة إلى "الكتابة بذكاء" ويمكن تفعيلها من خلال تفعيل ComposeUiFlags.isInitialFocusOnFocusableAvailable. (Ib9178)
• تمت إزالة العلامة isPointerInteropFilterDispatchingFixEnabled. (Iaa589)
• تمت إزالة العلامة isNestedScrollInteropPostFlingFixEnabled. (I2a756)
• أضِف أدوات مطابقة دلالية isHiddenFromAccessibility() وisInHiddenAccessibilitySubtree(). (I9f5a1)
• تمت إضافة runCurrent() إلى MainTestClock لتنفيذ جميع المهام المستحقة في أداة الجدولة الأساسية. ويتم ذلك لإتاحة إجراء الاختبارات على StandardTestDispatcher، حيث تتم إضافة المهام إلى أداة الجدولة بدلاً من تنفيذها على الفور عندما يكون هناك تأخير بمقدار 0 ملي ثانية. يمكن إعداد اختبار لاستخدام StandardTestDispatcher من خلال إنشاء ComposeTestRule وتمرير StandardTestDispatcher إليه. يتم إجراء الاختبارات تلقائيًا على UnconfinedTestDispatcher، وفي هذه الحالة لن تحتاج إلى استدعاء runCurrent() مطلقًا.
• تمت إضافة إمكانية إجراء الاختبارات على StandardTestDispatcher. في السابق، كان يتم إعداد إطار الاختبار (ولا يزال) باستخدام UnconfinedTestDispatcher، وهو يختلف عن بيئة الإنتاج بطرق دقيقة. يمكنك الآن تغيير هذا الإعداد من خلال إنشاء StandardTestDispatcher خاص بك وإضافته إلى effectContext عند إنشاء ComposeTestRule (أو عند استدعاء runComposeUiTest). (I334d0، b/254115946)
• تعديل الرمز البرمجي لإنشاء شجرة من العُقد من SlotTree (I997d3)

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

• تثبِّت واجهة مستخدم Compose الآن RetainScopes المتوافق مع مراحل النشاط على Android. سيستمر السلوك التلقائي الآن في الاحتفاظ بالقيم التي تم retainها عند إجراء تغييرات في الإعدادات. (Id4a09، b/177562901)

المساهمة الخارجية

• تضيف هذه السمة إمكانية احتساب سرعة المؤشر استنادًا إلى أحداث المؤشر التي يتم تتبّعها باستخدام سلوك خاص بالمنصة.VelocityTracker (I621e8)

الإصدار ‎1.10.0-alpha01

‫13 أغسطس 2025

تم طرح androidx.compose.ui:ui-*:1.10.0-alpha01. يتضمّن الإصدار 1.10.0-alpha01 هذه التعديلات.

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

• عند النقر بالماوس أو لوحة اللمس في ComposeView، سيتم الآن محو التركيز تلقائيًا إذا لم يحدث النقر ضمن حدود العقدة المركّز عليها. يؤدي ذلك إلى توفير تجربة مستخدم "النقر لإزالة التركيز" التي من المتوقّع أن تكون أفضل من السلوك الحالي عند استخدام أجهزة إدخال المؤشر. يمكن إيقاف هذا السلوك باستخدام واجهة برمجة تطبيقات AbstractComposeView.isClearFocusOnPointerDownEnabled جديدة. (I6322b، b/282963174)
• إضافة واجهة FillableData لتوفير أنواع مختلفة من مكونات الملء التلقائي، بالإضافة إلى النص (If9bd2)
• واجهة برمجة تطبيقات جديدة تتيح تفعيل العناصر المشترَكة وإيقافها ديناميكيًا، كما تتيح احتساب ما إذا كان هناك انتقال مستمر للعناصر المشترَكة. واجهة برمجة تطبيقات جديدة لإعداد حدود هدف بديل عند التخلّص من العنصر المشترَك المستهدَف أثناء الانتقال واجهة برمجة تطبيقات جديدة للحصول على LayoutCoordinates LookaheadScope (I18dd4، b/409819304، b/395670637)
• إضافة العلامة isNestedScrollInteropIntegerPropagationEnabled للتحكّم في تجربة إرسال الأعداد الصحيحة إلى ميزة التوافق مع التمرير المتداخل (If8316)
• تمت إضافة requestFocusForChildInRootBounds() إلى DelegatableNode لنقل التركيز إلى عنصر ثانوي يتداخل مع المستطيل المحدّد. (I001ef)
• تمت إزالة العلامات isOnScrollChangedCallbackEnabled وisAdjustPointerInputChangeOffsetForVelocityTrackerEnabled وisFlingContinuationAtBoundsEnabled وisAutomaticNestedPrefetchEnabled وDragGesturePickUpEnabled وisPointerInteropFilterDispatchingFixEnabled وisNestedScrollInteropPostFlingFixEnabled وisNestedScrollDispatcherNodeFixEnabled (I36c18)
• تمت إضافة التعليق التوضيحي @CheckResult إلى دالتَي البحث والاختيار SemanticsNode لفرض استخدام القيم المعروضة. (I6f86e، b/201652748)
• تحسين أداء عملية تسجيل المحتوى (I3c7c0)
• تم تقديم CompositionLocal التي يمكن استخدامها لتعديل فرشاة تمييز الملء الناجح في ميزة "الملء التلقائي". (I52329)
• تم تقديم واجهة Interpolatable جديدة تتيح إجراء عملية استيفاء تلقائية بين الأنواع المختلفة، على افتراض أنّ أحد الأنواع يعرف كيفية التحويل من النوع الآخر. يتم الاستفادة من هذه الواجهة في العديد من أنواع الإنشاء، مثل Brush وShape، ولكن يمكن استخدامها خارجيًا أيضًا. (I58eab)
• تتيح أداة Scrollable الآن التعامل بشكل أفضل مع أحداث التمرير باستخدام عجلة الماوس الثنائية الأبعاد. تم إطلاق واجهة برمجة تطبيقات اختبار جديدة للمساعدة في اختبار حالات الاستخدام في MouseInjectionScope. لقد أضفنا أيضًا حمولة زائدة جديدة لطُرق التمرير في MouseInjectionScope وعلامة للتحكّم في السلوك الجديد تُسمّى isMouseWheel1DAxisLockingEnabled (I136df).
• إضافة DeviceConfigurationOverrides لنوع لوحة المفاتيح وحالتها، ونوع التنقّل وحالته، وحالة شاشة اللمس، ونوع وضع واجهة المستخدم (I282f0)
• تمت إضافة LineHeightStyle.Mode جديد باسم Tight. يساعد هذا الوضع في فرض ارتفاعات أسطر أصغر حتى عندما يكون من المحتمل أن تقطع الحروف الرسومية الأطول. (Id3849)
• تتضمّن BaselineShift الآن قيمة "غير محدّد" لمنع التغليف. تتضمّن BaselineShift وHyphens وLineBreak وTextAlign وTextDirection الآن isSpecified دوال مساعِدة. تتضمّن Hyphens وTextAlign وTextDecoration وTextDirection الآن طريقتَي valueOf() والقيمة اللتين تتيحان النشر على نحو متسلسِل/إلغاء النشر على نحو متسلسِل بكفاءة. (I8d44c)
• تمت إضافة واجهة طريقة getDisplayName جديدة للسماح بأسماء عرض مخصّصة لمثيلات مَعلمات المعاينة. (I19bdf، b/241699422)
• عند مقارنة قيم Dp بالقيمة Unspecified باستخدام علامة أصغر من أو أكبر من، يتم الآن عرض القيمة false دائمًا. يؤدي استخدام Dp.compareTo(Unspecified) دائمًا إلى عرض القيمة 0. سيؤدي ضبط العلامة ComposeUiUnitFlags.isDpCompareToChanged على "خطأ" إلى إعادة Dp.compareTo() إلى سلوكه السابق، حيث لا يؤدي دائمًا إجراء مقارنة بين Unspecified وless-than وgreater-than إلى عرض القيمة "خطأ"، كما أنّ compareTo() مع Unspecified يتطابق مع سلوك Float.compareTo(). (Ifa88b، b/429221319)

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

• تغيير الحد الأدنى التلقائي لإصدار SDK من الإصدار 21 لواجهة برمجة التطبيقات إلى الإصدار 23 (Ibdfca، b/380448311، b/435705964، b/435705223)
• تم إصلاح مشكلة كانت تمنع إنشاء AndroidComposeViews جديدة أثناء إجراء انتقال. (I2e23e، b/340894487، b/287484338)
• إصلاح خطأ في الألوان عند استخدام متّجه قابل للرسم يستخدِم لونًا واحدًا ولا تكون قيمة fillColor معتمة أو شفافة تمامًا (I3b041، b/328677973)
• تم إصلاح مشكلة عدم تعديل الرموز التي تم تحميلها من خلال painterResource باستخدام ألوان خاصة بالمظهر عند تغيير المظهر. (I85ea0، b/424416571)
• إضافة الترميز الدلالي onFillData وfillableData (I45d9e)
• يتم الآن تفعيل ترميز الحالة الخاص بالمنصة دائمًا في StateRestorationTester. يتوافق ذلك مع سلوك الاختبار عند استعادة حالة التطبيق الحقيقية، مثل عملية Parcelization على Android. (I38211، b/408154192، b/382294247)
• تم إصلاح الأعطال التي تحدث أحيانًا عند طلب التركيز. (57b31a11، b/431111149)

الإصدار 1.9

الإصدار 1.9.5

‫19 نوفمبر 2025

تم طرح androidx.compose.ui:ui-*:1.9.5. يتضمّن الإصدار 1.9.5 هذه التعديلات.

الإصدار 1.9.4

‫22 أكتوبر 2025

تم طرح androidx.compose.ui:ui-*:1.9.4. يتضمّن الإصدار 1.9.4 هذه التعديلات.

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

• تم إصلاح مشكلة اختفاء محتوى النص المضمّن إذا كان في السطر الأخير من نص متعدد الأسطر تم اقتطاعه باستخدام علامة الحذف، حتى إذا لم يكن المحتوى المضمّن في المنطقة التي تم اقتطاعها. (I76aaf، b/441829208)
• تم إصلاح مشكلة عدم استدعاء عمليات رد الاتصال الخاصة بأداة التعديل onLayoutRectChanged دائمًا عندما لا تكون قيمة debounceMillis صفرًا. (72aba47، b/445324854)

الإصدار 1.9.3

‫8 أكتوبر 2025

تم طرح androidx.compose.ui:ui-*:1.9.3. يتضمّن الإصدار 1.9.3 هذه التعديلات.

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

• تم إصلاح الخطأ الذي كان يتسبّب في عدم تلقّي معدِّلات onVisibilityChanged/onFirstVisible/onLayoutRectChanged لعمليات معاودة الاتصال إذا كان التصميم الذي يتم نقله يحتوي على أكثر من 170 عنصرًا فرعيًا. (4f2fdd، b/445356774)

الإصدار 1.9.2

‫24 سبتمبر 2025

تم طرح androidx.compose.ui:ui-*:1.9.2. يتضمّن الإصدار 1.9.2 هذه التعديلات.

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

• يتم الآن تنشيط Modifier.onVisibilityChanged() بشكل صحيح عند فصل عقدة أو إعادة استخدامها. (Ic5ce20)
• تعالج السمتان Modifier.onVisibilityChanged() وonLayoutRectChanged() الآن تخطيطات العناصر الرئيسية بشكل صحيح باستخدام placeWithLayer() لوضع العناصر الفرعية. (Ia05ac9)
• بالنسبة إلى Modifier.onVisibilityChanged() وonLayoutRectChanged()، يجب إرسال إشعار بشكل صحيح في الحالات الحدّية، مثل إزالة طبقة أو معدِّل طبقة أو تعديل خصائص الطبقة. (Ia05ac)

الإصدار 1.9.1

‫10 سبتمبر 2025

تم طرح androidx.compose.ui:ui-*:1.9.1. يتضمّن الإصدار 1.9.1 هذه التعديلات.

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

• إصلاح خطأ في الألوان عند استخدام متّجه قابل للرسم يستخدِم لونًا واحدًا ولا تكون قيمة fillColor معتمة أو شفافة تمامًا (I3b041، b/328677973)

الإصدار 1.9.0

‫13 أغسطس 2025

تم طرح androidx.compose.ui:ui-*:1.9.0. يتضمّن الإصدار 1.9.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.8.0

• يمكنك الاطّلاع على التغييرات المهمة في الإصدار 1.9.0 في مشاركة المدونة هذه.
• تتطلّب عمليات التحقّق من Lint التي يتم شحنها مع Compose الآن توفُّر الإصدار 8.8.2 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" كحد أدنى. إذا لم تتمكّن من ترقية "مكوّن Android الإضافي في Gradle"، يمكنك بدلاً من ذلك ترقية Lint بشكلٍ منفصل باستخدام android.experimental.lint.version=8.8.2 (أو إصدار أحدث) في gradle.properties. لتشغيل عمليات التحقّق من أخطاء Compose البرمجية داخل بيئة التطوير المتكاملة، يجب استخدام Android Studio Ladybug أو إصدار أحدث.
• تغيير غير متوافق مع الإصدارات القديمة: تنفّذ عُقد المعدِّل graphicsLayer الآن SemanticsModifierNode. يمكن أن يؤدي ذلك إلى إضافة SemanticsNodes جديد إلى شجرة الدلالات، وبالتالي يؤدي إلى حدوث أخطاء في الاختبارات التي تفترض بنية شجرة الدلالات. على سبيل المثال، قد تفشل الاختبارات التي تستخدم onChild وonParent وonSibling وطرقًا أخرى مشابهة لتقديم تأكيدات إذا تمت إضافة عقدة جديدة بين العقدة الحالية والعقدة المستهدَفة. الطريقة المفضّلة لإصلاح حالات الفشل هذه هي إضافة testTag إلى العقدة المستهدَفة مباشرةً. هناك طريقة أخرى وهي استخدام أداة مطابقة أكثر مرونة، مثل onNode(hasAnyAncestor(hasText("ancestor")) and hasText("target")). (I638b5)

الإصدار ‎1.9.0-rc01

‫30 يوليو 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-rc01. يتضمّن الإصدار 1.9.0-rc01 هذه التعديلات.

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

• تم إصلاح مشكلة عدم تعديل الرموز التي يتم تحميلها من خلال painterResource بألوان خاصة بالمظهر عند تغيير مظهر النظام. (I85ea0، b/424416571)
• إصلاح الأخطاء في الإصدارَين 21(Lollipop) و28(Pie) من واجهة برمجة التطبيقات حيث تمت إعادة تسمية طرق الرسومات المهمة أثناء تحسينها. (Iebf99، b/425120571، b/420462749)
• تأكَّد من أنّه يتم استدعاء معدِّلات onLayoutRectChanged التي تم إدراجها حديثًا في البداية. (l9aa91)، (lb348a)
• إصلاح مشكلة إبطال صحة ذاكرة التخزين المؤقت للإزاحة بشكل غير صحيح، ما يؤدي إلى استدعاء أدوات التعديل onLayoutRectChanged بإحداثيات خاطئة (ibd4cd)، (lddc57)
• حلّ لمشكلة تلقّي التنسيقات التي تم تدويرها أو تحريفها إحداثيات غير صحيحة من خلال المعدِّلات onLayoutRectChanged (lddc57، b/426750475)

المساهمة الخارجية

• تم إصلاح مشكلة اختفاء عناصر dragAndDropSource في LazyList عند التمرير. شكرًا "فيكتور رندينا"! (dc3bcd3، b/425894792)

الإصدار ‎1.9.0-beta03

‫16 يوليو 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-beta03. يتضمّن الإصدار 1.9.0-beta03 هذه التعديلات.

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

• تم إصلاح مشكلة عدم تحرّك الظلال الداخلية المموّهة بشكلٍ موحّد بشكلٍ صحيح مع الإزاحة.

الإصدار ‎1.9.0-beta02

‫2 يوليو 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-beta02. يتضمّن الإصدار 1.9.0-beta02 هذه التعديلات.

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

• تغيير الكائن المصاحب إلى تجريبي ليتطابق مع الفئة (I8452a)
• تمت إزالة العلامة التجريبية isTrackFocusEnabled (I003fd)

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

• عندما لا يحدث أي WindowInsets على محتوى ComposeView، لا يتم تقديم قيم WindowInsetsRulers. (I71221)

الإصدار ‎1.9.0-beta01

‫18 يونيو 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-beta01. يتضمّن الإصدار 1.9.0-beta01 هذه التعديلات.

التغييرات التي قد تؤدي إلى أعطال

• تنفّذ عُقد المعدِّل graphicsLayer الآن SemanticsModifierNode. يمكن أن يؤدي ذلك إلى إضافة SemanticsNodes جديد إلى شجرة الدلالات، وبالتالي يؤدي إلى حدوث أخطاء في الاختبارات التي تفترض بنية شجرة الدلالات. على سبيل المثال، قد تفشل الاختبارات التي تستخدم onChild وonParent وonSibling وطرقًا أخرى مشابهة لتقديم تأكيدات إذا تمت إضافة عقدة جديدة بين العقدة الحالية والعقدة المستهدَفة. الطريقة المفضّلة لإصلاح حالات الفشل هذه هي إضافة testTag إلى العقدة المستهدَفة مباشرةً. هناك طريقة أخرى وهي استخدام أداة مطابقة أكثر مرونة، مثل onNode(hasAnyAncestor(hasText("ancestor")) and hasText("target")). (I638b5)

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

• تم تغيير ShadowContext ليصبح واجهة مغلقة (I3ce40)
• إضافة طريقة متعددة الوحدات لإنشاء حدث لمس غير مباشر (للاختبار) (I22e4c)
• يجعلIndirectTouchEvent.nativeEvent تجريبيًا. (I6fda5)
• تعديل مساحة واجهة برمجة التطبيقات استنادًا إلى ملاحظات مجلس واجهة برمجة التطبيقات (Ibf378)
• إزالة الثابت FrameRateCategory.NoPreference تمّت إعادة تسمية Modifier.requestedFrameRate إلى Modifier.preferredFrameRate. (I2f976)
• ‫WindowInsetsRulers: تم تغيير rulersIgnoringVisibility إلى الحد الأقصى. تم تغيير getDisplayCutoutBounds() لتصبح دالة إضافية من PlacementScope. تم تغيير WindowInsetsAnimationProperties إلى WindowInsetsAnimation، وتم تغيير getAnimationProperties() إلى getAnimation(). (I3816f)
• تم تغيير الفئة من ShadowParams إلى Shadow (I11cca)
• تغيير حزمة واجهة برمجة التطبيقات الخاصة بعدد اللقطات في الثانية من androidx.compose.ui.ui إلى androidx.compose.ui (I8994e)
• تم تغيير InsetsRulers ليكون في الرمز المشترك مع الاسم WindowInsetsRulers. تم تبسيط واجهة برمجة التطبيقات لتصبح جميع عمليات الإدخال WindowInsetsRulers. تم استخراج خصائص الصورة المتحركة التي لا تستخدم المسطرة إلى فئة AnimationProperties. يمكن استخدام WindowInsetsRulers.innermostOf() لدمج عدة WindowInsetsRulers. (I2f0c6، b/415012444)
• تمت إضافة واجهة برمجة تطبيقات للأدوات من أجل تحليل معلومات المصدر التي أضافها برنامج التجميع في Compose. (Iceaf9، b/408492167)

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

• تمت إزالة العلامة الخاصة بـ isGetFocusedRectReturnEmptyEnabled بعد أن تم التحقّق من الميزة بالكامل. (Ife722)
• تم إصلاح خطأ في performScrollToNode، والذي لم يكن يصل في بعض الحالات إلى العقدة المستهدَفة. باستخدام هذا الإصلاح، من المفترض أن يصل دائمًا إلى العقدة المستهدَفة في هذه الحالات. من الآثار الجانبية لهذا التغيير أنّ موضع التمرير الدقيق في نهاية الإجراء قد يختلف الآن، ما يؤثّر في اختبارات لقطات الشاشة والاختبارات التي تفترض موضع التمرير الدقيق. (I2c8a1)

الإصدار ‎1.9.0-alpha04

‫4 يونيو 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-alpha04. يتضمّن الإصدار 1.9.0-alpha04 هذه التعديلات.

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

• تمّت إضافة واجهات برمجة تطبيقات معدِّلة للظلال القابلة للتخصيص. (I2058d، b/160665122)
• أضِف السمة SemanticsModifierNode.isImportantForBounds التي تحدّد ما إذا كان يجب أخذ العقدة في الاعتبار عند احتساب الحدود. القيمة التلقائية للسمة هي "صحيح"، ويمكن ضبطها على "خطأ" للإشارة إلى أنّه يجب عدم أخذ العقدة في الاعتبار عند تحديد الحدود. (I7ebec)
• أضِف دالة مصنع SemanticsPropertyKey للإعلان عن خصائص الدلالات الخاصة بنظام التشغيل Android والتي يتم توفيرها كإضافات تسهيل الاستخدام يتم عرضها من خلال AccessibilityNodeInfo.getExtras. (I2ed51)
• تمت إزالة استخدامات ComposeUiFlags.isRemoveFocusedViewFixEnabled وإيقاف العلامة نهائيًا. (I50328)
• إضافة إطار ظل جديد قابل للتخصيص يشمل ذلك DropShadowPainter وInnerShadowPainter بالإضافة إلى تبعيات DropShadow/InnerShadow. تتم مشاركة البنية الأساسية للظلال بحيث يمكن مشاركة الظلال نفسها التي تم إنشاؤها في مواقع متعددة بدون الحاجة إلى إعادة إنشاء الظلال n مرة. (I24f7a، b/160665122)
• إضافة CompositeShader وCompositeShaderBrush لإنشاء نتيجة مركّبة بين برنامجَي تظليل أضِف أيضًا ShaderBrush#transform لضبط مصفوفة تحويل للتظليل. (I2621a، b/160665122)

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

• تم إصلاح خطأ في NestedScrollInteropConnection حيث كانت طرق النقل السريع تظهر بترتيب غير صحيح بالنسبة إلى طرق العرض. (I56ad4)
• في السابق، لم تكن مربّعات الحوار التي يتم عرضها بملء الشاشة تظهر ضمن منطقة صورة مقطوعة للشاشة. تم إصلاح هذا الخطأ حتى تتمكّن مربّعات الحوار التي تتضمّن decorFitsSystemWindows = false وusePlatformDefaultWidth = false من الاستفادة من منطقة الصورة المقطوعة للشاشة. (I9e975)
• تم إصلاح خطأ عدم رسم مؤشر التركيز الأخضر في TalkBack بعد تفعيله أثناء تشغيل تطبيق Compose في الخلفية. (Ifd12a)

الإصدار 1.9.0-alpha03

‫20 مايو 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-alpha03. يتضمّن الإصدار 1.9.0-alpha03 هذه التعديلات.

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

• تضمن العلامة ComposeUiFlags.isGetFocusedRectReturnEmptyEnabled أنّه عندما لا يكون هناك أي عنصر قابل للتركيز في ComposeView، يتم ضبط المستطيل على قيمة فارغة. يمنع ذلك عملية البحث المركّز من اختيار "العرض" الذي سيتم التركيز عليه. ويكون ذلك مهمًا بشكل خاص عندما يتضمّن أداة IME خيار NEXT (التالي) حيث قد يحاول التركيز على ComposeView ويحدث خطأ في requestFocus(). (Ibd0e2، b/369256395)
• إضافة العلامة isNestedScrollDispatcherNodeFixEnabled (I0d24a)
• إعادة تسمية DialogProperties' dialogContentTitle إلى windowTitle (Ibd27b)
• تم تقديم المعدّلين Modifier.onFirstVisible وModifier.onVisibilityChanged، وهما معدّلان رفيعا المستوى يستندان إلى Modifier.onLayoutRectChanged. تم تصميم هذه المعدّلات خصيصًا للتعامل مع العديد من متطلبات التطبيقات الشائعة، مثل تسجيل مرّات الظهور وتشغيل الفيديوهات تلقائيًا وما إلى ذلك. وقد تم تصميمها مع مراعاة الأداء، حتى يمكن استخدامها في السيناريوهات المهمة المستندة إلى القوائم بدون خطر التأثير في أداء التمرير. بالإضافة إلى واجهات برمجة التطبيقات الخاصة بأدوات التعديل هذه، تمت إضافة واجهات برمجة تطبيقات أخرى إلى RelativeLayoutBounds من أجل توفير حالات الاستخدام هذه، بالإضافة إلى تسهيل إنشاء أدوات تعديل مخصّصة مشابهة تناسب حالة الاستخدام المحدّدة للمطوّرين. (I759b8)
• غيِّر القيمة setDiagnosticStackTraceEnabled إلى "تجريبي" لتوضيح أنّ هذه الميزة ستخضع للتطوير في المستقبل. (I11db3)
• إضافة Modifier.scrollable2D وScrollable2DState وواجهات برمجة التطبيقات المصاحبة لإنشاء الحالة تم أيضًا تقديم دوال شائعة لإضافة التمرير. (Ic61c8، b/214410040)
• لا يمكن مقارنة قيم الألوان في Compose ذات 64 بت مباشرةً مع قيم الألوان في Android ColorLongs لأنّ أرقام تعريف مساحات الألوان غير مرتبة لبعض مساحات الألوان. لتحويل مساحات الألوان في Android، تمت إضافة واجهتَي برمجة تطبيقات جديدتَين: toColorLong() وfromColorLong(). (I36899)
• تمت إضافة ViewConfiguration.minimumFlingVelocity للسماح بالتحكّم في الحد الأدنى لسرعة التمرير السريع. (I11aab)

الإصدار ‎1.9.0-alpha02

‫7 مايو 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-alpha02. يتضمّن الإصدار 1.9.0-alpha02 هذه التعديلات.

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

• أضِف dialogContentTitle إلى DialogProperties، ما يؤدي إلى ضبط عنوان نافذة المحتوى. bf9d670

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

• تم إيقاف مساطر Window Insets مؤقتًا أثناء إصلاح الاختبارات الداخلية. 8d1402
• تم إصلاح طريقة إضافة التغييرات في إدخال المؤشر إلى VelocityTracker في DragGestureNode، ويمكن التحكّم في ذلك باستخدام العلامة الجديدة isAdjustPointerInputChangeOffsetForVelocityTrackerEnabled.254ddb

الإصدار ‎1.9.0-alpha01

‫23 أبريل 2025

تم طرح androidx.compose.ui:ui-*:1.9.0-alpha01. يتضمّن الإصدار 1.9.0-alpha01 هذه التعديلات.

التغييرات في السلوك

• تتطلّب عمليات التحقّق من Lint التي يتم شحنها مع Compose الآن توفُّر الإصدار 8.8.2 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" كحد أدنى. إذا لم تتمكّن من ترقية "مكوّن Android الإضافي في Gradle"، يمكنك بدلاً من ذلك ترقية Lint بشكلٍ منفصل باستخدام android.experimental.lint.version=8.8.2 (أو إصدار أحدث) في gradle.properties. لتشغيل عمليات التحقّق من أخطاء Compose البرمجية داخل بيئة التطوير المتكاملة، يجب استخدام Android Studio Ladybug أو إصدار أحدث.

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

• يزيل العلامة لتفعيل عبارات التتبُّع لأداة تتبُّع مسار النتائج (تصحيح الأخطاء). (I1b2a1)
• تم تغيير InnerRectRulers وOuterRectRules إلى طرق بدلاً من ذلك. تمت إزالة المَعلمة name من واجهة برمجة التطبيقات العامة RectRulers. أصبحت DerivedRulers خيارًا في أداة الإنشاء لكلّ من "المسطرة العمودية" و"المسطرة الأفقية". تم استبدال MergedHorizontalRulers وMergedVerticalRulers بالطريقتَين minOf وmaxOf لإنشاء مثيلات. (Iee89f، b/408192133)
• إيقاف androidx.compose.ui.LocalSavedStateRegistryOwner نهائيًا واستخدام androidx.savedstate.compose.LocalSavedStateRegistryOwner بدلاً منه (I5439f، b/377946781)
• أضِف Modifier.keepScreenOn لضبط الشاشة على عدم إيقافها مؤقتًا أثناء العرض (Ib5af4، b/408284174)
• أضِف سمة دلالية جديدة Shape، والتي يمكن ضبطها عندما يختلف شكل عنصر في واجهة المستخدم عن المستطيل المحيط به، مثل المستطيل ذي الزوايا الدائرية. (I1376f)
• تم إصلاح مشكلة إرسال أحداث المؤشر في AndroidViews، وتمت إضافة العلامة isPointerInteropFilterDispatchingFixEnabled لحماية التغييرات. (I0e272، b/372055500، b/408002332)
• لم يعُد FocusRestorer يثبّت العنصر الذي تم التركيز عليه سابقًا. على المستخدمين استخدام مفتاح لضمان أنّ العنصر الذي تم التركيز عليه سابقًا يتضمّن تجزئة التركيب نفسها، وذلك لاستعادة التركيز بنجاح. (I4203b، b/330696779)
• السماح لـ "الكتابة الذكية" بتفعيل ViewTreeObserver.OnScrollChanged يتم تقديم هذا السلوك ضمن العلامة isOnScrollChangedCallbackEnabled. أضفنا أيضًا وظيفة موسّعة للسمة DelegatableNode dispatchOnScrollChanged. (I34b9d، b/238109286)
• تم إيقاف currentCompositeKeyHash نهائيًا. يمكنك استخدام currentCompositeKeyHashCode كبديل. تشفّر واجهة برمجة التطبيقات البديلة التجزئة نفسها باستخدام عدد أكبر من البتات، ما يقلّل بشكل كبير من احتمال أن يكون لمجموعتَين عشوائيتَين غير مرتبطتَين في التسلسل الهرمي للتركيب مفتاح التجزئة نفسه. (I4cb6a، b/177562901)
• تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP (Idb6b5)
• تمت إضافة إمكانية إجراء فحص lint للرمز FocusRequester للتأكّد من تذكّره داخل التركيب (I6bf91)
• تمت إضافة إمكانية ضبط عدد اللقطات المفضّل في الثانية أو فئة عدد اللقطات في الثانية التي يجب عرض العنصر القابل للإنشاء بها (Ie5201)
• عرض MotionEvent على Android (I17286)
• إضافة getChecked() + setChecked(int) وإيقاف isChecked + setChecked(boolean) نهائيًا (Iaac9d)
• تقبل أداة التعديل graphicsLayer الآن blendMode وcolorFilter (Iab0e6)
• تمت إضافة LocalResources composition local للاستعلام عن "الموارد". ستتم إعادة إنشاء LocalResources.current عند تغيُّر الإعدادات، لذا ستعرض طلبات البيانات من واجهات برمجة التطبيقات، مثل stringResource()، قيمًا معدَّلة. (I50c13، b/274786917)
• عرض واجهة برمجة تطبيقات تجريبية للعناصر القابلة للإنشاء من أجل التعامل مع أحداث اللمس غير المباشرة (Icff57)
• يحسِّن هذا الإصدار عملية إعداد التقارير عن الاستثناءات التي لم تتم معالجتها والتي تم طرحها أثناء مرحلتَي التنسيق والرسم للمحتوى القابل للإنشاء. في السابق، كان حدوث خطأ غير معالج هنا يؤدي إلى تعطُّل أداة تنفيذ الاختبار وإنهاء حزمة الاختبار قبل الأوان. يمكن الآن الإبلاغ عن هذه الاستثناءات بشكل أفضل بدون إنهاء مجموعة الاختبارات. (I9928b، b/314128080)
• تم إيقاف واجهة برمجة التطبيقات التجريبية GlobalAssertions نهائيًا. وكان الغرض من استخدامه هو إجراء عمليات التحقّق من إمكانية الوصول، لذا ننصحك باستخدام enableAccessibilityChecks() لهذا الغرض بدلاً من ذلك. (I50aa5)
• لم يعُد SemanticsNodeInteraction.performTextInputSelection تجريبيًا، وأصبح يتيح الآن مَعلمة relativeToOriginal إضافية تتيح لك تطبيق التحديد على النص الأصلي غير المحوّل أو النص المحوّل. (I3a905، b/261561038، b/277018945)
• إضافة واجهة برمجة تطبيقات لإنشاء قوائم نقطية مخصّصة من خلال AnnotatedString (I1d066، b/383269496، b/139326648)
• إيقاف runWithTimingDisabled نهائيًا واستخدام runWithMeasurementDisabled بدلاً منه، لأنّه يصف السلوك بشكل أكثر وضوحًا، أي أنّه يتم إيقاف جميع المقاييس مؤقتًا. بالإضافة إلى ذلك، يجب عرض الفئة الرئيسية MicrobenchmarkScope لأنّه لا يمكن إعادة تعريف الدالة runWithMeasurementDisabled لفتح الوصول، لأنّها مضمّنة. (I9e23b، b/389149423، b/149979716)
• تم تعديل واجهة برمجة التطبيقات ui-tooling Devices لتشمل أجهزة أحدث. (Ia2ac1)
• إضافة "الوضع العمودي على الأجهزة اللوحية" إلى مجموعة أحجام "شاشة المعاينة" لمساعدة المطوّر على مراعاة النوافذ الأكبر حجمًا (Ia1976)
• إضافة واجهة برمجة تطبيقات لقيمة التتبُّع من أجل وضع علامة على عملية التتبُّع أو تسجيلها مع قيم في نقطة زمنية معيّنة تظهر قيم التتبُّع في Prefetto كمسار جديد يمكن الاطّلاع عليه من خلال المخطط الزمني لعملية التتبُّع. على أجهزة Android، يتم تنفيذها باستخدام Trace.setCounter. (Idcf48)

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

• إصلاح عملية إرسال المراقبين الذين تم تذكّرهم في التركيب القابل للإيقاف المؤقت لتجنُّب إرسال المراقبين الذين تم تذكّرهم أو نسيانهم في عملية التطبيق نفسها (I570b2، b/404645679، b/407931790)
• يمكن الآن ضبط android:dialogTheme للتحكّم في خصائص مربّع الحوار عندما تكون قيمة decorFitsSystemWindows هي "خطأ" (I7922f، b/246909281)
• تم إصلاح الخطأ الذي كان يؤدي إلى إغلاق مربّع الحوار عند رصد أي حدث حركة خارجه. (Ia78fd)
• تتطلّب عمليات التحقّق من أخطاء Compose الآن الحدّ الأدنى من إصدار "مكوّن Android الإضافي لنظام Gradle" وهو 8.8.2 من سطر الأوامر، والإصدار Ladybug من "استوديو Android" على الأقل للاستفادة من ميزات بيئة التطوير المتكاملة. إذا كنت تستخدم إصدارًا قديمًا من المكوّن الإضافي لنظام Gradle المتوافق مع Android‏ (AGP)، يمكنك ضبط android.experimental.lint.version=8.8.2 في ملف gradle.properties لترقية إصدار Lint بدون التأثير في AGP. (I6f2a8)
• تمت إضافة سمة دلالية جديدة InputText تسجّل قيمة textfield قبل تطبيق عملية تحويل الإخراج. (Iae46a، b/395911609، b/176949051)
• تم نقل واجهة برمجة التطبيقات enableAccessibilityChecks() التي تفعّل "عمليات التحقّق من إمكانية الوصول" على Android إلى حِزم منفصلة تكون compose:ui:ui-test-accessibility إذا كنت لا تستخدم TestRule وcompose:ui:ui-test-junit4-accessibility عند الاتصال بـ TestRule (I3c318، b/391560768)
• إتاحة تتبُّع تسلسل استدعاء الدوال البرمجية في LaunchedEffect وrememberCoroutineScope (I705c0، b/354163858)

المساهمة الخارجية

• تغيير الدالة التجريبية runComposeUiTest لقبول حظر التعليق تمت أيضًا إضافة دالة runComposeUiTest متوقّفة نهائيًا للتوافق الثنائي (I3b88c، b/361577328)

الإصدار 1.8

الإصدار 1.8.3

‫18 يونيو 2025

تم طرح androidx.compose.ui:ui-*:1.8.3. يتضمّن الإصدار 1.8.3 هذه التعديلات.

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

• تمت إزالة العلم الخاص بـ isGetFocusedRectReturnEmptyEnabled بعد أن تم التحقّق من الميزة بالكامل. (Ife722)
• تضمن العلامة ComposeUiFlags.isGetFocusedRectReturnEmptyEnabled أنّه عندما لا يكون هناك أي عنصر قابل للتركيز في ComposeView، يتم ضبط المستطيل على قيمة فارغة. يمنع ذلك عملية البحث المركّز من اختيار "العرض" الذي سيتم التركيز عليه. ويكون ذلك مهمًا بشكل خاص عندما يتضمّن محرر أسلوب الإدخال خيار NEXT حيث قد يحاول التركيز على ComposeView وrequestFocus() قد يتعذّر ذلك. (Ibd0e2، b/369256395)

الإصدار 1.8.2

‫20 مايو 2025

تم طرح androidx.compose.ui:ui-*:1.8.2. يتضمّن الإصدار 1.8.2 هذه التعديلات.

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

• إصلاح خطأ NPE عند إزالة مربّع الحوار أثناء بثّ الأحداث النشط في مربّع الحوار (6a7e7f)
• إصلاح مشكلة عدم تعديل onLayoutRectChange وفقًا للمخطط الزمني المحدود عند حدوث تعديلات على الرسم فقط (03b82d)

الإصدار 1.8.1

‫7 مايو 2025

تم طرح androidx.compose.ui:ui-*:1.8.1. يتضمّن الإصدار 1.8.1 هذه التعديلات.

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

• حلّ بعض المشاكل في onLayoutRectChanged وLazyLayout d791b11
• تخطّي طلبات إعادة القياس للعناصر المُعدّة مسبقًا أثّرت هذه المشكلة في أداء التمرير في التنسيقات الكسولة، إذ لم يكن الجلب المُسبَق يعمل بكفاءة في بعض الحالات، وكان القياس يتم داخل الإطار. 742087a

الإصدار 1.8.0

‫23 أبريل 2025

تم طرح androidx.compose.ui:ui-*:1.8.0. يتضمّن الإصدار 1.8.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.7.0

• يحتوي الإصدار 1.8 من Compose على ميزة الملء التلقائي الدلالي التي تمت إضافتها حديثًا. تأكَّد من أنّ إصدارات واجهة المستخدم وFoundation التي تستخدمها هي الإصدار 1.8 أو إصدار أحدث، لأنّ الملء التلقائي لمكوّنات النص يتطلّب أحدث إصدارات كلا الوحدتَين. لمزيد من التفاصيل حول استخدام واجهة برمجة التطبيقات والأمثلة، يُرجى الرجوع إلى مستندات ميزة "الملء التلقائي" هنا.
• يتوافق الإصدار 1.8 من Compose مع أنواع إضافية من التجاوب الحسّي: Confirm وContextClick وGestureEnd وGestureThresholdActivate وReject وSegmentFrequentTick وSegmentTick وToggleOn وToggleOff وVirtualKey. يمكن الوصول إلى هذه الميزة من خلال LocalHapticFeedback، وتتوفّر تلقائيًا على أجهزة Android عندما تشير Vibrator API إلى أنّ اللمسات متوافقة.
• أصبحت واجهات برمجة التطبيقات المتعدّدة الخاصة بميزة "التركيز" ثابتة الآن، بما في ذلك Modifier.focusRestorer() وonEnter وonExit FocusProperties (I6e667). يمكنك الآن تحديد FocusDirection عند الاتصال بالرقم requestFocus. أضفنا واجهة برمجة تطبيقات requestFocus(FocusDirection) إلى كل من focusRequester وFocusTargetModifierNode للسماح بالتركيز في اتجاه معيّن. (I5d9ec][https://android-review.googlesource.com/#/q/I5d9eca3a2cd283c1b84ad6b77d929ef9a49ce4cc], b/245755256)

الإصدار ‎1.8.0-rc03

‫9 أبريل 2025

تم طرح androidx.compose.ui:ui-*:1.8.0-rc03. يتضمّن الإصدار 1.8.0-rc03 هذه التعديلات.

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

• يوقف هذا الإصدار بعض إصلاحات التوافق مع ميزة "التركيز" التي تسبّبت في حدوث مشكلة. (b9d998 وb/369256395 وb/378570682 وb/376142752 وb388590015/ وb/389994198 وb/391378895)

الإصدار ‎1.8.0-rc02

‫26 مارس 2025

تم طرح androidx.compose.ui:ui-*:1.8.0-rc02. يتضمّن الإصدار 1.8.0-rc02 هذه التعديلات.

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

• تم إصلاح مشكلة كانت تؤدي إلى إعادة إنشاء التركيب عند إزالة العرض المركّز من قائمة كسولة، وذلك عندما تكون طرق العرض المركّزة مضمّنة في بنية Compose الهرمية. (765562)

الإصدار ‎1.8.0-rc01

‫12 مارس 2025

تم طرح androidx.compose.ui:ui-*:1.8.0-rc01. يتضمّن الإصدار 1.8.0-rc01 هذه التعديلات.

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

• تم إصلاح تعطُّل يحدث عند إزالة AndroidView تم التركيز عليه مع تفعيل لوحة مفاتيح افتراضية. (Ic725a)
• تم إصلاح بعض المشاكل في عملية تنفيذ معالجة حالة التركيز الجديدة. (b/395895685)
• تم إصلاح مشكلة تمنع ميزة "الملء التلقائي" عند استخدام LaunchedEffect لطلب التركيز على حقل نصي. (b/392539099)

الإصدار ‎1.8.0-beta03

‫26 فبراير 2025

تم طرح androidx.compose.ui:ui-*:1.8.0-beta03. يتضمّن الإصدار 1.8.0-beta03 هذه التعديلات.

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

• تم نقل واجهة برمجة التطبيقات enableAccessibilityChecks() التي تفعّل "عمليات التحقّق من إمكانية الوصول" على Android إلى حِزم منفصلة، وهي compose:ui:ui-test-accessibility في حال عدم استخدام TestRule وcompose:ui:ui-test-junit4-accessibility عند استدعاء TestRule (I547ef، b/391560768)
• تمت إضافة سمة دلالية جديدة InputText تسجّل قيمة حقل نصي قبل تطبيق عملية تحويل الإخراج. (Iae46a)

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

• تم إصلاح مشكلة كانت تتسبب في حفظ خدمات الملء التلقائي للنص المحوّل بدلاً من النص الأصلي. (Iae46a، b/395911609، b/176949051)

الإصدار ‎1.8.0-beta02

‫12 فبراير 2025

تم طرح androidx.compose.ui:ui-*:1.8.0-beta02. يتضمّن الإصدار 1.8.0-beta02 هذه التعديلات.

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

• تمت إضافة عملية فحص باستخدام أداة Lint للتحذير من إجراء طلبات إلى Configuration#screenWidth/heightDp، ويمكن استخدام LocalWindowInfo.current.containerSize بدلاً من ذلك لاسترداد حجم النافذة الحالية.

الإصدار ‎1.8.0-beta01

‫29 يناير 2025

تم طرح androidx.compose.ui:ui-*:1.8.0-beta01. يتضمّن الإصدار 1.8.0-beta01 هذه التعديلات.

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

• تم وضع علامة "متوقّف نهائيًا" على السمتَين ContextualFlowRow وContextualFlowColumn. تم طرح هذا المكوّن التجريبي في الإصدار 1.7 ولم يتم تثبيته بعد، وتم اعتبار عملية التنفيذ غير مرغوب فيها. في المستقبل، قد يتم توفير مكوّن يحلّ حالات الاستخدام التي كان من المفترض أن يحلّها هذا المكوّن.
  • يتضمّن FlowRow وFlowColumn عمليات تحميل تجريبية تم طرحها في الإصدار 1.7 تتضمّن المَعلمة overflow. تم إيقاف استخدام هذه المَعلمة نهائيًا، ويمكن استخدام عمليات التحميل الزائد بدون هذه المَعلمة بدلاً منها. سيكون السلوك التلقائي "للتجاوز" في هذه الحالات هو "القص"، كما كان منذ طرحه.
  • يمكن تحقيق العديد من حالات استخدام ContextualFlowRow باستخدام FlowRow، ولكننا ندرك أنّ هذا ليس صحيحًا بشكل عام. يمكن تنفيذ ContextualFlowRow بالكامل في مساحة المستخدم، ويمكن محاولة نسخ عملية التنفيذ وتعديلها إذا لزم الأمر. نأمل في المستقبل أن نتمكّن من حلّ حالات الاستخدام هذه بطريقة مختلفة. (Ibafec)
• تمّت إزالة SemanticsNodeInteraction.semanticsId(). يمكنك استخدام SemanticsNodeInteraction.fetchSemanticsNode().id كبديل. (Ie397a)
• تم إيقاف واجهات برمجة التطبيقات القديمة الخاصة بميزة "الملء التلقائي" نهائيًا. يمكنك استخدام واجهة برمجة التطبيقات الجديدة المستندة إلى الدلالات بدلاً من ذلك. (I943ff)
• إعادة كتابة واجهة برمجة التطبيقات requestAutofill لتكون خارج مدير الملء التلقائي (Id1929)

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

• تم إصلاح مشكلة التركيز التي كانت تؤدي إلى تخطّي ComposeView عند استخدام requestFocus() مع المَعلمة previouslyFocusedRect غير المنطقية (المتعلّقة باتجاه التركيز). (Ifdc2f، b/388590015)
• تم إصلاح خطأ NPE الذي يظهر أحيانًا عند استخدام GraphicsLayer.record { this@ContentDrawScope.drawContent() }. إذا كنت تسجّل drawContent() بهذه الطريقة، احرص على استخدام دالة الإضافة GraphicsLayer#record داخل DrawScope، وليس دالة العنصر في GraphicsLayer. (I75fc0، b/389046242)
• تم إصلاح مشكلة في تخطيط النص حيث يتم أحيانًا ترجمة علامة الحذف الإيجازي بشكل غير صحيح أثناء الرسوم المتحركة، يمكنك الاطّلاع على b/389707025 لمزيد من المعلومات (Ie55b1، b/389707025)

الإصدار ‎1.8.0-alpha08

‫15 يناير 2025

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha08. يتضمّن الإصدار 1.8.0-alpha08 هذه التعديلات.

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

• جعل AutofillManager فئة مجرّدة (I0a3b0)
• تم إصلاح العديد من المشاكل المتعلّقة بالتركيز، بما في ذلك الأعطال عند محاولة محرر أسلوب الإدخال (IME) التركيز على ComposeView بدون عناصر يمكن التركيز عليها، وتغيير التركيز داخل العنصر الفرعي AndroidViews، وطلب التركيز الذي يترك AndroidView. (Ia03c3، b/369256395، b/378570682، b/376142752)
• تغيير FocusEnterExitScope.cancelFocus() إلى cancelFocusChange() (I89959)
• يمكنك الآن حساب عمليات الإطباق القابلة للتركيب باستخدام RectInfo.calculateOcclusions().
• تمت إضافة دالة إضافة إلى DelegatableNode لتسجيل أداة معالجة لتغييرات التنسيق العام. (I68b59)

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

• يستخدم النشاط الذي يتم استخدامه كمضيف للدالة المركّبة قيد الاختبار عند استخدام ComposeContentTestRule.setContent الآن المظهر Theme.Material.Light.NoActionBar، وذلك لتجنُّب تداخل ActionBar مع محتوى الاختبار عند استهداف الإصدار 35 من حزمة تطوير البرامج (SDK). لإيقاف هذا السلوك، يمكنك إزالة الاعتمادية في ui-test-manifest وإضافة إدخال نشاط في ملف AndroidManifest.xml الخاص بتطبيق الاختبار لـ ComponentActivity مع اختيار المظهر الذي تريده. (I7ae1b، b/383368165)
• ستتجنّب خطوط الموارد التي تتضمّن إعدادات الصيغة نفسها الآن التخزين المؤقت الزائد الذي يؤدي إلى تطبيق إعدادات الصيغة غير الصحيحة. (If3dff، b/372044241)
• تتيح AnnotatedString.fromHtml الآن استخدام علامات <ul>/<li>. (I7c2fe، b/299662276، b/139326648)

المساهمة الخارجية

• تمت إضافة واجهة Clipboard جديدة وتركيبة محلية لها. (I80809)

الإصدار ‎1.8.0-alpha07

‫11 ديسمبر 2024

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha07. يتضمّن الإصدار 1.8.0-alpha07 هذه التعديلات.

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

• تم عرض المالك من LayoutNode للأدوات. (I26f7f)
• يجب أن يستخدم LocalAutofillHighlightColor نوع Color. (I0e05b)
• احتفظ بالرمز UrlAnnotation المتوقّف نهائيًا وطرق استخدامه مصنّفة على أنّها تجريبية. (Ic0021)

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

• تم إصلاح عُطل IndexOutOfBoundsException عند استخدام LinkAnnotation داخل العنصر المركّب BasicText أو Text (be7605، b/374115892)
• تم إصلاح المشكلة المتمثّلة في عدم قص خط المؤشر في حقول النص المملوءة ذات الشكل المخصّص. (I4f87f، b/380704151)
• تم إصلاح مشكلة عدم ظهور الخلفيات في لقطات الشاشة الطويلة. (I4d57a)
• تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن القيم الخالية من JSpecify، وهي تعليقات توضيحية خاصة باستخدام النوع. على مطوّري Kotlin استخدام وسيطة المترجم البرمجي التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مترجم Kotlin البرمجي). (Idfef8، b/326456246)
• تعديل توافق Compose مع الألوان ذات النطاق الواسع والألوان بتقنية HDR عند التشغيل على الإصدار Android Q والإصدارات الأحدث (Icd8be، b/379135036)
• سيتم الآن الرجوع تلقائيًا إلى الخط التلقائي عند تعذُّر تحميل خطوط الموارد، بدلاً من السلوك السابق الذي كان يؤدي إلى ظهور استثناء في القياس. (Ib6a49)
• تم إصلاح مشكلة فقدان التركيز عند فصل AndroidView وإعادة ربطه. (I53446)
• قبول requestFocus() من إجراء تخطيط خارج الحدود (Ia8461)

المساهمة الخارجية

• أضِف BringIntoViewResponderModifierNode إلى واجهة المستخدم، ما يوفّر طريقة جديدة لتنفيذ وظيفة "إظهار العنصر في العرض"، فضلاً عن إمكانية تنفيذها على مستوى النظام الأساسي. (Ia6dd8)

الإصدار ‎1.8.0-alpha06

‫13 نوفمبر 2024

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha06. يتضمّن الإصدار 1.8.0-alpha06 هذه التعديلات.

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

• تضيف هذه السمة المعدِّل stylusHoverIcon. (Iff20a، b/331289114)
• تغيير "مدير الملء التلقائي" ليكون واجهة (I84914، b/376080755)
• يضيف requestFocus(FocusDirection) إلى كل من focusRequester وFocusTargetModifierNode للسماح بالتركيز في اتجاه معيّن. (I5d9ec، b/245755256)
• تم استبدال FocusProperties.enter وFocusProperties.exit بـ onEnter وonExit، وذلك باستخدام نطاق جهاز استقبال بدلاً من المَعلمة FocusDirection. (I6e667)
• إضافة ميزة "الملء التلقائي" إلى شريط أدوات النص (Ie6a4c)
• تغييرات واجهة برمجة التطبيقات في Modifier.focusRestorer() (I99c03):
  • تم تغيير اسم المَعلمة إلى "fallback"
  • المَعلمة هي الآن FocusRequester وليست دالة lambda
  • أصبحت المَعلمة غير فارغة مع ضبط القيمة التلقائية على "تلقائي"
• إزالة التعليق التوضيحي @Experimental من واجهة أداة إدارة الملء التلقائي لا تزال الميزة قيد التطوير لاستهداف هذا الإصدار، ولكننا لا نريد طرح واجهة برمجة التطبيقات التجريبية (Id8398).
• توفّر السمة LocalHapticFeedback الآن عملية تنفيذ تلقائية HapticFeedback عندما تشير واجهة برمجة التطبيقات Vibrator API إلى أنّ تقنية اللمس متاحة. تمت إضافة ما يلي إلى HapticFeedbackType - Confirm وContextClick وGestureEnd وGestureThresholdActivate وReject وSegmentFrequentTick وSegmentTick وToggleOn وToggleOff وVirtualKey. تنفّذ الآن مكوّنات Wear Compose التي يمكن النقر عليها مطوّلاً، مثل Button وIconButton وTextButton وCard، الاهتزاز LONG_PRESS عند توفير معالج للنقر المطوّل. (I5083d)
• تتم إزالة OverscrollConfiguration وLocalOverscrollConfiguration، وإضافة rememberPlatformOverscrollFactory لإنشاء مثيل من عملية التنفيذ التلقائية لتجاوز حد التمرير أو تخصيص مَعلماتها. لإيقاف تجاوز حد التمرير، استخدِم LocalOverscrollFactory provides null بدلاً من LocalOverscrollConfiguration provides null. لتغيير لون التوهّج أو المساحة المتروكة، استخدِم LocalOverscrollFactory provides rememberPlatformOverscrollFactory(myColor, myPadding) بدلاً من LocalOverscrollConfiguration provides OverscrollConfiguration(myColor, myPadding). (Ie71f9 وb/255554340 وb/234451516)
• تمت إزالة واجهة برمجة التطبيقات التجريبية GlobalAssertions. كان الغرض من استخدامها هو إجراء عمليات التحقّق من إمكانية الوصول، لذا استخدِم enableAccessibilityChecks() لهذا الغرض بدلاً من ذلك. (I59322)

الإصدار ‎1.8.0-alpha05

‫30 أكتوبر 2024

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha05. يتضمّن الإصدار 1.8.0-alpha05 هذه التعديلات.

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

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

• لتفعيل ميزة "الملء التلقائي"، اضبط قيمة ComposeUiFlags.isSemanticAutofillEnabled على true في onCreate واستخدِم أحدث إصدار من Compose Snapshot.
• يتيح هذا الإصدار من ميزة "الملء التلقائي" حفظ بيانات الاعتماد يدويًا ومن خلال ميزة "اقتراح كلمة مرور قوية" ومن خلال التنقّل. تتيح هذه الميزة أيضًا التعبئة عندما يركّز المستخدم على حقل يمكن تعبئته تلقائيًا أو عندما يتم تفعيل ميزة "التعبئة التلقائية" من خلال شريط أدوات النص في مكوّنات النص. سيتم تمييز المكوّن للإشارة إلى اكتمال عملية الملء التلقائي.

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

• تعديل واجهة "الملء التلقائي" لتتّبع بنية expect/actual (I22dce)
• إضافة CompositionLocal التي يمكن استخدامها لتعديل درجة لون التمييز الذي يظهر عند نجاح عملية الملء التلقائي (I32092)
• تمت إضافة واجهة برمجة التطبيقات Modifier.onRectChanged، وهي واجهة برمجة تطبيقات تتيح للمستخدم الاشتراك في الموضع والحجم النسبيين للجذر/النافذة/الشاشة في LayoutNode. تحلّ واجهة برمجة التطبيقات العديد من حالات الاستخدام التي يحلّها المعدِّل onGloballyPositioned الحالي، ولكنها تفعل ذلك مع تقليل النفقات العامة بشكل كبير، وتتضمّن واجهة برمجة التطبيقات تسهيلات لإزالة التكرار وتقييد عدد مرات معاودة الاتصال وفقًا لما تتطلبه حالة الاستخدام. (Id28c7 وb/372765423 وb/372757007 وb/372994338)
• توسيع نطاق "مدير الملء التلقائي" ليشمل واجهات برمجة التطبيقات commit() وcancel() التي تساعد المستخدمين في حفظ بيانات الاعتماد التي تم إدخالها حديثًا (I2da00)
• تتضمّن هذه السمة واجهة AutofillManager جديدة يمكن استخدامها لتحسين رحلة المستخدمين في ميزة "الملء التلقائي"، بالإضافة إلى العلامة isSemanticAutofillEnabled لتفعيل هذا الإصدار الجديد من ميزة "الملء التلقائي". (I9d484)
• تمت إضافة واجهة برمجة التطبيقات Modifier.onRectChanged، وهي واجهة برمجة تطبيقات تتيح للمستخدم الاشتراك في الموضع والحجم النسبيين للجذر/النافذة/الشاشة في LayoutNode. تحلّ واجهة برمجة التطبيقات العديد من حالات الاستخدام التي يحلّها المعدِّل onGloballyPositioned الحالي، ولكنها تفعل ذلك مع تقليل النفقات العامة بشكل كبير، وتتضمّن واجهة برمجة التطبيقات تسهيلات لإزالة التكرار وتقييد عدد مرات معاودة الاتصال وفقًا لما تتطلبه حالة الاستخدام. (I3c8fa)
• أضِف السمات الدلالية وأنواع البيانات لتوفير دعم موسّع لميزة "الملء التلقائي". (I52c7d)
• أصبحت جميع الطرق في أداة إنشاء AnnotatedString غير تجريبية الآن (Ia89c8، b/261561823)

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

• يمكن الآن أن تتلقّى طرق العرض المضمّنة في Compose أحداثًا متعلقة بأداة التدوير إذا كانت في وضع التركيز (I4d53a، b/320510084).
• تم إصلاح مشكلة عدم تعديل أنواع الموارد المختلفة عند إجراء تغييرات في الإعدادات (Ia9b99، b/352336694)
• تم حلّ مشكلة كانت تمنع TextField من العمل بشكل صحيح عند استخدام لوحة المفاتيح اليابانية POBox على بعض أجهزة Sony القديمة. (Ia9b99، b/373743376)
• تم إصلاح مشكلة ظهور مربّعات الحوار في أسفل الشاشة بدلاً من توسيطها (Ia2ec، b/373093006)
• لم يعُد استهداف الإصدار 35 من واجهة برمجة التطبيقات أو الإصدارات الأحدث يفرض ضبط قيمة decorFitsSystemWindows على "خطأ" في مربّعات الحوار. (Ibc94، b/364492593)
• تم إصلاح عُطل يحدث عند نقل الطبقات بين النوافذ (مثل مربّع الحوار والمحتوى الرئيسي) (I675ba، b/330955281)

الإصدار ‎1.8.0-alpha04

‫16 أكتوبر 2024

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha04. يتضمّن الإصدار 1.8.0-alpha04 هذه التعديلات.

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

• تتم إضافة عمليات ردّ الاتصال DelegatableNode#onDensityChange وDelegatableNode#onLayoutDirectionChange للسماح بتعديل حالة العُقد عند تغيُّرها (I04f3e، b/340662451)
• تضيف هذه السمة WindowInfo#containerSize لتوفير حجم حاوية المحتوى في النافذة الحالية. يمكن استردادها باستخدام LocalWindowInfo. (Idc38c، b/369334429، b/360343819)
• إصلاح المشكلة المتعلّقة بعناصر قابلة للتمرير متداخلة تتم إزالتها من شجرة العُقد أثناء عملية التمرير السريع الجارية ستلغي هذه العُقد الآن عملية التحريك السريع وسترسل حدث onPostFling بشكل صحيح مع السرعة المتبقية. نقدّم أيضًا العلامة NewNestedScrollFlingDispatchingEnabled للتحكّم في السلوك في حال حدوث تراجعات. ستتم إزالة العلامة قبل الإصدار التجريبي. (I05c37، b/371168883)
• تم تقديم PointerInputModifierNode#touchBoundsExpansion، والذي يمكن استخدامه لتكبير حدود اللمس الخاصة بأداة تعديل إدخال مؤشر واحد. (Iccf02، b/335339283)
• تضيف هذه السمة WindowInfo#containerSize لتوفير حجم حاوية المحتوى في النافذة الحالية. يمكن استردادها باستخدام LocalWindowInfo. (I27767، b/369334429، b/360343819)
• أزِل readOnly من TextFields' لتثبيت الإصدار الأساسي الثابت. (I3aaba)
• تتلقّى الدالتان Paragraph وParagraphIntrinsics الآن قائمة بجميع التعليقات التوضيحية المطبّقة على AnnotatedString، بينما كانت تتلقّى في السابق قائمة بـ SpanStyles فقط (I12f80)

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

• تم تعديل طريقة التعامل مع الفقرات في AnnotatedString. في السابق، كان بإمكانك إنشاء فقرات غير متداخلة فقط. أصبح AnnotatedString يتيح الآن الفقرات المتداخلة بالكامل والتي سيتم دمجها معًا، والفقرات المتداخلة التي سيتم تقسيم الفقرة الخارجية فيها على حدود الفقرة الداخلية، وسيتم دمج نمط الفقرة الداخلية مع نمط الفقرة الخارجية (Ic9554)
• إصلاح عُطل في AnnotatedString مع LinkAnnotation بطول صفر (89aac6)

الإصدار ‎1.8.0-alpha03

‫2 أكتوبر 2024

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha03. يتضمّن الإصدار 1.8.0-alpha03 هذه التعديلات.

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

• تحديث إصدار Kotlin إلى 1.9 (I1a14c)
• تم تقديم دور دلالي جديد باسم "لوحة عرض دوّارة" لمحاكاة سلوك القائمة في أدوات "التنقل بين الصفحات" لخدمات تسهيل الاستخدام. (Id354b، b/354109776، b/239672673)
• تمّت إعادة تسمية invisibleToUser() إلى hideFromAccessibility. وستبقى وظيفتها كما هي. يمكنك الاطّلاع على المستندات لمزيد من التفاصيل. (Ib43a3)

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

• تعديل المستندات الخاصة بأداة التعديل SensitiveContent (Ib0442)
• تم إصلاح المشكلة التي يتم فيها تجاهل مقاطع موجزة عامة معيّنة عند دمجها مع ظلال الارتفاع في بعض إصدارات Android
• تم إصلاح المشكلة التي كانت تؤدي إلى تطبيق مقاطع فارغة عند تحديد مقاطع عامة ذات حدود خارجية على إصدارات معيّنة من Android.
• تم إصلاح الخطأ الذي يحدث عندما يكون محرر أسلوب الإدخال (IME) نشطًا في "عرض" خارجي ويتم استخدام الإجراء "التالي" لتحديد التركيز على ComposeView. يتوافق سلوك clearFocus() مع سلوك View في الإصدارات الأقدم من 28 من واجهة برمجة التطبيقات، حيث يمكن أن يؤدي clearFocus() إلى التركيز على طريقة العرض التلقائية.
• تم إصلاح مشكلة ظهور موضع الإعلان على عُقد منفصلة في LazyList من خلال فصل إدارة التركيب الفرعي عن عمليات التنسيق المختلفة.
• تم إصلاح مشكلة كانت تتسبب في وميض لوحة المفاتيح على الشاشة عند التبديل من TextField إلى EditText أو أي محرر آخر مستند إلى طريقة العرض.
• سترسل الآن عقد Nested Scroll أحداث onPostFling بشكل صحيح بعد فصلها.
• تحسينات عامة على الأداء

الإصدار ‎1.8.0-alpha02

‫18 سبتمبر 2024

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha02. يتضمّن الإصدار 1.8.0-alpha02 هذه التعديلات.

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

• يتوفّر الآن الرمز TextOverflow.StartEllipsis والرمز TextOverflow.MiddleEllipsis اللذان يتيحان وضع علامات الحذف في بداية سطر النص الفردي أو وسطه. (I38913، b/185418980)

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

• إصلاح Dalog dismissOnClickoutside (39a3d وb/364508685)
• عدم قصّ ظلال محتوى الحوار (e8e2f، b/363027803)
• إصلاح السلوك الخاطئ عند انتقال البحث المركّز بين Compose وView (58377، b/350534714)

المساهمة الخارجية

• يقبل AlignmentLines Map الآن النوعَين المحددين VerticalAlignmentLine أو HorizontalAlignmentLine. (I02912)
• طريقة ByteArray.decodeToImageBitmap(): ImageBitmap شائعة جديدة (I83c21)

الإصدار ‎1.8.0-alpha01

‫4 سبتمبر 2024

تم طرح androidx.compose.ui:ui-*:1.8.0-alpha01. يتضمّن الإصدار 1.8.0-alpha01 هذه التعديلات.

الإصدار 1.7

الإصدار 1.7.8

‫12 فبراير 2025

تم طرح androidx.compose.ui:ui-*:1.7.8. يتضمّن الإصدار 1.7.8 هذه التعديلات.

الإصدار 1.7.7

‫29 يناير 2025

تم طرح androidx.compose.ui:ui-*:1.7.7. يتضمّن الإصدار 1.7.7 هذه التعديلات.

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

• تم إصلاح الخطأ IndexOutOfBoundsException عند تمرير AnnotatedString مع LinkAnnotation إلى العنصر القابل للإنشاء Text. (Ic96d2)
• تم إصلاح مشكلة انتهاء المهلة في الاختبارات في بعض الحالات النادرة عند استخدام LinkAnnotation في AnnotatedString. (I04a03)

الإصدار 1.7.6

‫11 ديسمبر 2024

تم طرح androidx.compose.ui:ui-*:1.7.6. يتضمّن الإصدار 1.7.6 هذه التعديلات.

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

• كنّا في السابق نطرح خطأً كلّما صادفنا حدثًا رئيسيًا عندما كان نظام التركيز يتضمّن عمليات إبطال معلّقة. نحن الآن نسجّل خطأً بدلاً من ذلك (I7ea0، b/346370327).
• تمت إزالة التعليق التوضيحي التجريبي من SemanticsPropertyReceiver.invisibleToUser(). سيتم إيقاف هذا الحقل نهائيًا في الإصدار 1.8 واستبداله بالحقل SemanticsPropertyReceiver.hideFromAccessibility(). (I448f0، b/376479686)
• تم إصلاح مشكلة كانت تمنع TextField من العمل بشكل صحيح عند استخدام لوحة مفاتيح POBox اليابانية على بعض أجهزة Sony القديمة. (I94e0e، b/373743376)
• تم إصلاح مشكلة تسهيل الاستخدام التي لم يتم فيها الإعلان عن BasicText’s inlineContent بواسطة TalkBack. (I67bcb، b/376479686)

الإصدار 1.7.5

‫30 أكتوبر 2024

تم طرح androidx.compose.ui:ui-*:1.7.5. يتضمّن الإصدار 1.7.5 هذه التعديلات.

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

• تم إصلاح المشاكل التي تمنع عرض الارتفاع والقص بشكلٍ صحيح باستخدام المخططات التفصيلية المخصّصة.
• تم إصلاح مشكلة تعطُّل النص التي تحدث مع LinkAnnotation بعرض صفر. (Ic1e2e)
• إصلاح إشعار في Talkback الزر عند إنشائه كعنصر Text قابل للنقر (I1f588)

الإصدار 1.7.4

‫16 أكتوبر 2024

تم طرح androidx.compose.ui:ui-*:1.7.4. يتضمّن الإصدار 1.7.4 هذه التعديلات.

الإصدار 1.7.3

‫2 أكتوبر 2024

تم طرح androidx.compose.ui:ui-*:1.7.3. يتضمّن الإصدار 1.7.3 هذه التعديلات.

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

• تم إصلاح مشكلة تؤدي إلى ظهور حدود مقطع فارغة عند تحديد مقطع عام على بعض إصدارات Android.
• تم إصلاح الخطأ الذي يحدث عندما يكون محرر أسلوب الإدخال (IME) نشطًا في "عرض" خارجي ويتم استخدام الإجراء "التالي" لتحديد التركيز على ComposeView. يتوافق سلوك clearFocus() مع سلوك View في الإصدارات الأقدم من 28 من واجهة برمجة التطبيقات، حيث يمكن أن يؤدي clearFocus() إلى التركيز على طريقة العرض التلقائية.
• تم إصلاح مشكلة استخدام placeOrder غير صحيح لإبطال صحة البحث المسبق، وبالتالي تم إصلاح حالة حدية تم فيها تخطّي موضع البحث المسبق.

الإصدار 1.7.2

‫18 سبتمبر 2024

تم طرح androidx.compose.ui:ui-*:1.7.2. يتضمّن الإصدار 1.7.2 هذه التعديلات.

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

• تحسين أداء معلومات عقدة تسهيل الاستخدام وأحداث الدلالات من خلال إزالة التتبُّع المطوّل (I89156، b/362530618)
• لن يتعطّل ComposeView بعد الآن عند تمرير حجم قياس كبير بشكل استثنائي (da5db، b/347036173)
• تم إصلاح مشكلة في إمكانية الوصول إلى برامج قراءة الشاشة حيث لم يتم إصدار إشعارات LiveRegion على الأزرار. (f66fa7، b/348590026)

الإصدار 1.7.1

‫10 سبتمبر 2024

• لم يتم إجراء أي تغييرات على عناصر Android. تمت إزالة -desktop من العناصر، وتمت إضافة -jvmStubs و-linuxx64Stubs من العناصر. لا يُفترض استخدام أي من هذه الاستهدافات، بل هي عناصر نائبة للمساعدة في جهود Jetbrains Compose.

الإصدار 1.7.0

‫4 سبتمبر 2024

تم طرح androidx.compose.ui:ui-*:1.7.0.

التغييرات المهمة منذ الإصدار 1.6.0

يمكنك الاطّلاع على التغييرات المهمة في الإصدار 1.7.0 في مشاركة المدونة هذه.

الإصدار ‎1.7.0-rc01

‫21 أغسطس 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-rc01. يتضمّن الإصدار 1.7.0-rc01 هذه التعديلات.

التغييرات البارزة

• يفرض الآن الوحدة ui:ui شرط توفّر الإصدار 1.7.0-rc01 أو إصدار أحدث من foundation:foundation كحدّ أدنى. يتم فرض ذلك لمعالجة عدم توافق السلوك بين واجهة المستخدم وFoundation في ما يتعلق بتغييرات NestedScrollSource التي حدثت في وقت مبكر أثناء الإصدار 1.7.0-alpha01.

الإصدار ‎1.7.0-beta07

‫7 أغسطس 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-beta07. يتضمّن الإصدار 1.7.0-beta07 هذه التعديلات.

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

• ستعرض الآن دوال إدخال النص ذات الصلة SemanticsNodeInteraction performTextReplacement وperformTextInput وperformTextClearance أخطاء تأكيد عند طلبها في TextFields للقراءة فقط. (I4ae8f)

الإصدار ‎1.7.0-beta06

‫24 يوليو 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-beta06. يتضمّن الإصدار 1.7.0-beta06 هذه التعديلات.

الإصدار ‎1.7.0-beta05

‫10 يوليو 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-beta05. يتضمّن الإصدار 1.7.0-beta05 هذه التعديلات.

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

• تم إصلاح الخلل الذي كان يؤدي إلى عدم قبول TextField للإدخال من لوحة المفاتيح الافتراضية الجديدة إلى أن يتم فقدان التركيز واستعادته عند تغيير لوحة المفاتيح الافتراضية.
• تم إصلاح مشكلة كانت تؤدي فيها محاولات الاحتفاظ بمحتوى الطبقة إلى حدوث آثار جانبية غير مقصودة عند العرض باستخدام محتوى SurfaceView.

الإصدار ‎1.7.0-beta04

‫26 يونيو 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-beta04. يتضمّن الإصدار 1.7.0-beta04 هذه التعديلات.

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

• تجنُّب الأعطال عند قياس أسطر نصية كبيرة جدًا (مثل 10 آلاف حرف) (8157ab)
• أوقِف إمكانية عرض البرامج لواجهة برمجة التطبيقات GraphicsLayer. (35ddd8)
• إصلاح عُطل في منطق استمرار الطبقة (70b13e)
• تم التراجع عن تحسين إعادة استخدام عناصر الطبقة، لأنّها تسبّبت في مشاكل في العرض. (70b13e)

الإصدار ‎1.7.0-beta03

‫12 يونيو 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-beta03. يتضمّن الإصدار 1.7.0-beta03 هذه التعديلات.

الإصدار ‎1.7.0-beta02

‫29 مايو 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-beta02. يتضمّن الإصدار 1.7.0-beta02 هذه التعديلات.

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

• تمت إعادة تسمية SemanticsProperties.Editable إلى IsEditable وتغيير SemanticsPropertyReceiver.editable إلى القيمة isEditable. أصبحت السمة الآن قيمة منطقية ويتم تحديدها دائمًا من خلال حقول النص. (I8acd8)
• إعادة تسمية مَعلمة قياس أداء تسهيل الاستخدام (I3d440)
• تم تعديل واجهة برمجة التطبيقات لتصميم الروابط: أصبح TextLinkStyles الآن جزءًا من الدالة الإنشائية LinkAnnotation والطريقة AnnotatedString.fromHtml (I90b2b). تمت أيضًا إزالة TextDefaults من المادة (I5477b)

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

• تمت إعادة تسمية LayoutCoordinates.introducesFrameOfReference إلى LayoutCoordinates.introducesMotionFrameOfReference لتعكس الغرض منها بشكل أفضل. تمت إعادة تسمية الدالة ذات الصلة لحساب الإحداثيات استنادًا إلى هذا العَلَم. (I3a330)

الإصدار ‎1.7.0-beta01

‫14 مايو 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-beta01. يتضمّن الإصدار 1.7.0-beta01 هذه التعديلات.

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

• تمت إعادة تسمية "performCustomAccessibilityActionLabelled" إلى "performCustomAccessibilityActionWithLabel" و"performCustomAccessibilityActionWhere" إلى "performCustomAccessibilityActionWithLabelMatching". (I5387f)
• ‫"AnnotatedString.hasEqualsAnnotations" أصبح الآن "hasEqualAnnotations" (I685c0)
• تم تعديل واجهة برمجة التطبيقات للحصول على روابط متوافقة مع تصميم Material في النص. على وجه التحديد، تمت إزالة الطرق من TextDefaults لإنشاء LinkAnnotations ذات سمات وتحليل HTML باستخدام روابط ذات سمات. بدلاً من ذلك، تمت إضافة فئة TextLinkStyles تتيح تصميم الروابط كمَعلمة إلى عنصر Text القابل للإنشاء. (I31b93)

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

• إصلاح حالات استخدام إضافية عند إضافة معدِّلات إدخال المؤشر ديناميكيًا أثناء الأحداث 63e1504

الإصدار ‎1.7.0-alpha08

‫1 مايو 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha08. يتضمّن الإصدار 1.7.0-alpha08 هذه التعديلات.

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

• تضيف هذه السمة إمكانية استخدام عمليات تنفيذ الأشكال القابلة للتغيير. يمكن الآن ملاحظة Shape#createOutline داخل طبقات الرسومات، لذا ستؤدي قراءة قيم الحالة داخلها إلى إبطالها عند تغيُّر الحالة، ما يتيح إنشاء رسوم متحركة أكثر فعالية للأشكال. (Id1629، b/326070216)
• تمت إعادة تسمية isPositionedByParentWithDirectManipulation إلى introducesFrameOfReference. يُرجى العِلم أنّ هذا الإعداد أصبح له تأثير معاكس، ما يعني أنّه بشكلٍ تلقائي، تقدّم معظم LayoutCoordinates إطارًا مرجعيًا، ولن تكون السمة خطأ إلا عند وضعها تحت التلاعب المباشر. للاستعلام عن الموضع باستخدام العناصر التي تقدّم إطارًا مرجعيًا فقط، استخدِم positionInLocalFrameOfReference(...). أو positionInLocalLookaheadFrameOfReference من LookaheadScope (Ifc5f7)
• LookaheadScope تم توفير واجهات برمجة التطبيقات بشكل ثابت (I21507)
• تغيير دالة lambda للإجراء getScrollViewportLength وفقًا لملاحظات مجلس API. (Ibc74a)
• تم تعديل واجهات برمجة التطبيقات الخاصة بمخطط GraphicsLayer لاستخدام مَعلمات ذات قيمة عشرية بدلاً من مَعلمات ذات قيمة عدد صحيح. تمت إزالة قيم UnsetOffset/UnsetSize IntSize الخاصة بالقيم الحدّية لصالح الثوابت غير المحدّدة المتوفّرة حاليًا في الفئات المضمّنة الخاصة بالإزاحة والحجم المستندة إلى القيم العشرية (I2fb03 وb/333863462).
• عند إدخال بيانات الماوس أثناء الاختبارات، تقبل الآن MouseInjectionScope.click() وMouseInjectionScope.doubleClick() وMouseInjectionScope.tripleClick() وMouseInjectionScope.longClick() المَعلمة button: MouseButton لجعلها أكثر قابلية للتطبيق على نطاق واسع. القيمة التلقائية هي MouseButton.Primary لجميع الطرق. (I31a23، b/190493367، b/261439695)
• تمت إعادة تسمية onClicked إلى onClick داخل LinkInteractionListener. (Iaa35c)
• تمّت إعادة تسمية TextInclusionStrategy.isInside إلى isIncluded. اجعل نوع القيمة التي تم إرجاعها في Paragraph/MultiParagraph#getRangeForRect() غير قابل لأن يكون فارغًا. (I51f26)

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

• تم إصلاح مشكلة التقاط لقطة شاشة طويلة للحاويات التي يمكن التمرير فيها باستخدام reverseScrolling=true. (I7c59c)

المساهمة الخارجية

• تمت إضافة إمكانية جلب العناصر مسبقًا في LazyLists المتداخلة (مثل LazyColumn يعرض LazyRows متداخلة). من المتوقّع أن يقلّل هذا التغيير من انخفاض عدد اللقطات في الثانية أثناء التمرير في LazyLists هذه. الإعداد التلقائي للتنفيذ هو الجلب المسبق لأول عنصرَين متداخلَين، ولكن يمكن التحكّم في هذا السلوك من خلال واجهتَي برمجة التطبيقات الجديدتَين LazyLayoutPrefetchStrategy(nestedPrefetchItemCount) وLazyListPrefetchStrategy#onNestedPrefetch. (I51952)

الإصدار ‎1.7.0-alpha07

‫17 أبريل 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha07. يتضمّن الإصدار 1.7.0-alpha07 هذه التعديلات.

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

• تم وضع علامة "متوقّف نهائيًا" على ClickableText. لإضافة روابط إلى النص، أنشئ AnnotatedString مع LinkAnnotation يتوافق مع الرابط، ثم مرِّر AnnotatedString إلى العنصر القابل للإنشاء Text. (I34d4b، b/323346994)
• إضافة ViewConfiguration.HandwritingGestureLineMargin لإيماءات الكتابة بخط اليد إتاحة إيماءة JoinOrSplit في BasicTextField (Ie6e13، b/325660505)
• لم يعُد FocusProperties.enter وFocusProperties.exit ميزتَين تجريبيتَين. لم يعُد FocusDirection.Enter وFocusDirection.Exit ميزتَين تجريبيتَين. لم يعُد FocusRequester.Cancel تجريبيًا (I461a1، b/261564106)
• عند طلب إحداثيات Layout، يمكنك الآن استخدام الوسيطة excludeDirectManipulationOffset لاستبعاد الإزاحة التي تم ضبطها بواسطة Layouts الرئيسية التي وضعت العناصر التابعة لها باستخدام Placeable.PlacementScope.withDirectManipulationPlacement. وبالمثل، قد يضع الآن Layout العناصر التابعة له التي تغيّر موضعها بشكل متكرر باستخدام withDirectManipulationPlacement (مثل Scroll، الذي يتم تنفيذه تلقائيًا). يساعد ذلك في جعل الصور المتحركة المستندة إلى approachLayout أكثر سهولة في الاستخدام، إذ يمكن الآن التمييز بين الإزاحة التي سيتم تحريكها والإزاحة التي سيتم تطبيقها مباشرةً عند اتّخاذ قرار بتحريك طريقة العرض. (I60ec7)
• تمت إزالة علامة الميزة الخاصة بلقطات الشاشة الطويلة. (I28648، b/329128246)
• ستعرض LazyColumn الآن العناوين الثابتة بشكل صحيح في لقطات الشاشة الطويلة. (I8d239، b/329296635)
• سيتم استبدال مصدري السحب والإفلات (Drag and Fling) في NestedScroll بمصدري UserInput وSideEffect لاستيعاب التعريف الموسّع لهذين المصدرين الذي يتضمّن الآن الصور المتحركة (Side Effect) وعجلة الماوس ولوحة المفاتيح (UserInput). (I40579)
• أصبح الرمزان ApproachLayoutModifierNode وModifier.approachLayout ثابتَين الآن، وتمت إضافة الرمزين الجديدين isMeasurementApproachInProgress() وisPlacementApproachInProgress() ليحلا محل الرمزين القديمين isMeasurementApproachComplete() وisPlacementApproachComplete() على التوالي.
• تمت إزالة المبدّل intermediateLayout المتوقّف نهائيًا. (I3e91c)
• أعِد تسمية GraphicsLayer#buildLayer إلى record لتعكس طريقتَي begin/endRecording لواجهات برمجة التطبيقات المستندة إلى Displaylist، مثل RenderNode وPicture.
• تم تعديل rememberGraphicsLayer للاستفادة من rememberObserver. (I312c1، b/288494724، b/330758155)
• تم إيقاف UrlAnnotation نهائيًا، لذا يُرجى استخدام LinkAnnotation.Url بدلاً منها. إذا كنت تستخدم Material theming، استخدِم العنصر TextDefaults لإنشاء التعليق التوضيحي مع تطبيق Material theming عليه (I8d180، b/323346545).
• تمت إضافة خيار تنسيق حالة الضغط إلى الروابط النصية، بالإضافة إلى التنسيق العادي وتنسيقَي التمرير والتركيز (I5f864 وb/139312671).
• تمت إعادة تسمية String.parseAsHtml إلى AnnotatedString.Companion.fromHtml. (I43dcd)
• تمت إضافة وسيطات التنسيق (linkStyle وfocusedLinkStyle وhoveredLinkStyle) وأداة معالجة تفاعلات الروابط إلى الطريقة parseAsHtml. عند تحليل السلسلة الموسومة بتنسيق HTML باستخدام علامات <a>، ستنشئ الطريقة LinkAnnotation.Url لكل علامة من هذا النوع وتمرّر عناصر التصميم ومستمع التفاعل مع الروابط إلى كل تعليق توضيحي. (I7c977)
• تتلقّى LinkAnnotation الآن وسيطات التنسيق المستندة إلى الحالة وLinkInteractionListener. أضِف هذا التعليق التوضيحي إلى AnnotatedString للحصول على رابط تشعّبي. من خلال تمرير focusedState و/أو hoveredState، يمكنك تحديد configuration المرئي للروابط عند التركيز عليها و/أو تمرير مؤشر الماوس فوقها. (I81ce4، b/139312671)
• لم يعُد الحقل "ImeOptions.hintLocales" يقبل القيمة الخالية. إذا أردت تمرير قائمة Locale فارغة، يُرجى استخدام LocaleList.Empty. (Ic5bc4)

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

• التعامل بشكل سليم مع بيانات أحداث الإدخال السابقة غير الصالحة أو التالفة (تجاهل بيانات الإزاحة غير الصالحة)
• إصلاح أحداث المؤشر غير المتوقّعة عند إضافة أداة تعديل إدخال المؤشر بشكل ديناميكي قبل أداة تعديل إدخال مؤشر أخرى أثناء بث حدث إدخال مؤشر نشط (على سبيل المثال، بين حدثَي "المرور فوق العنصر" و"الخروج من العنصر" [الماوس/القلم]).

الإصدار 1.7.0-alpha06

‫3 أبريل 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha06. يتضمّن الإصدار 1.7.0-alpha06 هذه التعديلات.

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

• تمت إضافة طريقة parseAsHtml للسلاسل ذات الأنماط: تتيح هذه الطريقة تحويل سلسلة مميّزة بعلامات HTML إلى AnnotatedString. يُرجى العِلم أنّ بعض العلامات غير متوافقة، على سبيل المثال، لن تتمكّن بعد من عرض قوائم نقطية. (I84d3d، I30626، b/139326648)
• تمّت إضافة دعم تجريبي للقطات الشاشة الطويلة في حاويات التمرير في Compose باستخدام واجهة برمجة التطبيقات الرسمية لنظام التشغيل Android (ScrollCaptureCallback). هذه الميزة تجريبية وقد لا تتعامل حاليًا مع جميع الحالات بشكل صحيح. لهذا السبب، يتم إيقافها تلقائيًا في الوقت الحالي. للموافقة على هذه الميزة، اضبط العلامة ComposeFeatureFlag_LongScreenshotsEnabled على "صحيح". (I2b055، b/329296471)

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

• تم تغيير fun ClipEntry.getMetadata() إلى val ClipEntry.clipMetadata. (I50155)
• تمت إزالة الدالتَين ClipboardManager.getClipMetadata وClipboardManager.hasClip. يُرجى استخدام clipEntry.getMetadata() لقراءة البيانات الوصفية الخاصة بإدخال المقطع الحالي. تحقَّق أيضًا من نتيجة ClipboardManager.getClip لمعرفة ما إذا كانت فارغة أم لا، وذلك لمعرفة ما إذا كانت "الحافظة" تتضمّن مقطعًا حاليًا. (I50498)
• يمكنك الآن تمرير عناصر GraphicsLayer إلى دوال placeable.placeWithLayer() (I1b22f)
• يقبل ClipboardManager.setClip الآن القيمة الخالية لتتمكّن من محو الحافظة. (I7d2e9)
• تمت إضافة أرقام تعريف الموارد للمساعدة في إخفاء طرق العرض المستخدَمة كتفاصيل التنفيذ ضمن أدوات الإنشاء (I99531)
• تمت إضافة طريقة تعليق GraphicsLayer#toImageBitmap للسماح بعرض محتويات صورة نقطية في GraphicsLayer. هذه عملية عرض يتم تسريعها من خلال الأجهزة على مستوى واجهة برمجة التطبيقات 22 أو أعلى (شاملة)، وتتوافق مع أكثر من% 99 من جميع أجهزة Android. في المستوى 21 من واجهة برمجة تطبيقات Android، يتم الرجوع إلى العرض البرمجي. (I9e114)
• طريقة مساعدة لتحويل RectF في Android إلى ComposeRect (I39925، b/325660505)
• تحتوي جميع المَعلمات KeyboardOptions الآن على قيمة غير محدّدة تلقائيًا. تمّت إضافة طريقة KeyboardOptions.merge.
• تمت إعادة تسمية KeyboardOptions.autoCorrect إلى autoCorrectEnabled وتم السماح بقيمة فارغة، حيث تشير القيمة الفارغة إلى عدم تحديد أي قيمة. (Ia8ba0، b/295951492)
• يستخدم المتغيران BasicTextField(state) وBasicSecureTextField الآن KeyboardActionHandler بدلاً من KeyboardActions لمعالجة الإجراءات التي يتم اتخاذها باستخدام لوحة مفاتيح افتراضية. (I58dda)

الإصدار ‎1.7.0-alpha05

‫20 مارس 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha05. يتضمّن الإصدار 1.7.0-alpha05 هذه التعديلات.

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

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

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

• لم يعُد GraphicsLayer.draw(Canvas) واجهة برمجة تطبيقات متاحة للجميع. يُرجى استخدام دالة الإضافة DrawScope.drawLayer(GraphicsLayer) بدلاً من ذلك لرسم الطبقة. (I7a7c0)
• تقسيم restrictedConstraints() إلى طريقتَين: fitPrioritizingWidth() وfitPrioritizingHeight() (I6d7fd)
• تمت إضافة عنصر نائب HardwareCanvas لاستخدامه في Android L (I1c3b5، b/288494724)
• تعديل إطار عمل Compose لعرض GraphicsContext composition local بالإضافة إلى تعديل عمليات تنفيذ Owner وDelegateableNode وdrawWithCache Modifier لعرض إذن الوصول إلى GraphicsContext من أجل الوصول المحدود النطاق الذي سيؤدي تلقائيًا إلى تنظيف مثيلات GraphicsLayer عند إيقاف Modifiers. (I64a2f، b/288494724)
• تم تقديم InterceptPlatformTextInput للمساعدة في كتابة اختبارات منخفضة المستوى ذات صلة بمحرّك طريقة الإدخال (IME) وحالات استخدام أخرى منخفضة المستوى لمحرّك طريقة الإدخال. تم إيقاف PlatformTextInputTestOverride نهائيًا. (I862ed، b/322680547)
• تمت إضافة دالة الإضافة GraphicsLayer.setOutline(Outline). (Ib81f4)
• إضافة أداة إنشاء الدالة GraphicsContext لإنشاء مصنع لإنشاء مثيلات GraphicsLayer (Ib98d6، b/288494724)
• تم توفير واجهة برمجة التطبيقات GraphicsLayer لمنح المطوّرين مرونة محدّدة في تسجيل أوامر الرسم التي يمكن استخدامها للرسم في مكان آخر، بالإضافة إلى تطبيق مؤثرات مرئية مختلفة على النتيجة النهائية. (I80245، b/288494724)
• قدِّم الدالة Paragraph#getRangeForRect التي تعرض نطاقًا من النص الذي تغطيه مساحة مستطيلة معيّنة. (Iee516، b/325660505)
• تمت إزالة الإعداد التجريبي التلقائي لـ BasicText باستخدام الوسيطة onLinkClicked. وسيتم توفير واجهة برمجة تطبيقات بديلة لدعم الروابط التشعبية في المستقبل. (I107d5)

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

• تمت إضافة تعريف واجهة برمجة التطبيقات GraphicsLayer expect/actual لإتاحة تسجيل أو إعادة تشغيل أوامر الرسم مع تأثيرات مرئية اختيارية للتركيب والتحويلات. تقديم واجهة GraphicsContext لاحتواء تبعيات الرسومات، بما في ذلك إنشاء وإدارة مثيلات GraphicsLayer (I4a8d6، b/288494724)
• تم إصلاح مشكلة عدم توافق مع البحث عن التركيز الأحادي الأبعاد، حيث كان التركيز يتعذّر الخروج من ComposeView مضمّن بين طرق عرض أخرى. (I08fd4)

المساهمة الخارجية

• تم نقل LocalLifecycleOwner من واجهة مستخدم Compose إلى lifecycle-runtime-compose حتى يمكن استخدام واجهات برمجة التطبيقات المساعدة المستندة إلى Compose خارج واجهة مستخدم Compose. نشكر "جيك وارتون" على مساهمته. (I6c41b، b/328263448)
• عرض خصائص الانحياز العائم باستمرار على جميع الأنواع الفرعية للمحاذاة المستندة إلى الانحياز (I69f0f، b/328088992)

الإصدار ‎1.7.0-alpha04

‫6 آذار (مارس) 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha04. يتضمّن الإصدار 1.7.0-alpha04 هذه التعديلات.

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

• إتاحة ميزة الكتابة بخط اليد باستخدام قلم الشاشة في BasicTextField2 على الأجهزة التي تعمل بالإصدارات الأحدث من Android 14 (I002e4)
• في هذا التغيير، نضيف الإجراء الدلالي GetScrollViewportLength حتى نتمكّن من نقل معلومات حول المكوّنات التي يتم التمرير فيها في Compose إلى نظام تسهيل الاستخدام. ينطبق هذا التغيير أيضًا على استخدام السمة المذكورة في "قوائم Foundation القابلة للتمرير". (Ic5fa2)
• أصبحت FocusRequester.createRefs الآن إصدارًا ثابتًا (I4d92c، b/261436820)
• تمت إضافة DelegatableNode.requireView() للسماح لعُقد المعدِّلات بالحصول على View الحالي لنظام التشغيل Android بدون قراءة التركيبة المحلية. (I40768)
• واجهة برمجة التطبيقات الجديدة Path.reverse() لعكس اتجاه المسار (I36348)
• تمت إضافة hintLocales إلى KeyboardOptions لتزويد TextFields بإمكانية إرسال تلميحات إلى محرّرات طرق الإدخال (IME) باستخدام إعدادات محلية معيّنة لضبط لغة مفضّلة مسبقًا.
• عرض السمة platformLocale من Locale التي تعرض عنصر المنصة الأساسي، مثل java.util.Locale (I921c6)

الإصدار ‎1.7.0-alpha03

‫21 فبراير 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha03. يتضمّن الإصدار 1.7.0-alpha03 هذه التعديلات.

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

• نقدّم لك ContextualFlowRow وFlowRow/Column المحسّنة مع MaxLines وOverflow. يسرّنا الإعلان عن تحسينات على FlowRow وFlowColumn التجريبيَين، إذ أصبحا يتضمّنان الآن ميزة maxLines وإمكانية التعامل مع المحتوى الزائد، بالإضافة إلى طرح ContextualFlowRow وContextualFlowColumn لأول مرة. تم تصميم هذا التحديث لتوفير مكوّنات ذات أداء مثالي، حيث إنّ ContextualFlow* مثالية لعدد كبير من العناصر التي تستخدم إعدادات maxLines صغيرة وأزرار ديناميكية +N "عرض المزيد"، بينما FlowRow وFlowColumn مثاليتان لعدد صغير من العناصر، أي أقل من 100 عنصر. ملاحظة مهمة: للحفاظ على السلوك الحالي في FlowRow أو FlowColumn حيث يتم إنشاء جميع العناصر بغض النظر عمّا إذا كانت تتناسب مع الحد الأقصى للمحور المتقاطع، اضبط overflow على FlowRowOverflow.Visible أو FlowColumnOverflow.Visible أثناء عملية التهيئة. يمكنك الاطّلاع على ContextualFlowRowSample وFlowRowSample للحصول على أمثلة على هذه الميزات الجديدة أثناء عملها. (Ib9135، b/293577082)
• أضِف السمة الدلالية maxTextLength التي يجب ضبطها في الحقول النصية التي تفلتر الحد الأقصى المسموح به لعدد الأحرف. (I24d9f، b/170648072)
• تم إيقاف وحدة التغليف Modifier.inspectable نهائيًا. ستؤدي واجهة برمجة التطبيقات هذه إلى إبطال المعدِّل أكثر من اللازم، لذا لا يُنصح باستخدامها الآن. ننصح المطوّرين بتنفيذ طريقة inspectableProperties() على ModifierNodeElement إذا كانوا يريدون عرض خصائص المعدِّل للأدوات. (Ib3236)
• دالة إنشاء جديدة للنوع PopupProperties تتيح التحكّم الكامل في علامات WindowManager.LayoutParams. (Ibb33e، b/312485503)
• تم تقديم DelegatableNode.requireLayoutCoordinates() كطريقة للحصول على LayoutCoordinates الحالي الخاص بـ Modifier.Node بدون الحاجة إلى إلغاء onPlaced وتخزين الإحداثيات في خاصية بنفسك. (Ia8657)
• تم تقديم DelegatableNode.currentLayoutCoordinates كطريقة للحصول على LayoutCoordinates الحالي الخاص بـ Modifier.Node بدون الحاجة إلى إلغاء onPlaced وتخزين الإحداثيات في خاصية بنفسك. (Iaebaa)
• تم نقل واجهة برمجة التطبيقات BasicTextField2 وواجهات برمجة التطبيقات ذات الصلة ضمن حزمة androidx.compose.foundation.text2 إلى androidx.compose.foundation.text. (I9f635)
• تمت إضافة واجهة برمجة تطبيقات جديدة ApproachLayoutModifierNode لدعم إنشاء منطق أسلوب مخصّص في "عقدة معدِّل" صريحة. تم أيضًا إضافة واجهة برمجة تطبيقات تجريبية جديدة DeferredTargetAnimation للرسوم المتحركة التي يكون هدفها غير معروف عند إنشاء مثيل. (I60745)
• واجهات برمجة تطبيقات Path جديدة للاستعلام عن اتجاه مسار واستخراج خطوط كفاف من Path (I63d04)
• تمت إضافة PathHitTest وPath.contains(Offset) للتحقّق مما إذا كان Path يحتوي على نقطة معيّنة. (I3b218)
• تعرض السمة TextLayoutResult الآن الطريقة getLineBaseline(lineIndex). يتيح ذلك قراءة خط الأساس لأي سطر من النص بالإضافة إلى سمات الملاءمة الحالية firstBaseline وlastBaseline. (Ide4e8، b/237428541)
• تمت إضافة طريقة لمقارنة التعليقات التوضيحية لاثنتين من AnnotatedStrings فقط. (I32659)

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

• تم إصلاح مشكلة في التوافق مع الإصدارات القديمة من SemanticsPropertyReceiver.performImeAction وSemanticsActions.PerformImeAction. (Id0528، b/322269946)

الإصدار ‎1.7.0-alpha02

‫7 فبراير 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha02. يتضمّن الإصدار 1.7.0-alpha02 هذه التعديلات.

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

• تم إصلاح مشكلة في توافق الرمز الثنائي مع SemanticsPropertyReceiver.performImeAction. (I65865، b/322269946)
• لم يعُد منشئ PopupProperties الذي يأخذ المَعلمة usePlatformDefaultWidth تجريبيًا. (I8f8d2)
• تمت إضافة حمولة زائدة من ComposeTestRule.waitUntil تأخذ وصفًا نصيًا للحالة المطلوب تضمينها في رسالة المهلة. (I9413e)
• واجهة برمجة تطبيقات جديدة للدلالات unset() لإزالة خصائص الدلالات التي تتم إضافتها في سلسلة المعدِّل نفسها سمة دلالية جديدة isOpaque (I8c583، b/317966058، b/246056649)
• تمت إزالة originalEventPosition من طريقة النسخ في واجهة برمجة التطبيقات العامة الخاصة بـ PointerInputChange. (I7bead)

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

• تم إصلاح خطأ في إمكانية الوصول كان يسمح بالنقر على عناصر غير علامات التبويب وأزرار الاختيار عند تحديدها. (I2181c)
• سيتم الآن إصلاح المشكلة المتعلقة بإضافة النقاط تلقائيًا في الإصدار VelocityTracker. يمكنك إيقاف الإصلاح من خلال ضبط VelocityTrackerAddPointsFix على "خطأ" في حال حدوث أي مشاكل. (Ib3877، b/269487059)
• تم إصلاح عدم التوافق الثنائي مع الإصدارات القديمة في TextStyle وParagraphStyle. (I179f0، b/320819734)

المساهمة الخارجية

• تمت إضافة أداة إنشاء DialogProperties جديدة بدون مَعلمات خاصة بالنظام الأساسي. (I45829)
• تمت إضافة أداة إنشاء PopupProperties جديدة بدون مَعلمات خاصة بالنظام الأساسي. (I9a038)

الإصدار 1.7.0-alpha01

‫24 يناير 2024

تم طرح androidx.compose.ui:ui-*:1.7.0-alpha01. يتضمّن الإصدار 1.7.0-alpha01 هذه التعديلات.

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

• تم توسيع ClipboardManager من خلال إضافة ClipEntry وClipMetadata لدعم المحتوى العشوائي، مثل الصور.
• تضيف واجهة برمجة التطبيقات DeviceConfigurationOverride إلى ui-test للسماح بتجاوز سلوك المحتوى قيد الاختبار محليًا، مثل تحديد حجم متاح أو لغة أو اتجاه التنسيق أو مقياس الخط أو المظهر.

الإصدار 1.6

الإصدار 1.6.8

‫12 يونيو 2024

تم طرح androidx.compose.ui:ui-*:1.6.8. يتضمّن الإصدار 1.6.8 هذه التعديلات.

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

• تم إصلاح حالات عدم الاتساق في تغيير حجم الخط عندما يكون حجم الخط أقل من الحد الأدنى المحدّد للجدول. في هذه الحالة، يتم الآن الاستيفاء بين المقياس الخطي 1x وأدنى جدول محدّد، بحيث يزداد حجم الخط بشكل رتيب مع زيادة المقاييس. (Icbae3)

الإصدار 1.6.7

‫1 مايو 2024

تم طرح androidx.compose.ui:ui-*:1.6.7. يتضمّن الإصدار 1.6.7 هذه التعديلات.

الإصدار 1.6.6

‫17 أبريل 2024

تم طرح androidx.compose.ui:ui-*:1.6.6. يتضمّن الإصدار 1.6.6 هذه التعديلات.

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

• إصلاح مشكلة تعطُّل BasicTextField النادرة

الإصدار 1.6.5

‫3 أبريل 2024

تم طرح androidx.compose.ui:ui-*:1.6.5. يتضمّن الإصدار 1.6.5 هذه التعديلات.

الإصدار 1.6.4

‫20 مارس 2024

تم طرح androidx.compose.ui:ui-*:1.6.4. يتضمّن الإصدار 1.6.4 هذه التعديلات.

الإصدار 1.6.3

‫6 آذار (مارس) 2024

تم طرح androidx.compose.ui:ui-*:1.6.3. يتضمّن الإصدار 1.6.3 هذه التعديلات.

الإصدار 1.6.2

‫21 فبراير 2024

تم طرح androidx.compose.ui:ui-*:1.6.2. يتضمّن الإصدار 1.6.2 هذه التعديلات.

الإصدار 1.6.1

‫7 فبراير 2024 تم طرح androidx.compose.ui:ui-*:1.6.1. يتضمّن الإصدار 1.6.1 هذه التعديلات.

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

• تم إصلاح مشكلة عدم التوافق مع الإصدارات القديمة من SemanticsPropertyReceiver.performImeAction وSemanticsActions.PerformImeAction. (Ie0bb2، b/322269946)
• تعرض التنسيقات الآن خطأ أثناء القياس عندما يعرض أحدها حجمًا كبيرًا بشكل غير طبيعي. يحدث هذا النوع من الأخطاء عادةً عندما تستخدم القياسات الحد الأقصى للقيود مباشرةً بدون التحقّق من Constraints.Infinity. سيساعد هذا الفحص المطوّرين في العثور على مشاكل في التنسيق الذي يتضمّن حجمًا غير صحيح بدلاً من التنسيق الذي يحتوي على هذا الحجم. (I339a9)

الإصدار 1.6.0

‫24 يناير 2024

تم طرح androidx.compose.ui:ui-*:1.6.0. يتضمّن الإصدار 1.6.0 هذه التعديلات.

الإصدار 1.6.0-rc01

‫10 يناير 2024

تم طرح androidx.compose.ui:ui-*:1.6.0-rc01. يتضمّن الإصدار 1.6.0-rc01 هذه التعديلات.

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

• تنفيذ محسّن لرسومات متّجهة لتحسين الأداء من خلال تقليل عمليات إعادة الإنشاء الإضافية

الإصدار ‎1.6.0-beta03

‫13 ديسمبر 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-beta03. يتضمّن الإصدار 1.6.0-beta03 هذه التعديلات.

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

• يمكن الآن فصل LayoutCoordinates بدون فصل العقدة. يمكنك الحماية من ذلك في "أداة فحص تنسيق Compose" (If693).

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

• أصبح PlatformImeOptions الآن فئة ملموسة بدلاً من واجهة. (If40a4)
• تم إصلاح عمليات إعادة التركيب الإضافية الثابتة التي تحدث بسبب توفير قيم جديدة لـ LocalSoftwareKeyboardController وLocalTextInputService في كل مرة تتم فيها إعادة تركيب العنصر الجذر. (I42190، b/310510985)

الإصدار 1.6.0-beta02

‫29 نوفمبر 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-beta02. يتضمّن الإصدار 1.6.0-beta02 هذه التعديلات.

الإصدار 1.6.0-beta01

‫15 تشرين الثاني (نوفمبر) 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-beta01. يتضمّن الإصدار 1.6.0-beta01 هذه التعديلات.

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

• يأخذ المعدِّل DragAndDropTarget الآن DragAndDropTarget المستلِم بشكلٍ صريح ويتضمّن تعبير lambda للموافقة على جلسة السحب والإفلات. تتوفّر الآن دالتان مصنع لـ DragAndDropModifierNode. أحدهما لتلقّي عمليات النقل والآخر لنقل البيانات (I69481)
• تم تعديل maximumFlingVelocity ليتم تمثيله كعدد عشري. تم تعديل المستندات لتكون أكثر وضوحًا بشأن maximumFlingVelocity. (I8adc7)
• تمت إعادة تسمية onDragAndDropStart في مصنع DragAndDropModifierNode إلى acceptDragAndDropTransfer.تمت إضافة acceptsDragAndDropTransfer إلى أداة التعديل dragAndDropTarget لقبول المحتوى من جلسة سحب وإفلات. تعرض هذه الدالة اللامدا قيمة DragAndDropTarget صالحة إذا كنت مهتمًا بجلسة السحب والإفلات. تم استبدال دوال lambda الأخرى لمعالجة أحداث السحب بهذه الدالة. تمت إضافة دالة مصنع DragAndDropTarget لتلقّي البيانات من جلسات السحب والإفلات (Iebf3a).

• تمت إزالة DragAndDropInfo كنوع، ويقبل DragAndDropModifierNode.drag الآن مَعلمات transferData وحجم الزخرفة ودالة lambda الخاصة بزخرفة السحب DrawScope

  تحتوي DragAndDropTarget على طرق لأحداث معيّنة للسحب والإفلات بدلاً من أن تكون طريقة مجرّدة واحدة

  تمت إعادة تسمية onDragAndDropEvent في دالة المصنع الخاصة بـ DragAndDropModifierNode إلى onDragAndDropStart لتوضيح أنّ DragAndDropTarget المقدَّم صالح لجلسة سحب وإفلات معيّنة فقط

  تمت إزالة DragAndDropEventType (I645b1)

• تمت إعادة تسمية PlatformTextInputModifierNode.runTextInputSession إلى establishTextInputSession. (I03cd0)

• تحسين أسماء واجهات برمجة التطبيقات الخاصة بالعُقد القابلة للاجتياز لجعلها أكثر وضوحًا (Ia4474)

• استبدِل OriginalText بـ TextSubstitution. (Ifa5a8)

• تمت إعادة تسمية PlatformTextInputModifierNode.textInputSession إلى runTextInputSession. (Ie9c6b)

• تُعدّ العناصر الفرعية من SubcomposeLayout (والتنسيقات المشابهة مثل LazyColumn المستندة إليه) التي يتم الاحتفاظ بها لإعادة استخدامها في المستقبل غير نشطة. تم تقديم واجهة برمجة تطبيقات جديدة لاختبار assertIsDeactivated() لاختبار هذه العُقد. سيتم تلقائيًا استبعاد العُقد غير النشطة من بقية واجهات برمجة التطبيقات الاختبارية. (I2ef84، b/187188981)

• تمت إزالة FocusDirection.In وFocusDirection.Out واستخدام FocusDirection.Enter وFocusDirection.Exit بدلاً منهما (I2f660)

• تعتمد واجهات برمجة التطبيقات الخاصة بـ Material SwipeToReveal (للبطاقات والرقائق) الآن على واجهة برمجة تطبيقات مستندة إلى الخانات (كما هو مقترَح في Compose) بدلاً من مثيلات مستندة إلى فئة البيانات لإنشاء هذه الخانات. هذا تغيير غير متوافق مع الإصدارات السابقة، لذا يُرجى الاطّلاع على العرض التوضيحي والرمز النموذجي للحصول على أمثلة حول كيفية استخدام واجهة برمجة التطبيقات الجديدة. (Ia8943)

• تم إيقاف الدالة الإنشائية FontStyle(int) نهائيًا، لذا يُرجى استخدام FontStyle.Normal أو FontStyle.Italic بدلاً منها. (I66610)

• تمت إعادة تسمية واجهة FontScalable إلى FontScaling (Ie804a)

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

• لن يعرض SoftwareKeyboardController.show() لوحة مفاتيح افتراضية إذا لم يكن هناك محرِّر نصوص مركّز عليه. (I2165a، b/301477279)
• سيتم الآن تجاهل أحداث "التحرير" لمفاتيح الأجهزة التي لم تتلقَّ حدث "الضغط" في "طريقة العرض Compose" نفسها. (Ib37b4، b/305518328)
• إضافة إمكانية استخدام أداة العرض مع "التدرّج الدائري" في ArcLine (I4d5bb)
• نفِّذ الدالتَين equals وhashcode للسمة PageSize.Fixed. (Ie3ede، b/300134276)
• إصلاح مشكلة توافق البرنامج الثنائي مع تغيير Window Inset (Iee695)
• إزالة الطبقة الأساسية للمادة من أجل Material3 Chip/Button لأنّ اختبارات الأداء الدقيقة تُظهر أداءً أفضل بدونها. (I55555)
• سيتم الآن استخدام TestDispatchers التي تم تمريرها كـ effectContext إلى اختبارات Compose لإنشاء اختبارات وساعات إطار. (Ia7178)

الإصدار ‎1.6.0-alpha08

‫18 أكتوبر 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha08. يتضمّن الإصدار 1.6.0-alpha08 هذه التعديلات.

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

• تمت إعادة تسمية دالة lambda onDrawDragShadow في Modifier.dragAndDrawSource إلى drawDragDecoration، كما تمت إعادة تسمية مَعلمة الحجم في DragAndDropInfo إلى dragDecorationSize. (Id0e30، b/303904810)
• إضافة SemanticsNodeInteraction.isDisplayed() وSemanticsNodeInteraction.isNotDisplayed() للتحقّق مما إذا كانت العقدة المطابِقة مرئية أم لا بدون التأكّد من ذلك أيضًا (I2c196، b/302100809)
• تم تقديم القيمة الخاصة Unspecified للحقول TextAlign وTextDirection وHyphens وLineBreak من ParagraphTextStyle لاستبدال null. بما أنّ هذه الفئات هي فئات مضمّنة، نتجنّب تحويل النوع الأساسي إلى نوع مرجعي من خلال استبدال النوع القابل للتصغير بالنوع غير المحدّد. تم تعديل أدوات الإنشاء وعناصر الجلب والطرق الأخرى في TextStyle و"نمط الفقرة" لقبول المَعلمات المذكورة كأنواع غير فارغة. (I4197e، b/299490814)
• أضِف حمولة زائدة GoogleFont لقراءة GoogleFont من XML. (If8f59)
• تم جعل الصف LoremIpsum PreviewParameterProvider صفًا مفتوحًا. (I41bf5، b/266918816، b/300116360)

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

• تستخدم FontFamilyResolver الآن Dispatchers.Main لروتينات مشتركة لإدارة ذاكرة التخزين المؤقت. (Ie8dd9)
• تزيل AndroidViewBinding الآن بشكل متزامن مثيلات Fragment التي تم تضخيمها من خلال تضمين FragmentContainerView في التصميم كجزء من onRelease باستخدام commitNow (بدلاً من commit التي كانت تستخدمها سابقًا)، وبالتالي إصلاح المشاكل المتعلّقة بطريقة "التعديل المباشر" عند استبدال التركيبة عند إجراء تغييرات. (I58fbf)

الإصدار 1.6.0-alpha07

‫4 أكتوبر 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha07. يتضمّن الإصدار 1.6.0-alpha07 هذه التعديلات.

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

• تم تقديم PlatformTextInputMethodTestOverride لكتابة اختبارات لمحرّرات النصوص المخصّصة. (Id159b)
• تضيف هذه السمة المعدِّل dragAndDropSource لبدء جلسات السحب والإفلات، والمعدِّل dragAndDropTarget لتلقّي البيانات من جلسات السحب والإفلات. (Ib7828، b/286038936)
• تمت إضافة مجموعتَي ColorList وColorSet اللتين تتجنّبان عمليات التخصيص. (I744bd)
• تمت إضافة العلامة المؤقتة DisableNonLinearFontScalingInCompose لإيقاف الضبط غير الخطي لحجم الخط. اضبط DisableNonLinearFontScalingInCompose = true في اختباراتك إذا كنت بحاجة إلى وقت لتنظيفها. ستتم إزالة هذا الخيار في الإصدار 1.6.0-beta01 من Compose. (Ic9486)

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

• تحسين تحليل الرسومات المتجهة القابلة للرسم بتنسيق XML (Ibb015)

الإصدار 1.6.0-alpha06

‫20 سبتمبر 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha06. يتضمّن الإصدار 1.6.0-alpha06 هذه التعديلات.

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

• تحسينات إضافية على رموز Material (I3e08d)
• تضيف هذه السمة إمكانية التنقّل للأعلى/للأسفل في شجرة المعدِّلات للعثور على عُقد مشابهة. (I2d234)
• تمت إضافة معاودة الاتصال onRestoreFailed() إلى أداة التعديل focusRestorer() (Ie1d43)
• تمت إضافة تعليقات توضيحية androidx إلى واجهات برمجة تطبيقات الرسومات المختلفة لتحديد ColorInt وFloatRange وIntRange وSize وغير ذلك. (Id65c8، b/290950582)
• إضافة showSystemUi=true إلى تعريف PreviewScreenSizes (Ib61d3)

التغييرات في السلوك

• تستخدم ميزة "الكتابة الذكية" الآن ضبطًا غير خطّي لحجم الخط لتسهيل القراءة والاستخدام. عندما يكون مقياس الخط أكبر من% 100 في إعدادات النظام، سيزداد حجم النص الصغير بشكلٍ عادي، ولكن النص الكبير سيزداد حجمه قليلاً فقط. بالإضافة إلى ذلك، سيتم تعديل ارتفاعات الأسطر المحدّدة في SP تلقائيًا لتبقى متناسبة مع الارتفاع المقصود بنسبة% 100. يمكنك الاطّلاع على أفضل الممارسات المتعلّقة بتغيير حجم الخط للحصول على مزيد من المعلومات. (I11518)

الإصدار ‎1.6.0-alpha05

‫6 سبتمبر 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha05. يتضمّن الإصدار 1.6.0-alpha05 هذه التعديلات.

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

• تفعيل ميزة "التقاط المحتوى" في AndroidComposeViewAccessibilityDelegateCompat (Ib2969)
• يتم تحديد الحد الأقصى لسرعات التحريك السريع في مكوّنات العرض، مثل ScrollView وRecyclerView، عند ViewConfiguration.ScaledMaximumFlingVelocity. يتضمّن تطبيق "إنشاء" الآن إصدارًا خاصًا به من maximumFlingVelocity ينطبق على Draggable. (Ibf974)
• تضيف هذه الحزمة عملية إنشاء أساسية لدعم واجهات برمجة التطبيقات التي تتيح السحب والإفلات على المنصة. (If84ce)
• إضافة deviceId إلى RotaryScrollEvent (Iba3bf)
• تم تعديل واجهة برمجة التطبيقات ui-tooling Devices API لتشمل أجهزة أحدث (Ib25b4)

الإصدار ‎1.6.0-alpha04

‫23 أغسطس 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha04. يتضمّن الإصدار 1.6.0-alpha04 هذه التعديلات.

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

• أضفنا طريقة لإيقاف ReusableComposition، ما يؤدي إلى إزالة الملاحظات مع الإبقاء على العُقد. يمكن إعادة تفعيل التركيب الذي تم إيقافه من خلال استدعاء setContent. (Ib7f31)
• إضافة واجهة ReusableComposition لإدارة دورة الحياة وإعادة استخدام التركيبات الفرعية (I812d1، b/252846775)
• تمت ترقية Modifier.focusGroup إلى واجهات برمجة تطبيقات ثابتة. (I7ffa3)
• تمت إضافة تعليقات توضيحية androidx إلى واجهات برمجة تطبيقات الرسومات المختلفة لتحديد ColorInt وFloatRange وIntRange وSize وغير ذلك. (I70487، b/290950582)
• تم تعديل واجهة برمجة التطبيقات ColorFilter لتضمين أنواع فئات فرعية ملموسة من أجل تحسين إمكانية فحص المَعلمات. (I5fe29)
• إضافة مكتبة wear-tooling-preview لعرض قائمة بأجهزة Wear OS الصالحة التي يمكن استخدامها لمعاينات واجهة المستخدم (Ib036e)
• تم إنشاء واجهة FontScalable للتعامل مع جزء تغيير حجم الخط في واجهة "الكثافة". (I2cf3f)

الإصدار 1.6.0-alpha03

‫9 أغسطس 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha03. يتضمّن الإصدار 1.6.0-alpha03 هذه التعديلات.

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

• نوع جديد من انتقالات الدخول/الخروج التي توسّع المحتوى أو تقلّصه استنادًا إلى حجم الحاوية المتحركة أثناء حركة الدخول والخروج أصبحت الآن واجهة LookaheadScope Composable fun ثابتة. (Ifb2ce)
• تمت إضافة إمكانية ضبط privateImeOptions (Idb772)

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

• ستعدّل PopupPositionProvider.calculatePosition الآن تلقائيًا موضع النافذة المنبثقة عند تغيير حالة القراءة في عملية الحساب. (I676a1، b/292257547)
• تم إصلاح الحقول النصية التي تعرض لوحة المفاتيح ويمكن تعديلها عندما تكون قيمة readOnly صحيحة. تم أيضًا إصلاح مشكلة عدم ظهور لوحة المفاتيح عند تغيير قيمة readOnly من "صحيح" إلى "خطأ" أثناء التركيز. (I34a19، b/246909589)
• توسيع نطاق تطبيق التأكيدات العامة في اختبار واجهة المستخدم (I1f90d)

الإصدار ‎1.6.0-alpha02

‏26 تموز (يوليو) 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha02. يتضمّن الإصدار 1.6.0-alpha02 هذه التعديلات.

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

• تمت إضافة واجهة أداة تحديد موقع الخدمة التي يمكن أن ينفّذها منفّذو Composition والتي تسمح بتنفيذ Composition الذي يفوّض عمليات البحث عن خدمة تفويض أخرى إلى Composition الأصلي. يجب عدم استدعاء هذه الدالة مباشرةً، ويتم استخدامها لتفعيل إنشاء واجهات برمجة تطبيقات تجريبية في وقت التشغيل يمكن العثور عليها من الإصدارات المُغلَّفة من أداة الإنشاء، مثلما تفعل وحدة واجهة المستخدم. (I296b9)
• إعادة تصميم واجهة برمجة التطبيقات PlatformTextInput* بالكامل (I6c93a، b/274661182، b/267235947، b/277380808)
• لم يعُد SoftwareKeyboardController وLocalSoftwareKeyboardController ميزتَين تجريبيتَين. أصبح LocalSoftwareKeyboardController الآن CompositionLocal مناسبًا أيضًا. (I4c364)
• تم إيقاف LookaheadLayout وLookaheadLayoutScope نهائيًا في بعض الإصدارات السابقة، وتمت إزالتهما الآن. واجهات برمجة التطبيقات البديلة هي LookaheadScope التي يمكنها العمل مع أي تنسيق. (I12ac3)
• تمت إضافة SemanticsNodeInteraction.requestFocus كطريقة أسهل وأكثر وضوحًا لطلب التركيز في الاختبارات. (Ie8722)
• إضافة واجهات برمجة تطبيقات تجريبية لتسجيل تأكيدات عامة، لاستخدامها من قِبل أُطر الاختبار في المستقبل (I12d77)

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

• سيتم الآن تأجيل الاستدعاء الأول update للدالة AndroidView إلى حين ربط العرض، بدلاً من تنفيذه عند تطبيق التركيبة التي تقدّم AndroidView. يؤدي ذلك إلى إصلاح خطأ كان يؤدي إلى عدم إبطال معاودة الاتصال update إذا تم تغيير حالة تمت قراءتها على الفور بواسطة تأثير. (Ie9438، b/291094055)

الإصدار ‎1.6.0-alpha01

‫21 حزيران (يونيو) 2023

تم طرح androidx.compose.ui:ui-*:1.6.0-alpha01. يتضمّن الإصدار 1.6.0-alpha01 هذه التعديلات.

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

• إتاحة البحث المسبق في LazyList يسمح ذلك لـ LazyList في عملية البحث المسبق بتجاوز أي صورة متحركة (مثل صورة متحركة لوضع العناصر، AnimatedVisibility، وما إلى ذلك) واحتساب حجم وموضع البحث المسبق لجميع العناصر الفرعية. بعد عملية العرض المسبق، يمكن للأطفال في LazyList تحريك الشخصيات بشكل مستقل عن الواقع كما يظهر في عملية العرض المسبق.

تغيير في السلوك: تم ضبط قيمة includeFontPadding على false تلقائيًا في Compose

أصبحت قيمة includeFontPadding الآن false تلقائيًا (21d806) في Compose.

‫includeFontPadding هي سمة قديمة تتحكّم في ما إذا كان سيتم تضمين مساحة متروكة إضافية أعلى السطر الأول وأسفل السطر الأخير من النص لاستيعاب أي أحرف قد تمتد فوق خطوط الأساس أو تحتها.

سيؤدي تعديل إصدار Compose هذا إلى تغيير طريقة عرض جميع النصوص في واجهة المستخدم من خلال إزالة المساحة المتروكة الإضافية أعلى السطر الأول والأخير من كل نص تعرضه.

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

يمكنك الموافقة على includeFontPadding باستخدام PlatformTextStyle لكل نص:

Text(
 text = myText,
 style = TextStyle(
   lineHeight = 2.5.em,
   platformStyle = PlatformTextStyle(
     includeFontPadding = true/false
   )
   /* … */
  )
)

يمكنك تفعيل includeFontPadding لجميع نصوصك من خلال ضبط أنماط Material. يُرجى العِلم أنّ أسماء المَعلمات ستختلف بين الإصدارين M2 وM3.

val Typography = Typography(
   body1 = TextStyle(
       fontFamily =    /* … */,
       fontSize =    /* … */,
       platformStyle = PlatformTextStyle(
           includeFontPadding = false
       )
   /* … */
   )
)

MaterialTheme(
   typography = Typography,
   /* … */
)

يمكنك الاطّلاع على مزيد من المعلومات حول Compose includeFontPadding في مستندات المطوّرين ومنشور المدوّنة هذا.

إذا واجهت مشاكل أو أخطاء مرتبطة بهذا التغيير، يمكنك تسجيل خطأ باستخدام أداة تتبُّع المشاكل.

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

• دعم InputConnection#requestCursorUpdates (I0c69b)
• تمت إضافة FocusRequester.saveFocusedChild وFocusRequester.restoreFocusedChild (Ic557e وb/272302679 وb/275157318)
• أضِف النوع ResourceResolutionException لتضمين العناصر القابلة للرمي التي يتم طرحها عند محاولة تحميل مواد عرض الصور النقطية مع وصف لمسار مادة العرض التي تعذّر تحميلها. (I19f44، b/230166331، b/278424788)
• تم تحسين إمكانية الوصول إلى الذاكرة وتخصيصها لتحسين الأداء. (Iede48)
• أضفنا خصائص ودلالات وإجراءات لدعم ترجمة النصوص. (I4a6bc)
• سمة جديدة في IntrinsincMeasureScope وعمليات تنفيذها (مثل MeasureScope) للإشارة إلى ما إذا كانت عملية قياس المقياس الحالية هي عملية بحث مسبق. (I7a812)
• تم تعديل واجهة برمجة التطبيقات DrawScope لإتاحة إمكانية إعادة استهداف العرض في لوحة عرض مختلفة باستخدام كثافة/اتجاه تخطيط وحجم بديلَين.
• تم تعديل DrawContext لإتاحة ضبط الكثافة واتجاه التصميم، بالإضافة إلى إمكانية ضبط لوحة العرض. (Ie1f9b، b/225408150)
• تمت إضافة Paragraph#fillBoundingBoxes لاحتساب المربّعات المحيطة بالأحرف. (If30ee)
• تمت إضافة مجموعة من MultiPreviews الشائعة (Ia5a27)

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

• تمت إضافة واجهة FocusTargetModifierNode يمكن استخدامها لإنشاء FocusTarget مخصّص. (I9790e)
• تمت إعادة تسمية المَعلمات fallback* في الدالة الإنشائية TextMeasurer إلى default*. (I940a5)
• تمت إعادة تسمية "SemanticsPropertyReceiver.performImeAction" إلى "onImeAction" و"SemanticsActions.PerformImeAction" إلى "OnImeAction". (I8e841)
• تضيف هذه السمة Wheel للتمييز بين التمرير بالماوس والسحب في التمرير المتداخل (في NestedScrollConnection على وجه التحديد). (Ie57e4)
• تمت إضافة واجهة برمجة التطبيقات asComposePaint لاستبدال toComposePaint لأنّ العنصر الذي يتم عرضه يغلّف android.graphics.Paint الأصلي (I22b4c)
• إيقاف SemanticsProperties.imeAction نهائيًا واستبداله بمعلَمة جديدة في SemanticsActions.performImeAction (I4a587)
• تمت إضافة إمكانية التحديد باستخدام الماوس. سيتوسّع التحديد المستند إلى اللمس بمقدار كلمة، وسيتقلّص بمقدار حرف. (Ic0c6c، b/180639271)
• تُطلق الآن طرق Paragraph التي كانت تُطلق AssertionError لإزاحات خارج الحدود الخطأ IllegalArgumentException كما تفعل MultiParagraph. (I549d3، b/243338896)

الإصدار 1.5

الإصدار 1.5.4

‫18 أكتوبر 2023

تم طرح androidx.compose.ui:ui-*:1.5.4. يتضمّن الإصدار 1.5.4 هذه التعديلات.

الإصدار 1.5.3

‫4 أكتوبر 2023

تم طرح androidx.compose.ui:ui-*:1.5.3. يتضمّن الإصدار 1.5.3 هذه التعديلات.

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

• (b/301209788) كان TextField في بعض الأحيان يطبّق الأوامر السابقة بشكل غير صحيح عند التركيز على النص وإدخال نص باللغة الكورية، ما يؤدي إلى فقدان بعض الأحرف.

الإصدار 1.5.2

‫27 سبتمبر 2023

تم طرح androidx.compose.ui:ui-*:1.5.2. يتضمّن الإصدار 1.5.2 هذه التعديلات.

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

• تمت إضافة حلّ بديل للأعطال التي تحدث عند الوصول إلى واجهة برمجة التطبيقات الخاصة بالتمرير للأعلى أو للأسفل من سلسلة التعليمات في الخلفية.
• إصلاح مشكلة إضافة العُقد غير المرفقة إلى شجرة الدلالات

الإصدار 1.5.1

‫6 سبتمبر 2023

تم طرح androidx.compose.ui:ui-*:1.5.1. يتضمّن الإصدار 1.5.1 هذه التعديلات.

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

• تم إصلاح الحقول النصية التي تعرض لوحة المفاتيح ويمكن تعديلها عندما تكون قيمة readOnly صحيحة. تم أيضًا إصلاح مشكلة عدم ظهور لوحة المفاتيح عند تغيير قيمة readOnly من "صحيح" إلى "خطأ" أثناء التركيز. (I34a19، b/246909589)

الإصدار 1.5.0

‫9 أغسطس 2023

تم طرح androidx.compose.ui:ui-*:1.5.0. يتضمّن الإصدار 1.5.0 هذه التعديلات.

الإصدار 1.5.0-rc01

‏26 تموز (يوليو) 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-rc01. يتضمّن الإصدار 1.5.0-rc01 هذه التعديلات.

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

• تم إصلاح عُطل يحدث عند استخدام SubcomposeLayout داخل movableContentOf().

الإصدار ‎1.5.0-beta03

‫28 حزيران (يونيو) 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-beta03. يتضمّن الإصدار 1.5.0-beta03 هذه التعديلات.

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

• تمت إضافة واجهة FocusTargetModifierNode التي يمكن استخدامها لإنشاء FocusTarget مخصّص. (Ifb1d6)
• تم إصلاح مشكلة في عناصر Dialog وPopup القابلة للإنشاء قد تؤدي إلى عدم تغيير حجم النافذة الفرعية على النحو المتوقّع عند استخدام usePlatformDefaultWidth=true. (I112ee)

الإصدار ‎1.5.0-beta02

‫7 يونيو 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-beta02. يتضمّن الإصدار 1.5.0-beta02 هذه التعديلات.

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

• تمت إضافة واجهة برمجة التطبيقات asComposePaint لإتاحة استخدام مثيل android.graphics.Paint في Compose

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

• تمت إضافة واجهة برمجة التطبيقات asComposePaint لاستبدال toComposePaint لأنّ العنصر الذي يتم عرضه يغلّف android.graphics.Paint الأصلي (I22b4c)

الإصدار ‎1.5.0-beta01

‫24 مايو 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-beta01. يتضمّن الإصدار 1.5.0-beta01 هذه التعديلات.

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

• تمت إزالة عمليات التخصيص في إعادة التركيب، والصور المتحركة للألوان، وAndroidComposeView (Ib2bfa)
• إضافة وظيفة مساعدة ممتعة CacheDrawModifierNode() للسماح بالتفويض (Icf8f9)
• نقدّم لك السمة isLookingAhead التي يمكن الوصول إليها من MeasureScope لمراقبة نتائج البحث الاستباقي والتأثير في عملية الفحص الرئيسية إذا أردت. (Ibf4c3)
• السمة الدلالية الجديدة traversalIndex، وهي عدد عائم يُستخدَم لإعادة ترتيب العُقد في عملية اجتياز TalkBack (تأتي القيم الأصغر أولاً). (I9a81b، b/186443263)
• إعادة تسمية السمة Semantics من isContainer إلى isTraversalGroup (I121f6)
• تم الآن منح "ColorProducer" دور operator fun invoke بدلاً من produce (I4a9a2)
• أضِف Path transform API لتطبيق عمليات تحويل الترجمة/الحجم/التدوير على عناصر المسار. (I23434، b/233772232)
• تُسمى طريقة ColorProducer بـ produce. (I78bde)
• تمّت إعادة تسمية "toFrameworkColorSpace" إلى "toAndroidColorSpace" (I4f547)
• تمّت إعادة تسمية ColorLambda إلى ColorProducer. (I73b1a)
• إضافة واجهات برمجة تطبيقات للتحويل بين أنواع مساحات الألوان في Android وCompose (Ie7db4، b/279979665)
• تمت إضافة مَعلمة لون إلى BasicText للسماح بتحريك لون النص أو ضبطه بكفاءة. (Iffd88، b/246961787)
• تمت إعادة تسمية TextRange.constrain إلى TextRange.coerceIn. (I31be2)
• تمّت إضافة TextStyle.merge(...) محسَّن مع قائمة المَعلمات الكاملة. (Iad234، b/246961787)
• تم تثبيت العديد من واجهات برمجة التطبيقات الخاصة بالنصوص والتي تتضمّن Brush وDrawStyle وTextMotion وDrawScope.drawText وParagraph.paint(Brush) وMultiParagraph.paint(Brush). (I2f740، b/261581564، b/261581931، b/261561245)
• تمت إعادة تفعيل PlatformTextStyle.includeFontPadding. كانت نيتنا الأصلية هي إزالة الحقل، ولكن تشير الملاحظات إلى أنّ المطوّرين يحتاجون إلى خيار الإعداد هذا. لذلك، أزلنا الإيقاف النهائي من الحقل (I98e96، b/277703184)
• تمت إضافة طريقة TextRange.constrain العامة. (I97912)
• يمكن الآن فتح UrlAnnotation في AnnotatedString من خلال خدمات تسهيل الاستخدام، مثل TalkBack. (If4d82، b/253292081)
• تمت إضافة إجراء InsertTextAtCursor الدلالي لحقول النص. (I11ed5)
• تمت ترقية الدالة الإنشائية LineHeightStyle.Alignment(topRatio) إلى واجهة برمجة تطبيقات ثابتة. (I79c32، b/261565383)
• لم تعُد واجهة برمجة التطبيقات TextMeasurer والواجهات ذات الصلة بها تجريبية. (I74647، b/261581753)
• تمت إضافة إجراء PerformImeAction الدلالي لاستدعاء إجراء محرر أسلوب الإدخال على عُقد محرر النصوص. (Ic606f، b/269633506)
• لم تعُد واجهات برمجة التطبيقات PlatformTextInput تجريبية على Android. (I668eb)
• تم تغيير اسم مَعلمة القيمة Enum.valueOf (Ia9b89)
• المزيد من الاستثناءات التي تم طرحها من enum valueOf (I818fe)
• تم طرح واجهة برمجة التطبيقات الجديدة PlatformTextInputAdapter ذات المستوى المنخفض لإنشاء عمليات تنفيذ مخصّصة لإدخال النصوص تتواصل مباشرةً مع واجهات برمجة التطبيقات الخاصة بالمنصة. (I58df4)
• تمت إضافة المَعلمة BlendMode إلى الطرق DrawScope.drawText وParagraph.paint وMultiParagraph.paint لتوفير خوارزميات دمج مختلفة عند رسم نص على Canvas. (I57508)
• تمّت إعادة تسمية Font.MaximumAsyncTimeout إلى Font.MaximumAsyncTimeoutMillis. إعادة التسمية فقط (I07af5)
• قيم النقاط لكل بوصة المعدَّلة للأجهزة المرجعية @Preview (Id6151، b/254528382)
• أضِف المَعلمتَين brush وalpha إلى BasicText للسماح بتحريك فرشاة النص أو ضبطها بكفاءة.
• تحديد أنواع lambda غير المعبأة لكل من Float وDouble وLong وInt وShort في ‎ :ui:ui-unit (I6f18d وb/246961787)

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

• تمت إزالة عمليات تخصيص متعدّدة في تتبُّع سرعة المؤشر (I26bae)
• تقليل عمليات التخصيص في إدارة تخطيطات الإدخال باستخدام المؤشر (I5333a)
• تحسين استخدام ذاكرة Vector وعرض الإطارات الأولى (I2f3c6)
• تمت إزالة عمليات التخصيص عند رسم خطوط ونقاط باستخدام Canvas (I9f535)
• إضافة مستندات لـ AndroidFont.fontVariationSettings (I7d9e2)

المساهمة الخارجية

• تحسين الأداء وتقليل عمليات التخصيص في Vector APIs (I906cb)

الإصدار ‎1.5.0-alpha04

‫10 مايو 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-alpha04. يتضمّن الإصدار 1.5.0-alpha04 هذه التعديلات.

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

• Modifier.Node تحسينات على التفويض تمت إضافة إمكانية محسّنة للتفويض إلى مثيلات Modifier.Node أخرى من DelegatingNode. يمكن إجراء ذلك باستخدام واجهتَي برمجة التطبيقات delegate وundelegate. قبل هذا التغيير، كان يجب تفويض كل واجهة برمجة تطبيقات من العقدة المفوضة بشكلٍ صريح إلى العقدة المفوض إليها. بعد هذا التغيير، سيتم تفويض واجهات العُقد ضمنيًا ما لم يتم إلغاؤها بشكل صريح باستخدام DelegatingNode. (67352bc)

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

• قدِّم NestedScrollModifierNode، وهو NestedScroll Modifier.Node يمكن تفويضه. (I69513)
• تمت إضافة المَعلمتَين onReset وonRelease إلى الدالة المركّبة AndroidViewBinding، ما يطابق الدالة المركّبة AndroidView ويتيح إمكانية إعادة استخدام العرض باستخدام ViewBinding. (I00b1e، b/276802519)
• تم تعديل واجهة برمجة التطبيقات Compose Path API لتتيح عمليات الترجيع من أجل دعم حالات الاستخدام التي تتضمّن تعديلاً متكررًا على المسار مع إعادة استخدام أسرع. (I7b797)
• تمّت إضافة TextStyle.merge(...) محسَّن مع قائمة المَعلمات الكاملة. (Iad234، b/246961787)
• تم تثبيت العديد من واجهات برمجة التطبيقات الخاصة بالنصوص والتي تتضمّن Brush وDrawStyle وTextMotion وDrawScope.drawText وParagraph.paint(Brush) وMultiParagraph.paint(Brush). (I2f740، b/261581564، b/261581931، b/261561245)
• تمت إعادة تفعيل PlatformTextStyle.includeFontPadding. كانت نيتنا الأصلية هي إزالة الحقل، ولكن تشير الملاحظات إلى أنّ المطوّرين يحتاجون إلى خيار الإعداد هذا. لذلك، أزلنا الإيقاف النهائي من الحقل (I98e96، b/277703184)

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

• تم إصلاح مشكلة عدم ظهور لوحة المفاتيح في الحقول النصية داخل مربّعات الحوار التي لم يتم إنشاؤها باستخدام العنصر القابل للإنشاء Dialog. (I82551، b/262140644)

الإصدار ‎1.5.0-alpha03

‫19 أبريل 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-alpha03. يتضمّن الإصدار 1.5.0-alpha03 هذه التعديلات.

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

• السلوك التلقائي الجديد لـ SubcomposeLayout في LookaheadScope: إنّ SubcomposeLayouts التي لا تحتوي على خانات مشروطة (مثل TabRow وScaffold وBoxWithConstraints وما إلى ذلك) تعمل الآن بشكل جيد مع الرسوم المتحركة المسبقة.

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

• تتيح السمة التلقائية الجديدة intermediateMeasurePolicy التي تعيد استخدام سياسة القياس من عملية البحث المسبق عمل الأنواع الفرعية SubcomposeLayout بدون خانات مشروطة، مثل Scaffold وTabRow وBoxWithConstraints، مع عملية البحث المسبق تلقائيًا. (Id84c8)
• لن يحظر أداة إعادة التركيب التي تم إنشاؤها لنافذة Android الآن سوى المكالمات الواردة إلى withFrameNanos بدلاً من كل التركيب عند تلقّي إشعار ON_STOP. وهذا يعني أنّ النوافذ المرتبطة بالأنشطة المتوقّفة ستستمر في إعادة الإنشاء عند حدوث تغييرات في البيانات، ولكن سيتم حظر الحركات أو أيّ برنامج آخر يستدعي withFrameNanos. (Id9e7f، b/240975572)
• تغيير motionEventSpy إلى الإصدار الثابت (Ic5ec4، b/261560988)
• تمت إضافة طريقة TextRange.constrain العامة. (I97912)
• لم يعُد PlatformTextStyle.includeFontPadding متوقفًا نهائيًا لتشجيع المطوّرين على استخدام واجهة برمجة التطبيقات المتوافقة هذه للتبديل واختبار ضبط includeFontPadding على "خطأ". (I98e96، b/277703184)

الإصدار ‎1.5.0-alpha02

‫5 أبريل 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-alpha02. يتضمّن الإصدار 1.5.0-alpha02 هذه التعديلات.

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

• واجهة برمجة التطبيقات الجديدة SubcomposeLayout التي تتضمّن سياسة مقياس وسيط إضافي للتعامل مع منطق المقياس/التنسيق أثناء الرسوم المتحركة المستندة إلى البحث المسبق (I017d3)
• أصبحت السمة PointerInput الآن تعمل بشكل غير متزامن وتستخدم Modifier.Node لتحسين الأداء (مزيد من المعلومات عن التغيير الطفيف في السلوك). (15dab9)
• تغيير واجهات برمجة التطبيقات التجريبية إلى واجهات ثابتة باستخدام الأحداث الرئيسية (I9c7d8، b/261566839، b/261567368)
• تغيير واجهات برمجة التطبيقات التجريبية إلى إصدار ثابت في PointerInputChange (I1b543، b/261560988، b/261565762، b/261565749)
• تضيف هذه السمة طريقة لإنشاء مثيل من SuspendingPointerInputModifierNode لتنفيذ Modifier.Node أكثر تعقيدًا. (Ic4933)
• يمكن الآن فتح UrlAnnotation في AnnotatedString من خلال خدمات تسهيل الاستخدام، مثل TalkBack. (If4d82، b/253292081)
• تمت إضافة واجهة برمجة تطبيقات لاعتراض مفاتيح الأجهزة قبل إرسالها إلى لوحة المفاتيح الافتراضية (I4f4c6، b/186800395)
• تمت إضافة إجراء InsertTextAtCursor الدلالي لحقول النص. (I11ed5)
• ستطلب الآن إجراءات الاختبار المتعلّقة بالنصوص (مثل performTextInput) التركيز مباشرةً، وذلك باستخدام الإجراء الدلالي، بدلاً من النقر على الحقل. (I6ed05)

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

• تتطلّب إجراءات اختبار النص الآن تفعيل حقول النص. (Iab328)

الإصدار ‎1.5.0-alpha01

‫22 مارس 2023

تم طرح androidx.compose.ui:ui-*:1.5.0-alpha01. يتضمّن الإصدار 1.5.0-alpha01 هذه التعديلات.

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

• لم يعُد Modifier.intermediateLayout يتطلّب LookaheadScope صريحًا. يحتوي حظر القياس في intermediateLayout على IntermediateMeasureScope كجهاز استقبال، ما يوفّر CoroutineScope وLookaheadScope وMeasureScope مناسبة.(Ibe2e5)
• تم استبدال LookaheadLayout بـ LookaheadScope، الذي لم يعُد Layout. يتيح ذلك التحكّم مباشرةً في محتوى الطفل في LookaheadScope من خلال MeasurePolicy الخاص بالوالد. (Ibe2e5)
• تضيف هذه السمة Modifier.Node#coroutineScope للسماح لـ Modifier.Nodes بتشغيل إجراءات روتينية. (I76ef9)
• السماح لفئة Modifier.Nodes بقراءة CompositionLocals من خلال تنفيذ واجهة CompositionLocalConsumerModifierNode (Ib44df)
• نقل فئة ‎ @Deprecated إلى السمة (I882d1)

الإصدار 1.4

الإصدار 1.4.3

‫3 مايو 2023

تم طرح androidx.compose.ui:ui-*:1.4.3. يتضمّن الإصدار 1.4.3 هذه التعديلات.

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

• تم إصلاح مشكلة عدم عرض AndroidView بشكلٍ صحيح عند استخدامه مع بعض المعدِّلات. (I4dc77، b/274797771)
• تم إصلاح خطأ في ميزة "البحث عن التركيز" الثنائية الأبعاد كان يؤثر في DropDown القوائم (b/276811828)
• تم إصلاح خطأ في خصائص الدخول/الخروج من التركيز المخصّصة التي لم يتم تشغيل كتلة الدخول/الخروج إلا في المرة الأولى التي تم فيها استدعاء تعبير lambda (b/277234245).
• تم إصلاح مشكلة في نظام التركيز تسبّبت في حدوث تعطُّل أثناء قراءة focusProperties. (b/271324781 وb/274897776)

الإصدار 1.4.2

‫19 أبريل 2023

تم طرح androidx.compose.ui:ui-*:1.4.2. يتضمّن الإصدار 1.4.2 هذه التعديلات.

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

• تم إصلاح مشكلة عدم إعادة استخدام AndroidView للمعدّلات بشكلٍ صحيح، ما قد يؤدي إلى حدوث سلوك غير متوقّع وتعطُّل. (Ib67ee، b/275919849)
• تم إصلاح مشكلة تراجع حيث لم تكن لوحة المفاتيح تظهر للحقول النصية داخل مربّعات الحوار التي لم يتم إنشاؤها بواسطة العنصر القابل للإنشاء Dialog (I82551، b/262140644)

الإصدار 1.4.1

‫5 أبريل 2023

تم طرح androidx.compose.ui:ui-*:1.4.1. يتضمّن الإصدار 1.4.1 هذه التعديلات.

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

• تم إصلاح مشكلة عدم تأثير ParentDataModifier في AndroidView (b/274797771)

الإصدار 1.4.0

‫22 مارس 2023

تم طرح androidx.compose.ui:ui-*:1.4.0. يتضمّن الإصدار 1.4.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.3.0

• تمت إضافة واجهة برمجة تطبيقات PinnableContainer جديدة تتيح تثبيت عناصر القائمة الكسولة، حتى لا يتم التخلص منها عند التمرير خارج الحدود. على سبيل المثال، تستخدم Modifier.focusable() هذه الآلية لتثبيت العنصر الذي يتم التركيز عليه حاليًا. (Ib8881، b/259274257، b/195049010)
• تمت إعادة كتابة نظام التركيز باستخدام واجهات برمجة التطبيقات التجريبية الجديدة Modifier.Node. (I7f4d7 وb/247708726 وb/255352203 وb/253043481 وb/247716483 وb/254529934 وb/251840112 وb/251859987 وb/257141589)
• تمت إضافة السمة الدلالية IsContainer في Surfaces. سيتم استخدام هذه السمة في تغيير لاحق يحدّد ترتيب الانتقال استنادًا إلى المعنى الدلالي للعناصر، مثل المساحات. (I63379)
• تمت إضافة دور جديد لتسهيل الاستخدام DropdownList. يمكن استخدام هذا الخيار لتكرار سلوك TalkBack عند التركيز على android.widget.Spinner. (I177e5، b/236159001)
• يمكنك الآن استخدام PlatformTextStyle(emojiSupportMatch) لإيقاف معالجة الرموز التعبيرية بشكل اختياري لفقرة واحدة. (Ia7100، b/139326806)
• ستنفّذ اختبارات واجهة المستخدم في Android Compose الآن عمليات عرض لكل إطار عند تنفيذ الإطارات للوصول إلى حالة عدم النشاط (على سبيل المثال، من خلال waitForIdle). وقد يؤثّر ذلك في الاختبارات التي تؤكّد على إطارات فردية من الرسوم المتحركة للتصميم. (I8ea08، b/222093277)
• تمت إضافة TextMotion تجريبية إلى TextStyle لتحديد ما إذا كان النص Static(default) أو متحركًا. استخدِم TextMotion.Animated إذا كان سيتم تغيير حجم النص أو ترجمته أو تدويره من خلال الرسوم المتحركة. (I24dd7)

الإصدار 1.4.0-rc01

‫8 مارس 2023

تم طرح androidx.compose.ui:ui-*:1.4.0-rc01. يتضمّن الإصدار 1.4.0-rc01 هذه التعديلات.

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

• تمت إضافة تحميل زائد للدالة المركّبة AndroidView، والتي تقبل المَعلمة onReset. يسمح بإعادة استخدام مثيلات View عندما يتم تجاهل عقدتها في التركيب وإعادة استخدامها بطريقة متوافقة. ويفيد ذلك بشكل خاص في LazyRows وLazyColumns من "طرق العرض". (I3f10d، b/230099236)
• تم طرح واجهة برمجة التطبيقات الجديدة PlatformTextInputAdapter ذات المستوى المنخفض لإنشاء عمليات تنفيذ مخصّصة لإدخال النصوص تتواصل مباشرةً مع واجهات برمجة التطبيقات الخاصة بالمنصة. (I58df4)

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

• سيعدّل الإجراء الدلالي BasicTextField في SetText الآن مخزن النص المؤقت باستخدام مسار الرمز البرمجي نفسه المستخدَم في تعديلات IME ووظائف الاختبار (مثل performTextReplacement).
• تستخدم دوال اختبار النصوص performTextClearance وperformTextReplacement وperformTextSelection الآن SemanticsActions. (I0807d، b/269633168، b/269624358)

الإصدار 1.4.0-beta02

‫22 فبراير 2023

تم طرح androidx.compose.ui:ui-*:1.4.0-beta02. يتضمّن الإصدار 1.4.0-beta02 هذه التعديلات.

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

• تمت إزالة واجهة برمجة التطبيقات modifierElementOf(). يُرجى تمديدها من ModifierNodeElement مباشرةً بدلاً من ذلك. (I2256b)
• تمت إضافة Modifier.Node.onReset() ردّ اتصال جديد يتيح لك إعادة ضبط بعض الحالات المحلية للتعامل بشكل صحيح مع الحالة التي سيتم فيها إعادة استخدام Layout (على سبيل المثال، كعنصر من LazyColumn). تم إصلاح FocusTargetModifierNode لإعادة ضبط وضع التركيز بشكل صحيح. (I65495، b/265201972)
• تمت إضافة المَعلمة BlendMode إلى الطرق DrawScope.drawText وParagraph.paint وMultiParagraph.paint لتوفير خوارزميات دمج مختلفة عند رسم نص على Canvas. (I57508)

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

• تم تحسين خوارزمية ترتيب التركيز على إمكانية الوصول، على سبيل المثال، تتم قراءة الأشرطة العلوية/السفلية غالبًا أولاً/أخيرًا على التوالي (74e9c5)

الإصدار 1.4.0-beta01

‫8 فبراير 2023

تم طرح androidx.compose.ui:ui-*:1.4.0-beta01. يتضمّن الإصدار 1.4.0-beta01 هذه التعديلات.

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

• تمت إعادة تسمية "PinnableContainer.PinnedHandle.unpin()" إلى "release()" (I4667a)
• تمت إضافة waitUntilNodeCount وwaitUntilAtLeastOneExists وwaitUntilExactlyOneExists وwaitUntilDoesNotExist كواجهة برمجة تطبيقات تجريبية إلى ComposeTestRule، ما يؤدي إلى توسيع نطاق واجهة برمجة التطبيقات waitUntil لقبول أي أداة مطابقة وأي عدد من العُقد. يمكنك الاطّلاع على ComposeTestRule للحصول على مستندات إضافية. (Ifa1b9، b/226934294)
• تمّت إعادة تسمية Font.MaximumAsyncTimeout إلى Font.MaximumAsyncTimeoutMillis. (I07af5)
• تمت إزالة GoogleFont.Provider.AllFontsListUri وإضافة رابط إليها في ktdoc بدلاً من ذلك. (I16f29)

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

• إضافة مستندات لـ AndroidFont.fontVariationSettings (I7d9e2)

الإصدار 1.4.0-alpha05

‫25 يناير 2023

تم طرح androidx.compose.ui:ui-*:1.4.0-alpha05. يتضمّن الإصدار 1.4.0-alpha05 هذه التعديلات.

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

• تم طرح عمليات تحميل تجريبية جديدة للدالة runComposeUiTest والدالتين create*ComposeRule اللتين تقبلان المَعلمات CoroutineContext. سيتم استخدام السياق في تركيبة الاختبار وأي طلبات LaunchedEffect وrememberCoroutineScope() في التركيبة. (I10614، b/265177763)
• إضافة واجهة برمجة تطبيقات جديدة لتتبُّع السرعة الأحادية البُعد (If5a82)
• تم الآن وضع علامة @Stable على "FocusRequester". (I580ee)
• أزِل تعليقًا توضيحيًا تجريبيًا من الدالة الإنشائية DialogProperties التي تأخذ المَعلمة usePlatformDefaultWidth. (Ic4048)
• تمت إضافة دالة لاحتساب الموضع والمماس على مسافة معيّنة على مسار - باستخدام PathMeasure.getPosition() وPathMeasure.getTangent() (I3b47c)
• تمت إزالة أداة ضبط عامة تم الكشف عنها عن طريق الخطأ في ‎PlatformParagraphStyle. (I07f47)
• المزيد من أنواع/إمكانية قبول القيم الفارغة للدالات المضمّنة/المخفية التي تم إيقافها نهائيًا (I24f91)
• أضِف AnnotatedString.hasStringAnnotations للاستعلام عن التعليقات التوضيحية التي تتضمّن عمليات تخصيص بقيمة صفر. (I94dfe، b/246960758)
• تمت إضافة تحميل زائد جديد للدالة TextMeasurer.measure يقبل String كنص. (I47b2d، b/242705342)
• تمت ترقية واجهتَي برمجة التطبيقات LineBreak وHyphens في TextStyle إلى إصدار ثابت. (Ic1e1d)

المساهمة الخارجية

• لن يتم إيقاف طريقتَي notifyFocusedRect في TextInputSession وTextInputService نهائيًا مرة أخرى. (I23a04، b/262648050)

الإصدار 1.4.0-alpha04

‫11 يناير 2023

تم طرح androidx.compose.ui:ui-*:1.4.0-alpha04. يتضمّن الإصدار 1.4.0-alpha04 هذه التعديلات.

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

• تمت إضافة واجهة برمجة تطبيقات PinnableContainer جديدة تتيح تثبيت عناصر القائمة الكسولة، حتى لا يتم تجاهلها عند التمرير خارج الحدود. على سبيل المثال، تستخدم Modifier.focusable() هذه الآلية لتثبيت العنصر الذي يتم التركيز عليه حاليًا. (Ib8881، b/259274257، b/195049010)
• تمت إعادة كتابة نظام التركيز باستخدام واجهات برمجة التطبيقات التجريبية الجديدة Modifier.Node. (I7f4d7 وb/247708726 وb/255352203 وb/253043481 وb/247716483 وb/254529934 وb/251840112 وb/251859987 وb/257141589)
• تمت إضافة السمة الدلالية IsContainer في Surfaces. سيتم استخدام هذه السمة في تغيير لاحق يحدّد ترتيب الانتقال استنادًا إلى المعنى الدلالي للعناصر، مثل المساحات. (I63379)
• تمت إضافة دور جديد لتسهيل الاستخدام DropdownList. يمكن استخدام هذا الخيار لتكرار سلوك TalkBack's عند التركيز على android.widget.Spinner. (I177e5، b/236159001)
• يمكنك الآن استخدام PlatformTextStyle(emojiSupportMatch) لإيقاف معالجة الرموز التعبيرية بشكل اختياري لفقرة واحدة. (Ia7100، b/139326806)
• ستنفّذ اختبارات واجهة المستخدم في Android Compose الآن عمليات عرض لكل إطار عند تنفيذ الإطارات للوصول إلى حالة عدم النشاط (على سبيل المثال، من خلال waitForIdle). وقد يؤثّر ذلك في الاختبارات التي تؤكّد على إطارات فردية من الرسوم المتحركة للتصميم. (I8ea08، b/222093277)
• تمت إضافة TextMotion تجريبية إلى TextStyle لتحديد ما إذا كان النص Static(default) أو متحركًا. استخدِم TextMotion.Animated إذا كان سيتم تغيير حجم النص أو ترجمته أو تدويره من خلال الرسوم المتحركة. (I24dd7)

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

• تم استبدال الوسيط maxSize: IntSize في drawText بالوسيط size: Size ليتوافق مع دوال DrawScope الأخرى. يتم ضبط size على Size.Unspecified تلقائيًا، ما لا يؤدي إلى تغيير السلوك التلقائي السابق. (Icd27d)
• تمت إزالة أداة إنشاء الخط التجريبية المتوقّفة نهائيًا. (I8a724، b/261435386)
• يحتوي الآن فئة بيانات أدوات واجهة المستخدم Group على حقل isInline يشير إلى ما إذا كانت المجموعة مخصّصة لاستدعاء دالة قابلة للإنشاء مضمّنة. إذا كانت قيمة isInline هي true، يعني ذلك أنّ الاستدعاء يخص دالة مركّبة مضمّنة. ومع ذلك، قد تكون القيمة خطأ بالنسبة إلى عمليات استدعاء الدوال المركّبة المضمّنة من الوحدات التي يتم تجميعها باستخدام إصدار من مكوّن Compose الإضافي للمجمّع لا ينشئ معلومات الدالة المضمّنة. (Idb846)
• تمت ترقية عدد من واجهات برمجة التطبيقات التجريبية السابقة إلى إصدار ثابت
• أصبح Rotary Scroll Event API ثابتًا الآن (I42ad3، b/261561229)
• أصبحت واجهة برمجة التطبيقات FontVariation ثابتة الآن (I8779f، b/241016309)
• أصبحت جميع دوال إنشاء Font() الآن واجهة برمجة تطبيقات ثابتة (I5948b وb/261435386).
• أصبحت DeviceFontFamilyName الآن إصدارًا ثابتًا (I8b640، b/261435386)
• أصبحت الدالة الإنشائية AndroidFont التي تتضمّن variationSettings الآن واجهة برمجة تطبيقات ثابتة، ويمكن استخدامها لإنشاء أنواع جديدة من واصفات الخطوط. (I5adcc، b/261565807)
• أصبحت واجهة برمجة التطبيقات createFontFamilyResolver ثابتة الآن. يمكن استخدام هذا الإعداد لرصد الاستثناءات غير المعالَجة أثناء تحميل الخطوط بشكل غير متزامن. (Ibb481، b/261435386)
• أصبحت واجهة برمجة التطبيقات Font.loadingStrategy ثابتة الآن. (I5937c، b/261435386)
• أصبحت واجهة برمجة التطبيقات GoogleFont ثابتة الآن. (Ic90b0، b/261435386)
• أصبحت واجهة برمجة التطبيقات TextUnit(float, TextUnitType) الآن واجهة برمجة تطبيقات ثابتة. (I90c84، b/261561612)
• أصبحت pluralStringResource الآن واجهة برمجة تطبيقات ثابتة. (I09849، b/261439703)

الإصدار ‎1.4.0-alpha03

‫7 ديسمبر 2022

تم طرح androidx.compose.ui:ui-*:1.4.0-alpha03. يتضمّن الإصدار 1.4.0-alpha03 هذه التعديلات.

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

• إزالة ExperimentalComposeUiApi من PointerIcon (I23af8)
• إضافة إجراءات تسهيل استخدام الصفحة: PageUp وPageDown وPageLeft وPageRight يُرجى العِلم أنّ هذه الميزات لا تتوفّر إلا من الإصدار 29 من واجهة برمجة التطبيقات. (Ida4ab)
• تم تعديل عرض المَعلمة rememberNestedScrollConnection من العرض الجذر إلى عرض المضيف. (Ia5200)
• تمت إضافة Modifier API للاستعلام عن معلومات التمرير الخاصة بالعناصر الرئيسية. (I2ba9d، b/203141462)
• يُستخدَم في Clickable لتأخير تفاعلات الضغط بشكل صحيح، عندما يمكن أن تصبح الإيماءات أحداث تمرير.
• تم إصلاح المشكلة التي كانت تتسبّب في عدم تأخير تأثيرات التموّج بشكل صحيح عند استخدام Clickables داخل Scrollable ViewGroup.
• تم تعديل الأدراج وأوراق البيانات لتأخير الضغطات بشكل صحيح في حال إمكانية تحوّل الإيماءات إلى أحداث تمرير.
• تمت إعادة تسمية CompositingStrategy.Always إلى Offscreen للإشارة إلى أنّه سيتم دائمًا عرض graphicsLayer في مخزن مؤقت وسيط (I47dc1)
• أصبح التحميل الزائد للتنسيق مع خانات محتوى متعدّدة ثابتًا الآن (I10566، b/248294649)
• تمت إضافة واجهتَي برمجة تطبيقات تجريبيتين جديدتين PerfettoTrace.record {} وPerfettoTraceRule لتسجيل بيانات تتبُّع Perfetto (المعروفة أيضًا باسم "بيانات تتبُّع النظام") كجزء من الاختبار، وذلك لفحص سلوك الاختبار وأدائه. (I3ba16)
• في اختبارات واجهة المستخدم التي تستخدم قاعدة Compose، لن يتم إرسال عمليات الاستئناف التي تم استئنافها أثناء عمليات معاودة الاتصال withFrameNanos إلا بعد انتهاء جميع عمليات معاودة الاتصال بإطارات التشغيل. يتطابق ذلك مع سلوك Compose عند تشغيله بشكل طبيعي. ومع ذلك، قد يتعذّر إجراء الاختبارات التي تعتمد على السلوك القديم. يجب أن يؤثر ذلك فقط في الرمز الذي يستدعي withFrameNanos أو withFrameMillis مباشرةً، ويتضمّن منطقًا خارج دالة رد الاتصال التي تم تمريرها إلى هاتين الدالتين، وقد يحتاج إلى نقلها إلى داخل دوال رد الاتصال. يمكنك الاطّلاع على التغييرات في اختبار الصورة المتحركة في طلب التغيير هذا للحصول على أمثلة.
• تمت إضافة المَعلمة الاختيارية onPerformTraversals: (Long) -> Unit إلى الدالة الإنشائية TestMonotonicFrameClock ودالة المصنع لتنفيذ الرمز بعد عمليات رد الاتصال withFrameNanos ولكن قبل استئناف إجراءات الروتين الفرعي للمتصلين. (Idb413، b/254115946، b/222093277، b/255802670)
• إضافة EmojiCompat إلى Compose (Ibf6f9، b/139326806)
• تمت إضافة مَعلمة خلفية جديدة إلى @Preview لإتاحة الألوان الديناميكية (I9f512)

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

• يتم الآن إرسال إشعارات تطبيق اللقطة بعد انتهاء Recomposer من تطبيق التغييرات. (Iad6c0، b/222093277)
• تم إجراء تغييرات في captureToImage للسماح بالتقاط لقطات شاشة في نوافذ متعدّدة. ويكون ذلك مفيدًا لاختبارات لقطات الشاشة التي تستخدم PopUp في Compose. (I169c5)

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

• تعتمد مكتبتا Compose UI وCompose Material الآن على الإصدار 2.5.1 من Lifecycle. (I05ab0، b/258038814)

الإصدار 1.4.0-alpha02

‫9 نوفمبر 2022

تم طرح androidx.compose.ui:ui-*:1.4.0-alpha02. يتضمّن الإصدار 1.4.0-alpha02 هذه التعديلات.

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

• تم تعديل GraphicsLayerScope لعرض الحجم الحالي لـ graphicsLayer. ويكون ذلك مفيدًا لاحتساب عمليات التحويل graphicsLayer كدالة لحجم Composable. (If8c43،b/181387080)
• تمت إضافة CompositingStrategy لتحديد وقت استخدام طبقة تركيب خارج الشاشة لعرض محتوى graphicsLayer. تحتفظ Auto بالسلوك التلقائي الذي يستفيد داخليًا من طبقة إذا تم تطبيق ألفا أو RenderEffect/Overscroll. سيؤدي ضبط Always إلى عرض مخزن مؤقت خارج الشاشة، حيث سيتجنّب ModulateAlpha استخدام مخزن مؤقت خارج الشاشة، وبدلاً من ذلك سيعدّل كل تعليمات الرسم المسجّلة ضمن graphicsLayer. سيظل استخدام ModulateAlpha يستفيد من المخزن المؤقت خارج الشاشة لاستخدامات RenderEffect/Overscroll (I25e82، b/256382834).
• تمت إضافة invalidateSubtree() إلى Modifier.Node للسماح بإبطال التسلسلات الهرمية بأكملها للتنسيق والرسم. (I4bd90)
• ترقية rememberNestedScrollInteropConnection إلى الإصدار الثابت تم توفير إمكانية تمرير طريقة عرض جذر إلى rememberNestedScrollInteropConnection. يمكن أن يساعد ذلك في أن تتفاعل طريقة العرض المخصّصة بشكل أفضل مع قيود التمرير، خاصةً في طرق العرض غير العادية (مثل ModalBottomSheetDialog). (I9e107)
• تمّت إضافة واجهة ObserverNode يمكن استخدامها من خلال عمليات تنفيذ Modifier.Node التي يجب إعلامها عند تغيير قيمة سبق أن قرأتها (I5728b، b/247716483)
• تمت إضافة منشئ جديد إلى Paint يقبل android.graphics.Paint أصليًا. تمت أيضًا إضافة دالة إضافية toComposePaint() تحوّل عنصر Paint أصليًا حاليًا إلى Compose Paint. (Ica91b)
• أضِف FontFamily.Resolver.resolveAsTypeface جديدًا لاستخدامه على Android. (I8950b)
• إضافة ToolingState للسماح للأدوات بتغيير الحالات الداخلية لـ Composable (Ie6614)
• إعادة تصميم الأدوات لتوفير دعم أفضل للرسوم المتحركة الجديدة المضافة (I8677b)
• تمت إضافة المَعلمة minLines إلى النص في Material وMaterial3، وTextField وOutlinedTextField، ما يتيح ضبط الحد الأدنى لارتفاع المكوّن من حيث عدد الأسطر (I4af1d)

الإصدار 1.4.0-alpha01

‫24 أكتوبر 2022

تم طرح androidx.compose.ui:ui-*:1.4.0-alpha01. يتضمّن الإصدار 1.4.0-alpha01 هذه التعديلات.

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

• تمت إضافة طريقة جديدة، awaitEachGesture()، لأدوات رصد الإيماءات. تعمل هذه السمة بشكل مشابه للسمة forEachGesture()، ولكن يتم تنفيذ حلقة الإيماءات بالكامل داخل AwaitPointerEventScope، وبالتالي لا يمكن فقدان الأحداث بين التكرارات.
• تم إيقاف forEachGesture() نهائيًا واستبداله بـ awaitEachGesture() لأنّه يسمح بفقدان الأحداث بين الإيماءات. (Iffc3f، b/251260206)
• إيقاف إعادة استخدام عناصر تسهيل الاستخدام نهائيًا في androidx لقد تبيّن لنا أنّ التغييرات في الأداء لا تُذكر حتى في أقدم الإصدارات المتوافقة. (I0a961)
• تمت إضافة DrawStyle كسمة تجريبية إلى TextStyle وSpanStyle لتفعيل رسم نص محدّد. (If24b8، b/155421273)
• تستخدم AnnotatedString.Builder الآن kotlin.text.Appendable. (I1a061، b/231030444)
• تتضمّن AnnotatedString.Builder الآن طريقة append(AnnotatedString, start: Int, end: Int) لإلحاق سلسلة فرعية من AnnotatedString والأنماط المتقاطعة.
• تمت إضافة المَعلمة DrawStyle إلى دالتَي الطلاء Paragraph وMultiParagraph اللتين تتيحان رسم نص محدّد. (Ic8102، b/155421273)

المساهمة الخارجية

• شكرًا على vighnesh لإضافة أجهزة التلفزيون إلى المعاينات (Ie15cd)

الإصدار 1.3

الإصدار 1.3.3

‫11 يناير 2023

تم طرح androidx.compose.ui:ui-*:1.3.3. يتضمّن الإصدار 1.3.3 هذه التعديلات.

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

• إصلاح عُطل يحدث أحيانًا على Android 9 عند حفظ النشاط لحالة "عرض Compose". (I0b755، b/260322832)

الإصدار 1.3.2

‫7 ديسمبر 2022

تم طرح androidx.compose.ui:ui-*:1.3.2. يتضمّن الإصدار 1.3.2 هذه التعديلات.

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

• تم تعديلها لاستخدام Profobuf 3.21.8، ما يمنع ظهور تنبيه أمني في protobuf-javalite:3.19.4 (CVE-2022-3171) (b/255545055)

الإصدار 1.3.1

‫9 نوفمبر 2022

تم طرح androidx.compose.ui:ui-*:1.3.1. يتضمّن الإصدار 1.3.1 هذه التعديلات.

الإصدار 1.3.0

‫24 أكتوبر 2022

تم طرح androidx.compose.ui:ui-*:1.3.0. يتضمّن الإصدار 1.3.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.2.0

• مجموعة جديدة تجريبية من واجهات برمجة التطبيقات LookaheadLayout (تتيح سلوكيات رسوم متحركة لم يكن من الممكن تنفيذها سابقًا)
• مجموعة جديدة تجريبية من واجهات برمجة التطبيقات Modifier.Node (بديل Modifier.composed ذو أداء أفضل)
• تحسين توافُق حواف النوافذ
• إتاحة التركيز على لوحات D-Pad ولوحات المفاتيح الخارجية في LazyLists
• تم تقليل الحد الأقصى للارتفاع المسموح به في مربّعات الحوار والنوافذ المنبثقة إلى 8 وحدات بكسل (تغيير في السلوك يؤدي إلى حدوث مشاكل في بعض أنظمة التصميم المخصّصة – الأساس المنطقي في ملاحظات الإصدار beta01)
• العديد من التحسينات البسيطة غير المتوافقة مع الإصدارات السابقة في واجهة برمجة التطبيقات
• إصلاح العديد من الأخطاء وتحسينات في الأداء

الإصدار 1.3.0-rc01

‫5 أكتوبر 2022

تم طرح androidx.compose.ui:ui-*:1.3.0-rc01. يتضمّن الإصدار 1.3.0-rc01 هذه التعديلات.

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

• تمت إضافة واجهة برمجة التطبيقات التجريبية الجديدة Hyphens لإتاحة التقطيع التلقائي للكلمات في النص (Iaa869)

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

• لن يتم تلقائيًا ضبط إعدادات wght وital المتغيرة لخطوط DeviceFontFamilyName، بل سيتم استخدام إعدادات النظام الأساسي لخطوط Typeface التي تم تحميلها. (Ia7a6d، b/246989332)
• تم إصلاح مشكلة تسريب الذاكرة LazyColumn - لم يتم استدعاء onModifierLocalsUpdated بالقيمة التلقائية عند إعادة استخدام المعدِّلات (b/230168389)

الإصدار 1.3.0-beta03

‫21 سبتمبر 2022

تم طرح androidx.compose.ui:ui-*:1.3.0-beta03. يتضمّن الإصدار 1.3.0-beta03 هذه التعديلات.

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

• إضافة خيارات لتخصيص تقسيم الأسطر في "النص" (I86907)
• تم تغيير وسيطة size:IntSize باستخدام constraints: Constraints في طريقة TextMeasurer.measure لتوفير قيود الحد الأدنى للعرض. (I37530، b/242707525)

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

• تعمل واجهة برمجة التطبيقات BackHandler الخاصة بـ AndroidX Activity الآن ضمن عنصر Dialog قابل للإنشاء. (I35342)

الإصدار ‎1.3.0-beta02

‫7 أيلول (سبتمبر) 2022

تم طرح androidx.compose.ui:ui-*:1.3.0-beta02. يتضمّن الإصدار 1.3.0-beta02 هذه التعديلات.

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

• تمت إضافة تحميل تجريبي زائد للسمة Layout يقبل قائمة من عدة دوال لامدا قابلة للإنشاء، ما يتيح التعامل مع العناصر القابلة للقياس التي يتم وضعها في دوال لامدا مختلفة للمحتوى بشكل مختلف (Ic1b4e)

التغييرات في واجهات برمجة التطبيقات التجريبية الخاصة بميزة "التركيز":

• تم إيقاف FocusDirection.In وFocusDirection.Out نهائيًا واستبدالهما بـ FocusDirection.Enter وFocusDirection.Exit. (Ia4262، b/183746982)
• تمت إضافة سمتَي التركيز الجديدتَين enter وexit لتحديد سلوك مخصّص للعنصرَين FocusManager.moveFocus(Enter) وFocusManager.moveFocus(Exit). (I5f3f9، b/183746982)
• يمكنك الآن استخدام FocusRequester.Cancel لإلغاء حركة تركيز. يمكن استخدام FocusRequester.Cancel في أي من خصائص التركيز التالية: up وdown وleft وright وnext وprevious وstart وend وenter وexit. (Ib300f)

الإصدار 1.3.0-beta01

‫24 أغسطس 2022

تم طرح androidx.compose.ui:ui-*:1.3.0-beta01. يتضمّن الإصدار 1.3.0-beta01 هذه التعديلات.

إعادة هيكلة عقدة المعدِّل

تمت إعادة تصميم الطبقة التي تتعامل مع مثيلات Modifier/Modifier.Element وتنسّق سلوكها على LayoutNodes بشكل كبير. في الوقت الحالي، كان هذا إعادة تصميم لم تؤثّر في واجهة برمجة التطبيقات العامة لأي من المعدِّلات العديدة في Compose، ويمكن اعتبارها تغييرًا على مستوى التنفيذ فقط. مع ذلك، هذا تغيير مهم لعدة أسباب. (Ie4313)

ملخّص التغييرات

توفّر واجهات برمجة التطبيقات التجريبية Modifier.Node المُضافة تجريدًا يتيح الحفاظ على الحالة في مثيل سيتم الاحتفاظ به مع مراحل نشاط عقدة التصميم، وسيتم تخصيصه لكل عقدة تصميم ولكل استخدام لعنصر Modifier.Element المقابل الذي أنشأه.

وبشكل عام، يوفّر هذا التجريد آلية بديلة لإنشاء معدِّلات ذات حالة بدون الاعتماد على آليات واجهة برمجة التطبيقات Modifier.composed.

المخاطرة

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

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

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

تمت إضافة واجهات برمجة تطبيقات تجريبية مختلفة، وكلها مرتبطة بالمفهوم الجديد "عقدة المعدِّل". يتم إنشاء Modifier.Node’s نتيجةً لما يلي:

• fun modifierElementOf(…): Modifier
• abstract class ModifierNodeElement
• abstract class Modifier.Node
• abstract class DelegatingNode
• interface LayoutModifierNode
• interface DrawModifierNode
• interface SemanticsNode
• interface PointerInputNode
• interface ModifierLocalNode
• interface ParentDataModifierNode
• interface LayoutAwareModifierNode
• interface GlobalPositionAwareModifierNode
• interface IntermediateLayoutModifierNode

تغيير في السلوك يؤدي إلى حدوث خطأ

تم تخفيض الحد الأقصى للارتفاع المتاح في مربّعات الحوار والنوافذ المنبثقة إلى 8 وحدات بكسل مستقلة الكثافة.

تم خفض الحد الأقصى للارتفاع المسموح به في مربّعات الحوار والنوافذ المنبثقة في Compose من 30dp إلى 8dp. يؤثّر هذا التغيير في مربّعات الحوار المخصّصة والنوافذ المنبثقة لكلّ من Material وUI. تم إجراء هذا التغيير للحدّ من خطأ في إمكانية الوصول على إصدارات Android الأقدم من الإصدار S، ولضمان قدرة خدمات تسهيل الاستخدام داخل هذه النوافذ على التفاعل مع المحتوى داخل مربّع الحوار أو النافذة المنبثقة.

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

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

• تم إصلاح مشكلة عدم تعديل painterResource عند إجراء تغييرات في الإعدادات (I58e73، b/228862715)
• لم يعُد rememberTextMeasurer يقبل المَعلمات FontFamily.Resolver أو Density أو LayoutDirection. يُرجى استخدام أداة الإنشاء TextMeasurer لتقديم قيم مخصّصة لهذه المَعلمات. (Ia1da3)
• تمت إضافة السمة DialogProperties.decorFitsSystemWindows لإتاحة استخدام WindowInsets في مربّعات الحوار. (I57742، b/229378542)
• تم نقل دوال إنشاء الخطوط إلى ملف Kotlin الأصلي للحفاظ على التوافق الثنائي. لم يطرأ أي تغيير مقارنةً بآخر إصدار ثابت. (Ieb2f3)
• تمت إزالة عامل تشغيل غير ضروري من عدة تعريفات متساوية، وهذا ليس له أي تأثير. (I6c309)
• ‫FontVariation.Setting هي واجهة محكمة الإغلاق، وذلك للسماح بواجهات برمجة تطبيقات مستقبلية للحدّ من القيم. (I11021، b/143703328)
• أضِف CompositionGroup.findParameters إلى SlotTree.kt. يتيح ذلك للأدوات استرداد مَعلمات CompositionGroup بدون الحاجة إلى تحليل جدول الخانات الإعلانية بالكامل. (I124fe)

الإصدار 1.3.0-alpha03

‫10 أغسطس 2022

تم طرح androidx.compose.ui:ui-*:1.3.0-alpha03. يتضمّن الإصدار 1.3.0-alpha03 هذه التعديلات.

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

• أصبحت LayoutCoordinates.findRootCoordinates() متاحة للجميع (I7fa37، b/204723384)
• تمت إضافة واجهة برمجة تطبيقات تجريبية للحصول على LayoutCoordinates في PlacementScope. يتيح ذلك للمطوّرين معرفة مكان التنسيق الحالي لوضع العناصر الثانوية بالنسبة إلى موضعها. (I5482b، b/238632578)
• تمت إضافة LayoutCoordinates.transformFrom للحصول على تحويل المصفوفة من LayoutCoordinates إلى أخرى. (Ic5ab1، b/238632578)
• تم إيقاف SemanticsModifier.id نهائيًا ونقل رقم تعريف الدلالات إلى LayoutInfo.semanticsId بدلاً من ذلك. (Iac808، b/203559524)
• تتيح خطوط الموارد الآن ضبط إعدادات تنويع الخطوط (المستوى 26 من واجهة برمجة التطبيقات أو أعلى). (I900dd، b/143703328)
• إتاحة الخطوط المتغيّرة في DeviceFontFamilyNameFont (Ic1279، b/143703328)
• تقبل الآن دوال إنشاء الخطوط قائمة FontVariation.Setting لإعداد الخطوط المتغيرة على الأجهزة التي تعمل بالإصدار O+‎. (I11a9d، b/143703328)
• تمت إضافة واجهة برمجة التطبيقات FontVariation لتحديد الخطوط المتغيرة واستخدامها. (I3c40c، b/143703328)
• أصبح الدالة الإنشائية LineHeightStyle.Alignment عامة الآن (تجريبية) (I4bbbe، b/235876330)
• تم الآن تحديد الفقرة على أنّها expected|actual لكل من Android وأجهزة الكمبيوتر. (Id387e، b/239962983)
• أصبحت واجهة Paragraph الآن واجهة Paragarph محكمة الإغلاق. لا توجد حالة استخدام لتصنيف الفقرة، وننصحك بالتواصل معنا إذا كان هذا التغيير يؤثر فيك. (If5247، b/239962983)
• تمت إزالة التعليق التوضيحي التجريبي من PlatformTextStyle وLineHeightStyle. (I64bef)
• إيقاف TextInputService.show|hideSoftwareKeyboard يُرجى استخدام SoftwareKeyboardController بدلاً من ذلك في رمز التطبيق وTextInputSession في رمز إدارة محرّك طرق الإدخال. (I14e4c، b/183448615)
• إضافة واجهة برمجة تطبيقات جديدة لأنواع الرسوم المتحركة الحالية (I26179)

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

• تمت إضافة @RequiresPermission إلى واجهات برمجة التطبيقات التي تتطلّب منح إذن POST_NOTIFICATIONS على الإصدار 33 من حزمة تطوير البرامج (SDK) والإصدارات الأحدث. (Ie542e، b/238790278)

الإصدار 1.3.0-alpha02

‫27 يوليو 2022

تم طرح androidx.compose.ui:ui-*:1.3.0-alpha02. يتضمّن الإصدار 1.3.0-alpha02 هذه التعديلات.

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

• تمت إضافة السمة الجديدة PointerInputChange#pressure لاسترداد الضغط. (I45a5e، b/205164819)
• تمت إضافة rememberTextMeasurer لتسهيل إنشاء وتذكُّر مثيلات TextMeasurer في الكتابة. (I8d66e)
• تتيح Rect وRoundRect وMutableRect الآن استخدام بنية in في Kotlin لاستدعاء الدالة contains. (Ie42b0، b/238642990)
• أزِل الدوال غير الضرورية من KeyInjectionScope، لأنّه يمكن تنفيذها بسهولة باستخدام أجزاء أبسط من واجهة برمجة التطبيقات. تشمل الدوال التي تمت إزالتها pressKeys وkeysDown وkeysUp. (I81d77)
• تمت إعادة تصميم أسماء الثوابت والمَعلمات في KeyInjectionScope لتضمين اللاحقة "Millis" حيث تكون وحدات الثوابت والمَعلمات المذكورة بالملّي ثانية. (Iabef5)
• تمت إضافة طريقة toStringForLog() إلى EditCommand للمساعدة في تحديد المشاكل وحلّها المتعلّقة بتعديل النصوص. (I53354، b/228862731)
• تمت إضافة دالة الإضافة drawText إلى DrawScope لتوفير طريقة لرسم نص متعدد الأنماط على العناصر القابلة للإنشاء والمعدِّلات التي تعمل على DrawScope، مثل Canvas وdrawBehind. (I16a62، b/190787898)
• نقدّم واجهة برمجة تطبيقات تجريبية جديدة باسم TextMeasurer تتيح احتساب تخطيط نص عشوائي يؤدي إلى نتائج مطابقة لنتائج BasicText، بغض النظر عن وقت تشغيل Compose. (I17101)
• أضِف mapTree إلى SlotTree.kt. يتيح ذلك للأدوات فحص SlotTree بدون إنشاء نسخة في الذاكرة أولاً كما تفعل asTree. بالنسبة إلى "أداة فحص التصميم"، يؤدي ذلك إلى تحسين الأداء بمقدار 10 مرّات تقريبًا. (I5e113)
• تم تغيير "معاينة Compose" ليتم تخزينها في ملفات الإخراج الثنائية، وذلك للسماح للمطوّرين بكتابة وإعادة استخدام تعليقات توضيحية MultiPreview من المكتبات. (I85699، b/233511976)

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

• عند إضافة أحداث InputEventChange إلى أداة التتبُّع Velocity، سنأخذ في الاعتبار الآن الفروق بدلاً من المواضع، وسيضمن ذلك احتساب السرعة بشكلٍ صحيح في جميع الحالات حتى إذا تحرّك العنصر المستهدَف (Icea9d، b/216582726، b/223440806، b/227709803).
• تم إصلاح خطأ NPE الناتج عن AnnotatedString.toUpperCase عند توفّر التعليقات التوضيحية. (I0aca2، b/210899140)

الإصدار 1.3.0-alpha01

‫29 يونيو 2022

تم طرح androidx.compose.ui:ui-*:1.3.0-alpha01. يتضمّن الإصدار 1.3.0-alpha01 هذه التعديلات.

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

• LookaheadLayout جديد يتيح إجراء عملية بحث مسبق قبل القياس أو التخطيط الفعلي. يسمح ذلك بإجراء عملية حسابية مسبقة للتنسيق عند تغييره، مع السماح للمقياس/التنسيق بعد التوقّع المسبق باستخدام الحجم/الموضع المحسوب مسبقًا لتحريك الحجم والمواضع نحو الهدف. لا تتوفّر SubcomposeLayouts بعد، ولكن ستتوفّر في إصدار قادم. (I477f5)
• أضِف مَعلمة ألفا اختيارية إلى نكهة الفرشاة TextStyle وSpanStyle لتعديل عتامة Text بالكامل. (Ic2fac، b/234117635)
• تم تقديم نوع التعليق التوضيحي UrlAnnotation والطُرق المرتبطة به لتوفير إمكانية استخدام الروابط TalkBack في AnnotatedString. (I1c754، b/231495122)
• نقل وظائف الأداة إلى وقت التشغيل (I4f729)

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

• TextLayoutResult.getLineForOffset لا يطرح. (Idc5d6، b/235876324)

المساهمة الخارجية

• تمت إضافة واجهة برمجة تطبيقات جديدة WindowInfo.keyboardModifiers لمراقبة حالتها ضمن الدوال القابلة للإنشاء أو من خلال snapshotFlow (Icdb8a)

الإصدار 1.2

الإصدار 1.2.1

‫10 أغسطس 2022

تم طرح androidx.compose.ui:ui-*:1.2.1. يتضمّن الإصدار 1.2.1 هذه التعديلات.

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

• تم إصلاح الخطأ nullpointer في أداة الفحص (b/237987764)
• تم إصلاح استثناء تحويل الفئة أثناء التذكير في "أداة الفحص" (b/235526153)

الإصدار 1.2.0

‫27 يوليو 2022

تم طرح androidx.compose.ui:ui-*:1.2.0. يتضمّن الإصدار 1.2.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.1.0

• تحسينات في التنقّل بين العناصر باستخدام التركيز:

  • أصبح بإمكانك الآن استخدام ميزة التمرير المستند إلى التركيز في القوائم الكسولة، وذلك باستخدام واجهة برمجة التطبيقات BeyondBoundsLayout الأساسية الجديدة.
  • واجهات برمجة التطبيقات الجديدة لتخصيص السلوك في FocusOrder وFocusProperties
  • تحسين السلوك عند استخدام لوحة مفاتيح خارجية أو جهاز تحكّم عن بُعد في التلفزيون

• واجهات برمجة التطبيقات الجديدة لما يلي:

  • حواف النوافذ
  • العناصر الأساسية للرسوم المتحركة التي تعتمد على الإيماءات وغير المحدودة وتلك المتعلّقة بالتصميم
  • إمكانات GraphicsLayer، بما في ذلك RenderEffect

• إصلاح العديد من الأخطاء وتحسينات في الأداء

الإصدار 1.2.0-rc03

‫29 يونيو 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-rc03. يتضمّن الإصدار 1.2.0-rc03 هذه التعديلات.

• لم يتم إجراء أي تغييرات منذ الإصدار 1.2.0-rc02.

الإصدار 1.2.0-rc02

‫22 يونيو 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-rc02. يتضمّن الإصدار 1.2.0-rc02 هذه التعديلات.

الإصدار 1.2.0-rc01

‫15 يونيو 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-rc01. يتضمّن الإصدار 1.2.0-rc01 هذه التعديلات.

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

• أصبحت الواجهات في مكتبات Compose الآن تستخدم طرق الواجهة التلقائية في الإصدار 8 من حزمة تطوير البرامج (JDK) (I5bcf1).
• تمت إضافة وظائف من الدرجة العليا إلى KeyInjectionScope لإدخال ضغطات المفاتيح أثناء الضغط مع الاستمرار على مفاتيح أخرى أو تفعيلها أو إيقافها. وتشمل هذه الدوال withKeysDown وwithKeysToggled وما إلى ذلك. تمت أيضًا إضافة خصائص للتحقّق مما إذا كان مفتاح وصف معيّن مضغوطًا، على سبيل المثال، isCtrlDown للتحقّق مما إذا كان أي من مفتاحي التحكّم مضغوطًا. يمكنك الرجوع إلى KeyInjectionScope للاطّلاع على مستندات حول كل دالة. (I9f6cd، b/229831515)
• تم تقديم OverscrollEffect تجريبي للسماح بتأثيرات تجاوز حد التمرير المخصّصة، بالإضافة إلى عمليات التحميل الزائد Modifier.scrollable التي تقبلها.
• تم نقل LocalOverScrollConfiguration التجريبية من foundation.gesture إلى حزمة الأساس وإعادة تسميتها إلى LocalOverscrollConfiguration (If19fb، b/204650733)
• تمت إعادة تسمية runComposeUiTestWithoutActivity {} إلى runEmptyComposeUiTest {}، ما يجعله متوافقًا مع createEmptyComposeRule() (I6fed7)

الإصدار ‎1.2.0-beta03

‫1 يونيو 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-beta03. يتضمّن الإصدار 1.2.0-beta03 هذه التعديلات.

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

• تمت إضافة pressKeyTimes وisCapsLockOn والأصدقاء إلى KeyInjectionScope. بالإضافة إلى ذلك، تتيح واجهة برمجة التطبيقات الآن أنماط إدخال مجمّعة للماوس ولوحة المفاتيح، مثل النقر على زر الماوس مع الضغط باستمرار على مفتاح meta. (I4c8da، b/229831515)
• تمت إضافة دعم تجريبي لإدخال الأحداث الرئيسية. استخدِم performKeyInput لإرسال الأحداث الرئيسية، أو أرسِلها من خلال السمة key الخاصة بالعنصر MultiModalInjectionScope أثناء إيماءة إدخال متعدّدة الوسائط باستخدام performMultiModalInput. يمكنك الاطّلاع على KeyInjectionScope للحصول على مستندات حول واجهة برمجة التطبيقات. (Ic5000، b/229831515)
• أضِف GoogleFont.Provider.AllFontsListUri لاسترداد مصدر الإنترنت الأساسي لخطوط Google المتوافقة مع Android.
• تحسين رسائل الخطأ التي يتم إعادة طرحها عندما يتعذّر تحميل GoogleFonts في Compose (I0416c)

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

• عند إضافة أحداث InputEventChange إلى أداة Velocity Tracker، سنأخذ في الاعتبار الآن الفروق بدلاً من المواضع، وسيضمن ذلك احتساب السرعة بشكل صحيح في جميع الحالات حتى إذا تحرّك العنصر المستهدف (I51ec3 وb/216582726 وb/223440806 وb/227709803).
• سيتم الآن تطبيق إعداد Show Layout Bounds على العناصر القابلة للإنشاء مباشرةً بعد تفعيله أو إيقافه من مربّع الإعدادات السريعة، بدون الحاجة إلى الخروج من النشاط وإعادة الدخول إليه. (I843d5، b/225937688)
• لا يؤدي البحث عن سلسلة تسهيل الاستخدام إلى بدء تحميل الخط. في السابق، كان يحاول تحميل الخطوط لـ StyleSpans، ما كان يؤدي إلى حدوث أعطال إذا تمت الكتابة فوق FontFamily.Resolver. (I4609d)
• لن يؤدي الضغط على مفتاح الحذف للأمام عندما يكون المؤشر في نهاية حقل نص إلى حدوث عطل.
• تتطلّب الفئتان DeleteSurroundingTextCommand وDeleteSurroundingTextInCodePointsCommand الآن أن تكون وسيطات الدالة الإنشائية غير سالبة. (Ica8e6، b/199919707)

الإصدار ‎1.2.0-beta02

‫18 مايو 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-beta02. يتضمّن الإصدار 1.2.0-beta02 هذه التعديلات.

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

• إعادة استخدام الوظائف في أنواع المعاينات الأخرى (I19f39)

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

• تمت إعادة تسمية ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer إلى DisposeOnDetachedFromWindowOrReleasedFromPool لتعكس بشكل أفضل الحالات التي يتم فيها التخلص من العناصر، بدلاً من الحالات التي لا يتم فيها التخلص من العناصر. (If15ca)

الإصدار 1.2.0-beta01

‫11 مايو 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-beta01. يتضمّن الإصدار 1.2.0-beta01 هذه التعديلات.

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

• هذا هو الإصدار التجريبي الأول من الإصدار 1.2.

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

• تمت إضافة طريقة BeyondBoundsInterval تجريبية يمكن استخدامها في عمليات التنفيذ المخصّصة لطريقة LazyList عند ترتيب العناصر خارج الحدود المرئية (Ifabfb، b/184670295)
• أصبحت الإصدارات التي تتضمّن مفاتيح من Modifier.composed واجهة برمجة تطبيقات ثابتة (Ie65e4، b/229988420)
• تم تبسيط واجهة برمجة التطبيقات rememberNestedScrollConnection لاستخدام متغيرات محلية للإنشاء من أجل الحصول على معلومات العرض الحالية (I67ca7)
• يمكن الآن استخدام التعليق التوضيحي @ComposableTarget والتعليقات التوضيحية التي تحمل العلامة @ComposableTargetMarker في نطاق الملف باستخدام البادئة @file. سيؤدي استخدام تعليق توضيحي مستهدَف على مستوى نطاق الملف إلى افتراض أنّ جميع الدوال القابلة للإنشاء في الملف تهدف إلى استهداف أداة التطبيق المرتبطة. على سبيل المثال، يؤدي استخدام @file:UiComposable إلى الإعلان عن أنّ جميع دوال @Composable تستهدف أداة تطبيق واجهة مستخدم Compose. يجب أن توفّر الدالة التي تحتاج إلى استهداف أداة تطبيق أخرى بشكل صريح التعليق التوضيحي الخاص بعلامة الاستهداف لأداة التطبيق المطلوبة. (I40804)

• تم طرح واجهة برمجة تطبيقات تجريبية جديدة للاختبار، وهي مستقلة عن النظام الأساسي: interface ComposeUiTest وfun runComposeUiTest(block: ComposeUiTest.() -> Unit)، ويمكن استخدامهما لتشغيل اختبارات واجهة مستخدم Compose بدون الحاجة إلى TestRule. لتنفيذ اختبار بدون ComposeTestRule، مرِّر الاختبار كدالة lambda إلى runComposeUiTest، واستخدِم الطرق والعناصر في نطاق جهاز الاستقبال ComposeUiTest، وهي نفسها الموجودة في ComposeContentTestRule.

  تتم إضافة interface AndroidComposeUiTest وfun runAndroidComposeUiTest(block: AndroidComposeUiTest.() -> Unit) الخاصتَين بنظام التشغيل Android لتوفير إمكانية الوصول إلى النشاط الأساسي، على غرار AndroidComposeTestRule. للحصول على المزيد من التحكّم، يمكنك إنشاء class AndroidComposeUiTestEnvironment بنفسك.

  تتضمّن عملية التنفيذ على أجهزة الكمبيوتر المكتبي class DesktopComposeUiTest، ولكن لا تتوفّر حاليًا أي وظائف تشغيل خاصة بأجهزة الكمبيوتر المكتبي.

  يمكن نقل اختبار من ComposeTestRule إلى ComposeUiTest باتّباع الخطوات التالية (مثال على نظام التشغيل Android). من:

  @RunWith(AndroidJUnit4::class)
  class MyTest {
      @get:Rule val rule = createComposeRule()
      @Test
      fun test() {
          rule.setContent {
              Text("Hello Compose!")
          }
          rule.onNodeWithText("Hello Compose!").assertExists()
      }
  }
  

  إلى:

  @RunWith(AndroidJUnit4::class)
  class MyTest {
      @Test
      @OptIn(ExperimentalTestApi::class)
      fun test() = runComposeUiTest {
          setContent {
              Text("Hello Compose!")
          }
          onNodeWithText("Hello Compose!").assertExists()
      }
  }
  

• في الوقت الحالي، لا تتضمّن ComposeContentTestRule وComposeTestRule ميزات ComposeUiTest، ما يعني أنّه لا يمكن بعد استدعاء دوال الإضافة على ComposeUiTest من واجهة TestRule. عندما تنتقل ComposeUiTest إلى واجهة برمجة تطبيقات ثابتة، سيتم تغيير ComposeContentTestRule وComposeTestRule ليتم تمديدهما من ComposeUiTest. (Ib4e90)

• تمت إعادة تسمية "LineHeightBehavior" إلى "LineHeightStyle"

• تمت إعادة تسمية "LineVerticalAlignment" إلى "LineHeightStyle.Alignment"

• تمت إعادة تسمية LineHeightTrim إلى LineHeightStyle.Trim

• تمت إزالة قيم أداة الإنشاء التلقائية من LineHeightStyle (I582bf، b/181155707)

• تمت إضافة Brush إلى TextStyle وSpanStyle لتوفير طريقة لرسم نص بألوان متدرّجة. (I53869، b/187839528)

• تم تغيير السمتَين trimFirstLineTop وtrimLastLineBottom الخاصتَين بـ LineHeightBehavior إلى تعداد واحد: LineHeightTrim. تحتوي LineHeightTrim على قيم من 4 حالات محدّدة بواسطة قيمتَين منطقيتَين: FirstLineTop وLastLineBottom وBoth وNone (Ifc6a5 وb/181155707)

• تمت إضافة "LineHeightBehavior" إلى "TextStyle" و"ParagraphStyle". تتحكّم السمة LineHeightBehavior في ما إذا كان سيتم تطبيق ارتفاع السطر على أعلى السطر الأول وأسفل السطر الأخير. ويحدّد أيضًا محاذاة السطر في المساحة التي يوفّرها TextStyle(lineHeight).

  على سبيل المثال، يمكن الحصول على سلوك مشابه لما تحدّده خدمة CSS من خلال LineHeightBehavior(alignment = LineVerticalAlignment.Center, trimFirstLineTop=false, trimLastLineBottom = false).

• تعمل إعدادات trimFirstLineTop وtrimLastLineBottom بشكل صحيح فقط عندما تكون قيمة includeFontPadding هي "خطأ". (I97332، b/181155707)

• تم تغيير الدالتَين PlatformParagraphStyle.lerp وPlatformSpanStyle.lerp ليصبحا دالتَين من المستوى الأعلى (I9a268)

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

• توضّح مستندات PointerInputChange::copy الآن بشكل صحيح أنّها نسخة سطحية. (I182f5)
• إتاحة علامة الحذف الإيجازي عندما يكون الارتفاع محدودًا ولا يتسع لجميع أسطر النص (Ie528c، b/168720622)
• مفعَّلة تلقائيًا includeFontPadding. يمكنك إيقاف includeFontPadding باستخدام السمة TextStyle.platformTextStyle. في المستقبل القريب، سنغيّر السلوك التلقائي، ولكن إلى أن يحين ذلك الوقت، سيسمح لنا هذا التغيير بدمج تحسينات ارتفاع الأسطر (aosp/2058653) وحلّ مشاكل الاقتصاص TextField. (I01423، b/171394808)

المساهمة الخارجية

• تم الآن عكس اتجاه MouseInjectionScope.scroll(delta = someDelta) على Android عند التمرير عموديًا (إذا كانت قيمة someDelta موجبة، سيتم التمرير للأسفل) (Ifb697، b/224992993)

الإصدار ‎1.2.0-alpha08

‫20 أبريل 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha08. يتضمّن الإصدار 1.2.0-alpha08 هذه التعديلات.

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

• تم تصنيف وظائف pluralStringResource على أنّها تجريبية من أجل السماح بتطويرها لتوفير دعم أفضل للغة العربية في المستقبل. (If24e4)
• تقبل الآن الفئتان Paragraph وMultiParagraph المَعلمة Constraints. تكون قيمة Constraints.maxHeight غير فعّالة في الوقت الحالي، ولكنها ستتيح إجراء بعض العمليات الحسابية في المستقبل، مثل حذف بعض الأحرف استنادًا إلى الارتفاع. (I6afee، b/168720622)
• تقبل السمة SubcomposeSlotReusePolicy.getSlotsToRetain() الآن فئة مخصّصة تشبه MutableSet ولا تسمح بإضافة عناصر جديدة إليها. (Icd314)
• أصبح PointerIcon الآن واجهة @Stable (I9dafe)
• تم إيقاف الاستهلاك الجزئي (النزول أو الموضع) نهائيًا في PointerInputChange. يمكنك استخدام consume() لاستهلاك التغيير بالكامل. يمكنك استخدام isConsumed لتحديد ما إذا كان مستخدم آخر قد استهلك التغيير من قبل أم لا.
• تنشئ الدالة PointerInputChange::copy() الآن نسخة سطحية دائمًا. وهذا يعني أنّه سيتم استخدام نُسخ PointerInputChange عند استخدام إحدى النُسخ. إذا أردت إنشاء PointerInputChange غير مرتبط، استخدِم الدالة الإنشائية بدلاً من ذلك. (Ie6be4، b/225669674)
• تفعيل إمكانية التشغيل التفاعلي لميزة "التمرير المتداخل" بين Compose وView في الاتجاه Compose > View وهذا يعني أنّ العنصر الرئيسي الذي يتضمّن عناصر Compose سيتمكّن من تلقّي دلتا التمرير المتداخل من طريقة عرض التمرير المتداخل. (If7949، b/174348612)
• SemanticsProperty testTagsAsResourceId الجديد، والذي يمكن استخدامه لجعل Compose متوافقًا مع اختبارات UIAutomator المصمَّمة لنظام View (I39c20)
• عرض جميع الأوزان المتاحة لخطوط النظام على Android عند استخدام FontFamily.SansSerif سيتم استخدام أسماء الخطوط الاحتياطية، مثل sans-serif-medium، داخليًا على الإصدارات من 21 إلى 28 من واجهة برمجة التطبيقات. هذا تغيير في السلوك، لأنّه في السابق كان يتم توفير الأوزان 400 و700 فقط على الإصدارات من 21 إلى 28 من واجهة برمجة التطبيقات. (I380fe، b/156048036، b/226441992)
• أعاد المدرّبون "فقرة" و"فقرات متعدّدة" ترتيب الوسيطات الموضعية لتكون قبل الوسيطات الاختيارية. (Idafaa)
• تتلقّى السمة AndroidFont الآن typefaceLoader كمَعلمة للدالة الإنشائية. (I2c971)

الإصدار 1.2.0-alpha07

‫6 أبريل 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha07. يتضمّن الإصدار 1.2.0-alpha07 هذه التعديلات.

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

• تمت إضافة الدالة الجديدة Snapshot.withoutReadObservation { ... }. يسمح هذا الإجراء للمستخدمين بتنفيذ دالة lambda التي تم تمريرها بدون الاشتراك في تغييرات قيم الحالة التي تمت قراءتها أثناء هذا الرمز البرمجي. قد تجدها مفيدة في حالات الاستخدام التي تريد فيها الاستفادة من عمليات القراءة والكتابة الآمنة في سلاسل المحادثات المستندة إلى اللقطات، ولكنك تريد أن تتمكّن من قراءة القيمة بدون التسبّب في إعادة إنشاء أو إعادة قياس غير ضرورية. (I9f365، b/214054486)
• تتيح السمة consumeWindowInsets للإضافة في ComposeView للمطوّرين إيقاف استخدام WindowInsets على Android. يسمح ذلك بتطبيق WindowInsets بشكل منفصل على كل ComposeViews في التسلسل الهرمي بدون أن يتداخل بعضها مع بعض. (I0ef08، b/220943142)
• تمت إضافة KeyboardType.Decimal كبديل لـ Keyboard.Number لتضمين الفاصل العشري تحديدًا في محرر أسلوب الإدخال (IME). (Iec4c8، b/209835363)
• أصبحت واجهتا برمجة التطبيقات PointerEventType.Scroll وPointerEvent.scrollDelta ثابتتَين الآن (I574c5، b/225669674)
• تفعيل إمكانية التشغيل التفاعلي للتمرير المتداخل بين View وCompose لفئات View المتوافقة وهذا يعني أنّ Compose يمكنه الآن إرسال دلتا التمرير إلى عنصر رئيسي (متعاون) في العرض. (I5d1ac، b/174348612)
• تم تعديل FontFamily.Resolver لدمج إعداد تسهيل استخدام ميزة "النص الغامق" على مستوى النظام (I6c1e7)
• تم إيقاف Font(AssetManager, String, ...) نهائيًا واستبداله بـ Font(String, AssetManager, ...). هذه واجهة برمجة تطبيقات تجريبية. (I1c7a4)
• أضِف واصف خط جديدًا Font(DeviceFontFamilyName) للبحث اختياريًا عن الخطوط المثبَّتة على النظام أثناء سلاسل الخطوط الاحتياطية. (I30468، b/219754572)
• تمت إضافة إعدادات توافق مؤقتة لـ includeFontPadding في TextStyle/ParagraphStyle. يمكن تغيير includeFontPadding من خلال TextStyle(platformStyle = PlatformTextStyle(includeFontPadding = true/false)). هذا خيار إعداد مؤقت لتفعيل عملية نقل البيانات، وسيتم إزالته. (If47be، b/171394808)
• أضِف إضافة GoogleFont.Provider.isAvailableOnDevice للحصول على المساعدة في تصحيح الأخطاء. (I64e31)
• إضافة أداة إنشاء GoogleFont.Provider لاستخدامها مع @ArrayRes (Ic5ee1، b/225984280)
• تمت إعادة تسمية Compose GoogleFont إلى Font(GoogleFont)، وستظل واجهة برمجة التطبيقات ثابتة في ما عدا ذلك. (I125f2)

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

• تمت إضافة عملية فحص lint إلى material/Scaffold للتأكّد من استخدام المساحة المتروكة الداخلية (Ifb111)

الإصدار ‎1.2.0-alpha06

‫23 مارس 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha06. يتضمّن الإصدار 1.2.0-alpha06 هذه التعديلات.

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

• تمت إضافة إجراء RequestFocus الدلالي لطلب التركيز على العنصر المستهدف القابل للتركيز. (I17b71)
• تم تعديل عملية تحليل الرسومات المتجهة القابلة للرسم لتتيح عكس المحتوى تلقائيًا في VectorPainter إذا كان اتجاه التنسيق الحالي من اليمين إلى اليسار. (I79cd9، b/185760237)

• تم تعديل ألوان الظل/الإضاءة المحيطة لتصبح مَعلمات لاحقة للرمز Modifier.graphicsLayer من أجل توافق واجهة برمجة التطبيقات (I3f864، b/160665122)

• تمت إضافة عمليات تنفيذ تلقائية للون الظل/الخلفية في GraphicsLayerScope لضمان عدم حدوث تغييرات غير متوافقة في واجهة برمجة التطبيقات.

• تمت إضافة وقت الحدث إلى أحداث RSB (Ief8ae)

• تم الآن دمج "FocusOrder" في "FocusProperties"، وأصبحت "focusProperties()" تتضمّن الآن جميع إمكانات "focusOrder()". تم إيقاف FocusOrder وfocusOrder() نهائيًا. يجب استبدال focusOrder() الذي يقبل focusRequester بمعدِّل focusRequester() مع focusProperties(). ويتيح ذلك للمعدّلات فصل الاهتمامات بشكل أفضل. (I601b7)

• سيؤدي ترقية كلّ من RecyclerView وCompose الآن إلى تحسين أداء التمرير في RecyclerViews بشكلٍ كبير عند استخدام طرق عرض Compose كعناصر فرعية.

• إضافة ViewCompositionStrategy.Default كوسيلة لاسترداد الاستراتيجية التلقائية المضمّنة

• أضِف ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer، وهي الاستراتيجية التلقائية الجديدة التي تتعامل بشكل صحيح مع حاويات التجميع، مثل RecyclerView. (If7282)

• تمت إضافة إمكانية إضافة تعليقات توضيحية إلى فئات التعليقات التوضيحية باستخدام ‎ @Preview كخطوة أولى لإضافة ميزة "المعاينة المتعددة". يمكن استخدام هذه التعليقات التوضيحية لإضافة تعليقات توضيحية إلى طرق Composable أو فئات التعليقات التوضيحية الأخرى، والتي يمكن اعتبارها بعد ذلك كتعليقات توضيحية غير مباشرة باستخدام @Preview المحدّدة. (I12eff)

• تمت إضافة أجهزة مرجعية إلى قائمة الأجهزة في الإصدار @Preview (I071c9)

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

• تم تعديل واجهات برمجة تطبيقات الرسومات المتجهة لاستخدام التعليق التوضيحي القابل للإنشاء المناسب ‎ @VectorComposable بدلاً من ‎ @UiComposable (I942bc)
• إزالة crossinline من AnnotatedString.Builder.withStyle (If84d5)

المساهمة الخارجية

• compose-ui: إضافة السمتَين ambientShadowColor وspotShadowColor إلى GraphicsLayerScope (I1ba1a، b/160665122)
• يمكن الآن استخدام الموارد بصيغة الجمع من خلال دوال pluralStringResource. (Ib2f23، b/191375123)

الإصدار ‎1.2.0-alpha05

‫9 مارس 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha05. يتضمّن الإصدار 1.2.0-alpha05 هذه التعديلات.

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

• تتلقّى الدالة TextToolbar الآن وسيطات lambda بدلاً من ActionCallback. (Ib2eb9، b/197950089)
• تم تعديل إمكانية القيم الخالية في حزمتَي core وappcompat لتتوافق مع الإصدار التجريبي الثاني من Tiramisu (I0cbb7)
• تعرض واجهة القياس الآن السمة parentData (I3313f)
• أصبحت اللغة Modifier.onPlaced وواجهة OnPlacedModifier ثابتتَين الآن. (Ib5482)
• خبر سار! تتيح ميزة "إنشاء صورة متحركة" الآن إعداد "مقياس مدة الرسوم المتحركة" من "خيارات المطوّرين". (I5a4fc، b/161675988)
• تمت إضافة معدِّل BeyondBoundsLayout محلي (If8b51، b/184670295)
• النص: تم الآن إيقاف includeFontPadding تلقائيًا. تم حلّ مشاكل الاقتصاص الناتجة عن includeFontPadding=false، ولن يحدث أي اقتصاص للنصوص البرمجية الطويلة. (I31c84، b/171394808)

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

• سيؤدي استدعاء ComposeContentTestRule.setContent الآن إلى عرض IllegalStateException إذا حاولت ضبط المحتوى عندما يكون هناك محتوى حالي. (I888a5، b/199631334)
• تم إصلاح عُطل ناتج عن محتوى الحافظة أثناء القراءة من الحافظة على جهاز Android. (I06020، b/197769306)
• تحسين عيّنات التمرير في "الملخّصات من Google" (I6a596)

المساهمة الخارجية

• تم تعديلها لاستخدام الإصدار 1.6.0 من أنماط "كوروتين" في Kotlinx (I3366d)

الإصدار ‎1.2.0-alpha04

‫23 فبراير 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha04. يتضمّن الإصدار 1.2.0-alpha04 هذه التعديلات.

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

• تمت إضافة ComposableTarget وComposableTargetMarker وComposableOpenTarget التي تتيح إعداد تقارير في وقت التجميع عن الحالات التي يتم فيها استدعاء دالة مركّبة تستهدف واجهة تطبيقية (applier) لم يتم تصميمها لاستخدامها.

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

  بالنسبة إلى أدوات التطبيق المخصّصة، يجب أن تضيف الدوال القابلة للإنشاء التي تستدعي ComposeNode أو ReusableComposeNode تعليقًا توضيحيًا ComposableTarget للدالة وأي أنواع مَعلمات lambda قابلة للإنشاء. ومع ذلك، يُنصح بإنشاء تعليق توضيحي يتضمّن ComposableTargetMarker، ثم استخدام التعليق التوضيحي الذي تم وضع علامة عليه بدلاً من ComposableTarget مباشرةً. تكون التعليقات التوضيحية القابلة للإنشاء المميّزة بـ ComposableTargetMarker مكافئة لـ ComposbleTarget مع اسم مؤهَّل بالكامل لفئة السمة كمعلَمة مطبِّقة. للاطّلاع على مثال حول استخدام ComposableTargetMarker، يُرجى الرجوع إلى anroidx.compose.ui.UiComposable. (I38f11)

• تتلقّى السمة Font(resId, ...) الآن loadingStrategy على واجهة برمجة التطبيقات الثابتة. (Ief3d2)

• أصبحت واجهة برمجة التطبيقات FontLoadingStrategy الآن واجهة برمجة تطبيقات ثابتة. (I1ee35، b/174162090)

• إتاحة تحميل الخطوط بشكل غير متزامن في "النص" (I77057 وb/214587005)

• إضافة واجهة برمجة تطبيقات وسيطة لتحويل Font.ResourceLoader المخصّص إلى FontFamily.Resolver (Ia0060)

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

• يتم تمرير FontFamily.Resolver إلى التركيبات الفرعية، مثل Popup.
• يتم تمرير Font.ResourceLoader إلى التركيبات الفرعية، مثل Popup. (I48fa5)

الإصدار ‎1.2.0-alpha03

‫9 فبراير 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha03. يتضمّن الإصدار 1.2.0-alpha03 هذه التعديلات.

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

• تم إيقاف طُرق notifyFocusedRect نهائيًا في TextInputSession وTextInputService، ولن يتم استدعاؤها. استخدِم BringIntoViewRequester بدلاً من ذلك. (Ia4302، b/192043120، b/216842427، b/178211874)
• تمت إضافة طريقة destroyDisplayListData إلى فئة RenderNode الصورية (I1e659، b/216660268)
• تمت إضافة واجهة برمجة تطبيقات جديدة تتيح قياس حجم العناصر الفرعية من SubcomposeLayout التي تم إنشاؤها مسبقًا. (I857ea)

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

  إذا تم استدعاء دالة movableContentOf lambda عدة مرات في التركيب نفسه، يتم إنشاء حالة وعُقد جديدة لكل عملية استدعاء، وعندما تغادر عمليات الاستدعاء التركيب وتدخل عمليات استدعاء جديدة، يتم نقل الحالة من عمليات الاستدعاء الأولى المغادرة إلى عمليات الاستدعاء الداخلة بالترتيب الذي يتم استدعاؤها به. تتم إزالة جميع الحالات التي لم تتم المطالبة بها من خلال المكالمات الجديدة بشكل دائم. (Ib4850)

• يتوفّر FontFamilyResolver الآن من خلال LocalFontFamilyResolver.current

• تمت إضافة createFontFamilyResolver(context) وcreateFontFamilyResolver(context, coroutineScope) لإنشاء أدوات تحليل جديدة خاصة بـ FontFamily خارج نطاق استخدام Compose.

• تتلقّى الفقرة وMultiParagraph الآن FontFamily.Resolver

• يحتوي TextLayoutResult.layoutInput.fontFamilyResolver الآن على برنامج التعيين المستخدَم في هذا التنسيق، وتم إيقاف TextLayoutResult.layoutInput.resourceLoader نهائيًا لأنّه لم يعُد مستخدَمًا. (Id5a45، b/174162090)

• إتاحة تحميل الخطوط بشكل غير متزامن واختياري، مع سلوك احتياطي يتم استخدام هذا المسار من خلال Text وTextField، ويتم عرضه من خلال FontFamilyResolver.

• إتاحة التحميل المُسبَق للخطوط من خلال FontFamilyResolver.preload

• تسمح السمة FontFamilyResolver.setAsyncLoadContext بضبط سياق الروتين الفرعي العام المستخدَم لتحميل الخطوط غير المتزامنة. (I87fe8، b/174162090)

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

• تمت إضافة ميزات إلى واجهة برمجة التطبيقات Font.ResourceLoaded لإتاحة تحميل الخطوط بشكل اختياري وغير متزامن. ولا يُنصح مطوّري التطبيقات باستخدام واجهة برمجة التطبيقات هذه مباشرةً. لإضافة أنواع جديدة من الخطوط، اطّلِع على AndroidFont.

• تسمح دالة الإضافة Font.AndroidResourceLoader بإنشاء Font.ResourceLoader خارج التركيب.

• تمت إضافة المَعلمة loadingStrategy إلى الخطوط المستندة إلى الموارد، وذلك للسماح بالتحميل غير المتزامن عندما يشير مرجع خط المورد إلى ملف XML للخطوط القابلة للتنزيل. (Ie5aea، b/174162090)

• تم إيقاف المنشئ Typeface(FontFamily) نهائيًا. كانت هذه السمة تُستخدَم سابقًا لتحميل الخطوط مسبقًا، وقد يستغرق ذلك مدة تصل إلى 10 ثوانٍ للخطوط القابلة للتنزيل. باستخدام الخطوط القابلة للتنزيل، قد يتم حظر هذا الطلب لمدة 10 ثوانٍ. استخدِم FontFamilyResolver.preload بدلاً من ذلك.

• تم إيقاف fontResource(FontFamily): Typeface نهائيًا. كانت هذه السمة تُستخدَم سابقًا لتحميل الخطوط مسبقًا، وقد يستغرق ذلك مدة تصل إلى 10 ثوانٍ للخطوط القابلة للتنزيل. بدلاً من ذلك، استخدِم FontFamilyResolver.preload (If8e7c، b/174162090).

• تم إيقاف الدالة الإنشائية SubcomposeLayoutState التي تقبل maxSlotsToRetainForReuse نهائيًا. بدلاً من ذلك، هناك أداة إنشاء جديدة تقبل SubcomposeSlotReusePolicy، وهي واجهة جديدة تتيح تحكّمًا أكثر دقة في الفتحات التي يجب الاحتفاظ بها لإعادة استخدامها في المستقبل. (I52c4d)

• عرض دالتي HSV وHSL في Color كواجهة برمجة تطبيقات غير تجريبية أصبحت مساحة الألوان Oklab واجهة برمجة تطبيقات عامة. (I08fb6، b/180731008)

• تم إيقاف AndroidComposeTestRule.AndroidComposeStatement نهائيًا، وهو لم يكن مخصّصًا لواجهة برمجة التطبيقات العامة ولم يكن يقدّم أي فائدة. (Ibc46b)

• إعادة تسمية فئة kt التي تم إنشاؤها داخليًا (Ia0b9e، b/174162090)

• تمت إزالة FontLoadingStrategy.values (I42a9d، b/174162090)

• أصبح اسم أداة تحميل الخطوط العامة الآن FontFamilyResolver. (I4f773، b/174162090)

• استخدام نظام جديد لتحميل الخطوط على الكمبيوتر (I9ce5c، b/174162090)

• FontFamily.Resolver.resolve returns State<Any> (I4406c, b/174162090)

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

• سيتم الآن إبقاء حقول TextFields فوق لوحة المفاتيح عند التركيز عليها وإظهار لوحة المفاتيح، وذلك عندما يكون وضع الإدخال السلس ADJUST_PAN. (I8eaeb، b/190539358، b/192043120)
• يستخدم الكمبيوتر المكتبي التركيبة المحلية لـ FontFamily.Resolver
• تم إيقاف ميزة "FontLoader" نهائيًا على أجهزة الكمبيوتر
• مصنع createFontFamilyResolver الجديد على الكمبيوتر المكتبي (I6bbbb، b/174162090)
• لم يعُد نوع إدخال لوحة المفاتيح الافتراضية يومض عند تغيير التركيز بين حقول النص. (I1bf50، b/187746439)

الإصدار 1.2.0-alpha02

‫26 يناير 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha02. يتضمّن الإصدار 1.2.0-alpha02 هذه التعديلات.

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

• تمت إضافة Modifier.onRotaryScrollEvent() وModifier.onPreRotaryScrollEvent() للأجهزة القابلة للارتداء التي تحتوي على زر جانبي دوّار (I18bf5، b/210748686)
• إضافة View.createLifecycleAwareRecomposer إضافة تجريبية (I0cde6)

المساهمة الخارجية

• تم الآن عكس قيمة PointerEvent.scrollDelta.y على أجهزة Android (تعرض الآن القيمة 1 بدلاً من -1 إذا أملنا عجلة الماوس إلى اليمين) (Ia9811)

الإصدار 1.2.0-alpha01

‫12 يناير 2022

تم طرح androidx.compose.ui:ui-*:1.2.0-alpha01. يتضمّن الإصدار 1.2.0-alpha01 هذه التعديلات.

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

• تم إيقاف FontFamily.canLoadSynchronously نهائيًا. لا تحمل هذه السمة أي معنى دلالي. (Ica5ef)
• تمت إضافة حقل المعرّف إلى CompositionData لإنشاء معرّفات ثابتة في "أداة فحص التنسيق". (Ic116e)
• تمت إضافة أرقام تعريف أجهزة Wear OS إلى قائمة أجهزة المعاينة (I93232)

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

• يعتمد الآن على 1.6.10 Kotlin.

الإصدار 1.1

الإصدار 1.1.1

‫23 فبراير 2022

تم طرح androidx.compose.ui:ui-*:1.1.1. يتضمّن الإصدار 1.1.1 هذه التعديلات.

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

• إصلاح NullPointerException في androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList (aosp/1947059 وb/206677462)
• تم إصلاح عُطل ناتج عن محتوى الحافظة أثناء القراءة من الحافظة على جهاز Android. (I06020، b/197769306)
• إصلاح مشكلة عرض النصوص من اليمين إلى اليسار في LazyVerticalGrid (aosp/1931080 وb/207510535)

الإصدار 1.1.0

‫9 فبراير 2022

تم طرح androidx.compose.ui:ui-*:1.1.0. يتضمّن الإصدار 1.1.0 هذه التعديلات.

التغييرات المهمة منذ الإصدار 1.0.0

• إتاحة تأثير تجاوز حد التمرير في Android 12 بشكل ثابت
• تحسينات على حجم مساحة اللمس
  • يُرجى العِلم أنّه في ما يتعلّق بالإصدار 1.0 من Compose، ستوسّع مكوّنات Material مساحة التنسيق لتلبية إرشادات تسهيل الاستخدام في Material بشأن حجم مساحة اللمس. على سبيل المثال، سيتم توسيع مساحة اللمس الخاصة بالزر إلى حد أدنى يبلغ 48×48 بكسل مستقل الكثافة، حتى إذا ضبطت حجم الزر على قيمة أصغر. يؤدي ذلك إلى توافق Compose Material مع السلوك نفسه الذي تتّبعه "مكوّنات التصميم المتعدد الأبعاد"، ما يوفّر سلوكًا متسقًا في حال استخدام كلّ من Views وCompose. يضمن هذا التغيير أيضًا استيفاء الحد الأدنى من متطلبات إمكانية الوصول إلى مساحة اللمس عند إنشاء واجهة المستخدم باستخدام مكوّنات Compose Material.
• إتاحة شريط التنقّل بشكل ثابت
• نقل عدد من واجهات برمجة التطبيقات التجريبية السابقة إلى الإصدار الثابت
• التوافق مع الإصدارات الأحدث من Kotlin

الإصدار ‎1.1.0-rc03

‫26 يناير 2022

تم طرح androidx.compose.ui:ui-*:1.1.0-rc03. يتضمّن الإصدار 1.1.0-rc03 هذه التعديلات.

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

• تم التحديث لإتاحة استخدام الإصدار 1.1.0-rc03 من Compose Material

الإصدار 1.1.0-rc01

15 كانون الأول (ديسمبر) 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-rc01. يتضمّن الإصدار 1.1.0-rc01 هذه التعديلات.

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

• تم إصلاح الخطأ الذي تسبّب في عدم توفّر إجراءات التمرير المتعلقة بتسهيل الاستخدام (I7cbfb)
• ستعمل SemanticsNodeInteraction.captureToImage() أيضًا إذا كانت قيمة HardwareRenderer.isDrawingEnabled() هي false، وذلك من خلال تفعيلها لمدة المكالمة (Idf3d0).

الإصدار ‎1.1.0-beta04

‫1 ديسمبر 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-beta04. يتضمّن الإصدار 1.1.0-beta04 هذه التعديلات.

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

• تم تعديلها لتكون متوافقة مع الإصدار 1.6.0 من Kotlin

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

• تمت إزالة القيم الفارغة في androidx.core.view (I7078a، b/204917439)
• تمت إضافة واجهات برمجة تطبيقات تجريبية تتيح للمستخدمين استخدام PointerInputchange ككل أو التحقّق مما إذا تم استخدامه أم لا. (I2e59d)
• تضيف هذه السمة إمكانية التعامل مع أحداث عجلة التمرير في الماوس في طبقة واجهة المستخدم. (Ia14eb، b/198214718)
• أضِف عمليات تحميل زائدة تجريبية Modifier.composed تقبل المفاتيح للمقارنة من أجل المساواة والتأهّل لتخطّي عمليات التحسين. (Ice799، b/205851704)
• أصبح نطاق ComposeNotIdleException يمتد من Exception بدلاً من Throwable مباشرةً. يُرجى العِلم أنّ هذا يعني أنّ عبارات الاستثناء التي كانت تتضمّن Exception قد تتضمّن الآن ComposeNotIdleException، في حين أنّها لم تكن تتضمّنها سابقًا. (I9c217)

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

• إصلاح مشكلة عدم تحرُّك مقابض النص عند تغيُّر مستوى ظهور محرر أسلوب الإدخال (IME) (I25f2e)

الإصدار ‎1.1.0-beta03

17 تشرين الثاني (نوفمبر) 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-beta03. يتضمّن الإصدار 1.1.0-beta03 هذه التعديلات.

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

• تمت إضافة معدِّل جديد Modifier.onPlaced للسماح بمراقبة تغيير موضع العنصر. وبالتالي، يمكن إجراء تغييرات إضافية على إزاحة المعدِّل الفرعي استنادًا إلى التغيير الملحوظ في موضع الإعلان. (I558fd)
• تمت إزالة InjectionScope.flush() وInjectionScope.dispose(). يتم الآن إفراغ جميع الأحداث والتخلص من النطاق في نهاية طريقة perform*Input() التي تم استدعاؤها، كما كان يحدث من قبل. (I2bed8)
• تمت إزالة MultiModalInjectionScope.Touch وMultiModalInjectionScope.Mouse. لإدخال أحداث اللمس والماوس لإيماءات متعدّدة الوسائط، يمكنك الآن استخدام MultiModalInjectionScope.touch() وMultiModalInjectionScope.mouse()، وكلاهما يقبلان تعبير lambda يتضمّن نطاق المستلِم الخاص بهذا الوضع. (Idde18)

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

• يتم الآن احتساب القيمة التلقائية للحقل durationMillis في TouchInjectionScope.swipeWithVelocity بطريقة تتيح إمكانية التمرير السريع. (I19deb)

الإصدار 1.1.0-beta02

‫3 نوفمبر 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-beta02. يتضمّن الإصدار 1.1.0-beta02 هذه التعديلات.

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

• تمت إضافة واجهة برمجة التطبيقات التجريبية BringIntoView التي تتيح لك إرسال طلب إلى العناصر الرئيسية لكي يتم التمرير لعرض عنصر (Ib918d، b/195353459)
• واجهات برمجة تطبيقات جديدة للصور المتحركة لدعم الأدوات على وجه التحديد، تتيح هذه الفئة للأدوات فحص الصور المتحركة وإعداداتها في Transitions. (I4116e)

المساهمة الخارجية

• تمت إضافة Modifier.pointerHoverIcon (I95f01)

الإصدار 1.1.0-beta01

‫27 أكتوبر 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-beta01. يتضمّن الإصدار 1.1.0-beta01 هذه التعديلات.

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

• تمت إضافة واجهة برمجة تطبيقات تجريبية BringIntoView تتيح لك إرسال طلب إلى الأهل ليتمكّنوا من التمرير لعرض عنصر (Ib918d، b/195353459)
• واجهات برمجة تطبيقات جديدة للصور المتحركة لدعم الأدوات على وجه التحديد، تتيح هذه الفئة للأدوات فحص الصور المتحركة وإعداداتها في Transitions. (I4116e)

الإصدار ‎1.1.0-alpha06

‫13 أكتوبر 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-alpha06. يتضمّن الإصدار 1.1.0-alpha06 هذه التعديلات.

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

• إزالة ExperimentalComposeUiApi من ViewRootForInspector وLayoutInfo.ownerViewId (I5c2e3)
• تمت إضافة حمل زائد بدون عنصر فرعي إلى Layout، مع تحسين الكفاءة (Ib0d9a)
• تمت إزالة InternalCompilerApi من طرق Composer التي يجب استدعاؤها على مستوى الوحدات (I1aa0b)
• تعرض SemanticsNodeInteraction.performSemanticsAction الآن SemanticsNodeInteraction الذي تم استدعاء الدالة عليه. (I9e5db)
• تمت إضافة LocalInputModeManager CompositionLocal لرصد TouchMode/NonTouchMode. (I6a83c، b/175899786)
• تمت إضافة viewConfiguration: ViewConfiguration إلى LayoutInfo للسماح للمستهلكين بالحصول على القيمة الصحيحة لأشياء مثل المهلة الزمنية للنقر مع الاستمرار. (I76ca6)
  • تمت إضافة viewConfiguration: ViewConfiguration إلى InjectionScope للسماح للاختبارات بتعديل عملية إدخال البيانات استنادًا إلى عوامل مثل مهلة الضغط مع الاستمرار أو مسافة اللمس.
  • تم تغيير المدة التلقائية للنقر مع الاستمرار والنقر مرّتين لكل من الإدخال باللمس والماوس لتستند إلى القيم الواردة في InjectionScope.viewConfiguration.
• تنفيذ ExposedDropdownMenu استنادًا إلى ExposedDropdownMenuBox مع TextField وDropdownMenu في الداخل (If60b2)
• تمت إضافة dismissOnOutsideClick إلى PopupProperties، ما أدّى إلى استبدال dismissOnClickOutside التي لم تعُد متاحة. يتلقّى العنصر الجديد موضع النقرة وحدود العنصر الثابت، ما يتيح تحكّمًا أفضل في ما إذا كان يجب استدعاء onDismissRequest أم لا. على سبيل المثال، يمكن أن يكون ذلك مفيدًا لمنع إغلاق العنصر الثابت عند النقر عليه.
  • تمت إضافة updateAndroidWindowManagerFlags إلى PopupProperties، ما يتيح التحكّم على مستوى منخفض في العلامات التي يمرّرها العنصر المنبثق إلى Android WindowManager. ستكون مَعلمة دالة lambda هي العلامات المحسوبة من قيم PopupProperties التي تؤدي إلى علامات WindowManager، مثل focusable. ستكون نتيجة الدالة lambda هي العلامات النهائية التي سيتم تمريرها إلى WindowManager في Android. سيؤدي استدعاء updateAndroidWindowManagerFlags تلقائيًا إلى ترك العلامات المحسوبة من المَعلمات بدون تغيير. يجب استخدام واجهة برمجة التطبيقات هذه بحذر، وفقط في الحالات التي تتطلّب فيها النافذة المنبثقة سلوكًا محدّدًا جدًا. (I6e9f9)
• تم إيقاف Recomposer.state نهائيًا واستبداله بـ Recomposer.currentState لتغيير نوعه إلى StateFlow (Ic2ab3، b/197773820)
• تمّت إضافة flush() وdispose() إلى InjectionScope. استخدِمها عندما تريد إفراغ جميع الأحداث التي تمّت إضافتها إلى قائمة الانتظار على الفور وعندما تريد التخلّص من النطاق، على التوالي. (Ifb73a)
• تمت إضافة performScrollToNode(matcher: SemanticsMatcher) التي تنقل حاوية قابلة للتمرير إلى المحتوى الذي يطابقه عنصر المطابقة المحدّد. (Ic1cb8)
• تتيح InjectionScope الآن استخدام Density، ما يتيح لك التحويل بسهولة بين وحدتَي البكسل (px) ووحدة البكسل المستقلة عن الكثافة (dp) في performTouchInput وغيرها. (I8fe1f)

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

• تنقل AndroidView الآن LocalLifecycleOwner وLocalSavedStateRegistryOwner إلى طريقة العرض الخاصة بها من خلال ViewTreeLifecycleOwner وViewTreeSavedStateRegistryOwner. (I38f96، b/179708470)
• إصلاح مشكلة عدم معالجة WearOS SwipeToDismissBox أحيانًا لعمليات التمرير السريع (I9387e)
• تم تغيير الوقت التلقائي بين أحداث الإدخال التي يتم إدخالها من 10 ملي ثانية إلى 16 ملي ثانية. قد يؤدي ذلك إلى تغيير نتيجة الاختبارات التي تنفّذ إيماءات إدخال، مثل التمرير السريع في اتجاه معيّن. (I829fd)

الإصدار ‎1.1.0-alpha05

‫29 سبتمبر 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-alpha05. يتضمّن الإصدار 1.1.0-alpha05 هذه التعديلات.

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

• تمت إضافة إمكانية التواصل بين المعدِّلات (Id5467، b/198826874)
• تمت إضافة مؤشرات تجريبية سابقة إلى PointerEventChange. (Ic1fd8 وb/197553056 وb/199921305)
• تمّت إضافة density: Density وlayoutDirection: LayoutDirection إلى LayoutInfo. يتيح ذلك لمستهلكي LayoutInfo تفسير الأبعاد والموضع المعروضَين في LayoutInfo بشكل صحيح. (I002f1)
• تمت إضافة دعم تجريبي لإدخال أحداث الماوس. استخدِم performMouseInput لبدء إرسال أحداث الماوس، أو أرسِل أحداث الماوس من خلال الخاصية Mouse في MultiModalInjectionScope أثناء إيماءة إدخال متعددة الوسائط باستخدام performMultiModalInput. يمكنك الاطّلاع على MouseInjectionScope للحصول على مستندات حول واجهة برمجة التطبيقات المتاحة. (Iaa4a8، b/190493367)

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

• تم إصلاح مشكلة إمكانية الوصول إلى العناصر القابلة للتمرير (التي يتم تحميلها عند الحاجة وغير القابلة للتمرير) عند التمرير (I6cdb0)
• تم تحسين TouchInjectionScope.swipeWithVelocity. أصبح بإمكانها الآن قبول مجموعة أكبر من متغيّرات الإدخال، وستقترح تغييرات على الإدخال إذا تعذّر إنشاء تمرير سريع (I40fbe، b/182477143).

الإصدار 1.1.0-alpha04

‫15 سبتمبر 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-alpha04. يتضمّن الإصدار 1.1.0-alpha04 هذه التعديلات.

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

• يتضمّن PointerEvent الآن PointerEventType لإتاحة أحداث التمرير. (I091fa)
• السماح للأطفال بقبول إدخال المؤشر خارج حدود إدخال المؤشر الخاص بالعنصر الرئيسي يمكن للأهل اعتراض هذه المكالمات باستخدام السمة PointerInputScope.alwaysInterceptChildEvents (I9eae3، b/192479655).
• تم إيقاف performGesture وGestureScope نهائيًا واستبدالهما بـ performTouchInput وTouchInjectionScope. (Ia5f3f، b/190493367)
• تمت إضافة touchBoundsInRoot إلى SemanticsNode التي تتضمّن الحد الأدنى لحجم مساحة اللمس، وذلك ليتأكّد المطوّرون من أنّ مساحات اللمس تستوفي الحد الأدنى من متطلبات تسهيل الاستخدام. (I2e14b، b/197751214)
• إعادة تنفيذ ميزة "قابلة للفحص" (I927bc، b/191017532)
• تم تغيير اسم مَعلمة العنصر القابل للفحص ليتطابق مع العنصر المركّب (I3a482، b/191017532)

• تم تقديم performTouchInput وTouchInjectionScope كبديلَين عن performTouchInput وTouchInjectionScope، ما يمهّد الطريق أمام طرق إدخال أخرى (مثل الماوس).

  تتضمّن TouchInjectionScope الطرق نفسها التي تتضمّنها GestureScope، باستثناء movePointerTo وmovePointerBy اللتين تمت إعادة تسميتهما إلى updatePointerTo وupdatePointerBy. وجميع الطرق الأخرى هي نفسها.

  يتشابه سلوك TouchInjectionScope مع سلوك GestureScope بشكل كبير، مع اختلاف بسيطَين:

  1. عند إرسال حدث down أثناء تحريك المؤشرات بدون إرسال حدث move (بمعنى آخر، تم استخدام updatePointerTo()، ولكن ليس move()، ثم تم استدعاء down())، كان التنفيذ السابق يقدّم وقت الحدث ويرسل حدث move قبل إرسال حدث down. سيظل التنفيذ الجديد يرسل حدث move، ولكنّه لن يقدّم وقت الحدث في هذه الحالة المحدّدة.
  2. عند إرسال حدث "رفع" أثناء تحريك المؤشرات بدون إرسال حدث "تحريك" (كما هو موضح أعلاه)، كانت عملية التنفيذ السابقة تقدّم وقت الحدث وترسل حدث "تحريك" قبل إرسال حدث "رفع". لا تنفّذ عملية التنفيذ الجديدة أيًا مما سبق، ولن تظهر المواضع الجديدة للمؤشرات إلا من خلال حدث "الأعلى".

  أخيرًا، تقدّم السمة TouchInjectionScope طريقة جديدة currentPosition(pointerId: Int) للحصول على الموضع الحالي للمؤشر المحدّد. (If1191، b/190493367)

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

• تتيح هذه السمة توسيع حدود مساحة اللمس إلى ما بعد منطقة القص لأغراض الحد الأدنى لمساحة اللمس. (I43e10، b/171509422)
• تمت إضافة دعم لتجاوز حد التمرير المطاطي على أجهزة Android 12. (Iccf3c، b/171682480)

الإصدار ‎1.1.0-alpha03

‫1 سبتمبر 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-alpha03. يتضمّن الإصدار 1.1.0-alpha03 هذه التعديلات.

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

• تم تعديل Compose 1.1.0-alpha03 ليعتمد على Kotlin 1.5.30. (I74545)

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

• تمت إضافة Modifier.inspectable لتضمين معدّلات أخرى. (I1909b، b/191017532)
• تمت إضافة واجهة برمجة التطبيقات BlurredEdgeTreatment لتسهيل حالات استخدام التمويه إلى مجموعات أكثر شيوعًا من علامات المقاطع وTileModes. تتضمّن معظم حالات الاستخدام إما السماح بعرض المحتوى المموّه خارج حدود المحتوى الأصلية وتطبيق التمويه على المناطق خارج هذه الحدود باستخدام اللون الأسود الشفاف، أو قص المحتوى إلى حدود المحتوى مع أخذ عيّنات من الحافة الأقرب لنواة التمويه التي تتجاوز حدود المحتوى. (I6b4b7، b/166927547)
• تمت إضافة إمكانية استخدام RenderEffect في Compose Desktop. تمت إضافة OffsetEffect بالإضافة إلى أداة تعديل التمويه كطريقة بسيطة لإضافة مؤثرات بصرية مموّهة إلى جزء من التسلسل الهرمي للتركيبة. (I0f6aa، b/166927547)
• تم تقديم واجهة برمجة التطبيقات RenderEffect التي يمكن ضبطها اختياريًا على Modifier.graphicsLayer لتغيير محتوى الطبقة نفسها. يمكن استخدامها لتمويه محتوى دالة مركّبة ودوال مركّبة تابعة ضمن تسلسل هرمي للتكوين. (I47c4d، b/166927547)
• يتضمّن AwaitPointerEventScope الآن الدالتَين withTimeout()‎ وwithTimeoutOrNull()‎ (I507f0 وb/179239764 وb/182397793)
• تمت إضافة الحد الأدنى لحجم مساحة اللمس إلى ViewConfiguration لاستخدامه في الدلالات وإدخال المؤشر لضمان إمكانية الوصول. (Ie861c)
• إضافة إمكانية استخدام TileMode.Decal التي تفيد في تحديد سلوك الحواف للتأثيرات RenderEffects المستندة إلى التمويه (I7e8ed، b/166927547)
• أصبحت performScrollToIndex وperformScrollToKey وhasScrollToIndexAction وhasScrollToKeyAction واجهات برمجة تطبيقات ثابتة الآن (I142ae، b/178483889)
• تمت إضافة طريقة اختبار للحصول على الحدود المقتصة. (I6b28e)

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

• تمت إزالة طريقة isBounded من BlurredEdgeTreatment واستبدالها بالتحقّق بشكل صريح مما إذا كانت المَعلمة shape فارغة. (I85d68)

الإصدار ‎1.1.0-alpha02

‫18 أغسطس 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-alpha02. يتضمّن الإصدار 1.1.0-alpha02 هذه التعديلات.

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

• تتيح PointerEvent الآن قراءة حالة زر الماوس وحالة مفتاح التعديل في لوحة المفاتيح. (I6310c، b/180075467)
• تستخدم الإيماءات المُدرَجة الآن وقت MainTestClock كمصدر موثوق للوقت. سيتم ضبط الوقت الحالي للأحداث التي تم إدخالها في performGesture على الوقت الحالي لـ MainTestClock. (Ifb364، b/192064452)
• تمت إضافة الدالة الإنشائية DpRect(DpOffset, DpSize) (I2cf16، b/194219828)
• تمت إضافة فئة DpSize (I7abb1، b/194219828)

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

• تم تعديل عملية تحليل XML لرسومات المتجهات لتتوافق مع ColorStateLists كسمات أساسية لتدرّج الألوان في VectorDrawables. (I86915، b/195668138)

الإصدار ‎1.1.0-alpha01

‫4 أغسطس 2021

تم طرح androidx.compose.ui:ui-*:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

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

• تقبل السمة RelocationRequester.bringIntoView الآن مستطيلاً كمعلَمة تتيح لنا عرض جزء من دالة مركّبة (Ice2c5، b/194330245)
• أصبحت السمة AnimatedImageVector وواجهات برمجة التطبيقات ذات الصلة متوفّرة الآن في وحدة androidx.compose.animation:animation-graphics الجديدة. (I60873)
• تمت إضافة أداة تعديل تجريبية للتعامل مع طلبات النقل. (I65a97، b/178211874)

• تم تقديم واجهة برمجة التطبيقات BrushPainter لإتاحة رسم أي Brush ضمن Painter، على غرار ColorPainter

  تم تعديل Brush API لتضمين مَعلمة حجم أساسي يتم طلبها ضمن BrushPainter (Ia2752، b/189466433)

• تم تعديل طريقة DrawScope#drawImage التي تستهلك مستطيلات المصدر والوجهة لاستهلاك مَعلمة FilterQuality اختيارية. ويفيد ذلك في إنشاء صور فن البكسل التي من المفترض أن تكون منقطة عند تكبيرها. تم تعديل BitmapPainter وImage composable ليستهلكا أيضًا مَعلمة FilterQuality اختيارية (Ie4fb0، b/180311607)

• تمت إضافة طريقة GestureScope.advanceEventTime لمنح المستخدم تحكّمًا أكبر في توقيت الأحداث في الإيماءة (Ibf3e2)

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

• لتحسين إمكانية ربط معدِّلات الرسم، تأكَّد من أنّ عملية تنفيذ Modifier.paint تستدعي drawsContent. في السابق، كان من المتوقّع أن يكون Modifier.paint عقدة فرعية في سلسلة المعدِّلات، ولكنّ ذلك يمنع ضبطها على حاوية قابلة للإنشاء (مثل مربّع) أو إضافة عناصر تزيين إضافية في الأعلى، مثل Modifier.paint().border(). من خلال استدعاء Modifier.paint للدالة drawContent بعد رسم محتويات الرسام المحدّد، نحصل على اتساق أفضل في السلوك مع نمط المعدِّل. (Ibb2a7، b/178201337، b/186213275)
• تتّبع مربّعات الحوار الآن سلوك تحديد الحجم الخاص بالمنصّة. اضبط قيمة usePlatformDefaultWidth على "خطأ" لتجاوز هذا السلوك. (Iffaed، b/192682388)
• نقل InfiniteAnimationPolicy إلى :compose:ui (I5eb09، b/160602714)
• أصبحت عملية التمرير من خلال الإجراءات الدلالية للقوائم الكسولة ومكوّنات التمرير العادية تتضمّن رسومًا متحركة (Id9066، b/190742024)

الإصدار 1.0

الإصدار 1.0.5

‫3 نوفمبر 2021

تم طرح androidx.compose.ui:ui-*:1.0.5. يتضمّن الإصدار 1.0.5 هذه التعديلات.

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

• تم إصلاح مشكلة تعطُّل تتبُّع مثيلات derivedStateOf. (aosp/1792247)

الإصدار 1.0.4

‫13 أكتوبر 2021

تم طرح androidx.compose.ui:ui-*:1.0.4. يتضمّن الإصدار 1.0.4 هذه التعديلات.

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

• تم تعديلها لتعتمد على الإصدار 1.5.31 من Kotlin

الإصدار 1.0.3

‫29 سبتمبر 2021

تم طرح androidx.compose.ui:ui-*:1.0.3. يتضمّن الإصدار 1.0.3 هذه التعديلات.

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

• تم تعديلها لتعتمد على الإصدار 1.5.30 من Kotlin

الإصدار 1.0.2

‫1 سبتمبر 2021

تم طرح androidx.compose.ui:ui-*:1.0.2. يتضمّن الإصدار 1.0.2 هذه التعديلات.

تم تعديلها لتتوافق مع إصدار Compose 1.0.2. لا يزال الإصدار 1.0.2 من Compose متوافقًا مع الإصدار 1.5.21 من Kotlin.

الإصدار 1.0.1

‫4 أغسطس 2021

تم طرح androidx.compose.ui:ui-*:1.0.1. يتضمّن الإصدار 1.0.1 هذه التعديلات.

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

• تم تعديلها لتعتمد على الإصدار 1.5.21 من Kotlin.

الإصدار 1.0.0

‫28 يوليو 2021

تم طرح androidx.compose.ui:ui-*:1.0.0. يتضمّن الإصدار 1.0.0 هذه التعديلات.

الميزات الرئيسية في الإصدار 1.0.0

هذا هو أول إصدار ثابت من Compose. يُرجى الاطّلاع على مدوّنة Compose Release الرسمية لمزيد من التفاصيل.

المشاكل المعروفة

• إذا كنت تستخدم الإصدار 4 من استوديو Android Bumblebee Canary أو الإصدار 7.1.0-alpha04/7.1.0-alpha05 من "المكوّن الإضافي لنظام Gradle المتوافق مع Android"، قد تواجه التعطّل التالي:

    java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"
  

  لحلّ هذه المشكلة، عليك زيادة minSdkVersion مؤقتًا إلى 24 أو أكثر في ملف build.gradle. سيتم حلّ هذه المشكلة في الإصدار التالي من Android Studio Bumblebee و7.1. (b/194289155)

الإصدار ‎1.0.0-rc02

‫14 يوليو 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-rc02. يتضمّن الإصدار 1.0.0-rc02 هذه التعديلات.

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

• تتّبع مربّعات الحوار الآن سلوك تحديد الحجم الخاص بالمنصّة. اضبط قيمة usePlatformDefaultWidth على "خطأ" لتجاوز هذا السلوك. (Iffaed، b/192682388)

الإصدار ‎1.0.0-rc01

‫1 تموز (يوليو) 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-rc01. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

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

• تقسيم وحدة ui-tooling إلى ui-tooling وui-tooling-preview (Iefa28، b/190649014)

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

• إزالة الميزتَين التجريبيتَين القديمتَين FocusManager#moveFocusIn وFocusManager#moveFocusOut (I227d7 وb/170154986 وb/186567354 وb/168510304)
• تتيح Canvas الآن استخدام المَعلمة contentDescription لتسهيل الاستخدام. (Ib547c)
• تمت إعادة تسمية useDefaultMaxWidth في PopupProperties إلى usePlatformDefaultWidth. (I05710)
• يمكن الآن استخدام عرض الشاشة بالكامل في مربّعات الحوار. (I83929، b/190810877)
• تمت إضافة دعم تجريبي لتمثيلات ألوان HSV وHSL. (Id7cf8، b/180731008)

التغييرات في السلوك

• توفّر Compose @Preview الآن LocalActivityResultRegistryOwner تتيح لك معاينة العناصر القابلة للإنشاء التي تستخدم واجهات برمجة تطبيقات مثل rememberLauncherForActivityResult() التي تعتمد على توفّر هذا المالك. (Ib13d1، b/185693006)
• توفّر Compose @Preview الآن LocalOnBackPressedDispatcherOwner تتيح لك معاينة العناصر القابلة للإنشاء التي تستخدم واجهات برمجة تطبيقات مثل BackHandler التي تعتمد على توفّر هذا المالك. (Ia1c05، b/185693006)

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

• تم نقل InfiniteAnimationPolicy إلى androidx.compose.ui:ui (I5eb09، b/160602714)
• تمت إزالة AnimatedImageVector مؤقتًا من أجل تغيير بنية الوحدة. (I41906، b/160602714)

الإصدار ‎1.0.0-beta09

‫16 حزيران (يونيو) 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-beta09. يتضمّن الإصدار 1.0.0-beta09 هذه التعديلات.

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

• تغيير تعداد Role وLiveRegionMode إلى فئات مضمّنة مع دالة إنشاء خاصة (Id1890)
• يتم تحويل KeyboardCapitalization إلى فئة مضمّنة. (Id5a1c)
• غيِّر HapticFeedbackType إلى فئة مضمّنة. (I255ec)
• ‫Modifier.pointerInteropFilter هو ‎ @ExperimentalComposeUiApi. (Iede6c)
• أصبحت TextAlign وFontSynthesis وTextDirection الآن فئات مضمّنة. (I212fe)
• تم تغيير TextOverflow إلى فئة مضمّنة. (I433af)
• أصبح FontStyle الآن فئة مضمّنة. (I9e48b)

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

• الثوابت الرئيسية هي ‎ @ExperimentalComposeUiApi في الوقت الحالي. يمكن أن يعرّف رمز الاستخدام الثوابت الخاصة قبل أن يصبح مستقرًا. (Ia5d48)
• يمكن الآن إجراء اختبارات Compose على Robolectric. تم رصد القيود التالية حتى الآن:
  • لا تتوفّر خريطة بتات أصلية، لذا يؤدي ImageBitmap() إلى NullPointerException.
  • لا يوجد رسم، لذا ستنتظر captureToImage() إلى أجل غير مسمى عملية الرسم التالية (أي سيحدث توقّف تام).
  • لم يتم تحميل أي خط، لذا سيتم قياس أي نص بشكل غير صحيح. يبلغ الارتفاع الثابت لكل حرف حوالي 20 بكسل والعرض 1 بكسل.
  • لا تنفّذ ComposeTestRule.waitUntil {} سلسلة التعليمات الرئيسية أثناء انتظارها، ما يجعلها مماثلة تمامًا ComposeTestRule.mainClock.advanceTimeUntil {} من المتوقّع تحديد المزيد من القيود في المستقبل. (I284fa)

قواعد الملفات التجارية المُضافة

يضيف هذا الإصدار قواعد الملف الشخصي إلى وحدات الإنشاء التالية (I14ed6):

• androidx.compose.animation
• androidx.compose.animation-core
• androidx.compose.foundation
• androidx.compose.foundation-layout
• androidx.compose.material
• androidx.compose.material-ripple
• androidx.compose.runtime
• androidx.compose.ui
• androidx.compose.ui.geometry
• androidx.compose.ui.graphics
• androidx.compose.ui.text
• androidx.compose.ui.text
• androidx.compose.ui.unit
• androidx.compose.ui.util

ما هي قواعد الملف الشخصي؟

• يتم تحديد قواعد الملف الشخصي لمكتبة في ملف نصي baseline-prof.txt يقع في الدليل src/main أو دليل مكافئ. يحدّد الملف قاعدة واحدة لكل سطر، حيث تكون القاعدة في هذه الحالة عبارة عن نمط للمطابقة مع الطرق أو الفئات في المكتبة. بنية هذه القواعد هي مجموعة فرعية من تنسيق ملف ART الشخصي القابل للقراءة الذي يتم استخدامه عند استخدام adb shell profman --dump-classes-and-methods .... تتخذ هذه القواعد أحد الشكلين التاليين لاستهداف الطرق أو الفئات.

• ستتّبع قاعدة الطريقة النمط التالي:

  <FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
  

• وستتّبع قاعدة الفئة النمط التالي:

  <CLASS_DESCRIPTOR>
  

• هنا، <FLAGS> هو واحد أو أكثر من الأحرف H وS وP للإشارة إلى ما إذا كان يجب تصنيف هذه الطريقة على أنّها "شائعة الاستخدام" أو "بدء التشغيل" أو "بعد بدء التشغيل".

• <CLASS_DESCRIPTOR> هو واصف الفئة التي تنتمي إليها الطريقة المستهدَفة. على سبيل المثال، سيكون للفئة androidx.compose.runtime.SlotTable واصف Landroidx/compose/runtime/SlotTable;.

• ‫<METHOD_SIGNATURE> هي توقيع الطريقة، وتشمل الاسم وأنواع المَعلمات وأنواع الإرجاع الخاصة بالطريقة. على سبيل المثال، يتضمّن الإجراء fun isPlaced(): Boolean في LayoutNode التوقيع isPlaced()Z.

• يمكن أن تتضمّن هذه الأنماط أحرف بدل (** و* و?) لكي تشمل قاعدة واحدة طرقًا أو فئات متعدّدة.

ما هي وظيفة القواعد؟

• تشير الطريقة التي تتضمّن العلامة H إلى أنّ هذه الطريقة هي طريقة "نشطة"، ويجب تجميعها مسبقًا.

• تشير الطريقة التي تحمل العلامة S إلى أنّها طريقة يتم استدعاؤها عند بدء التشغيل، ويجب تجميعها مسبقًا لتجنُّب تكلفة التجميع وتفسير الطريقة عند بدء التشغيل.

• تشير الطريقة التي تتضمّن العلامة P إلى أنّها طريقة يتم استدعاؤها بعد بدء التشغيل.

• يشير أحد الصفوف المتوفّرة في هذا الملف إلى أنّه يتم استخدامه أثناء بدء التشغيل ويجب تخصيصه مسبقًا في الذاكرة المؤقتة لتجنُّب تكلفة تحميل الصف.

آلية العمل

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

الإصدار ‎1.0.0-beta08

‫2 يونيو 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-beta08. يتضمّن الإصدار 1.0.0-beta08 هذه التعديلات.

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

• يتم استبدال تعداد NestedScrollSource بفئة مضمّنة. (Ie321b، b/187055290)
• تمت إعادة تسمية "FocusManager.clearFocus(forcedClear = true)" إلى "FocusManager.clearFocus(force = true)" (Ia0c41)
• تمت إعادة تصميم استخدامات التعداد لتصبح فئات مضمّنة لتجنُّب المشاكل المتعلّقة بعبارات when الشاملة عند إضافة قيم تعداد جديدة. (I2b5eb)
• ستتم إزالة @ExperimentalComposeUiApi من PopupProperties. (I01fa6)
• تم تغيير PointerType من تعداد إلى فئة مضمّنة (If5058)
• لم تعُد خصائص ContentDescription وText الدلالية قيمًا فردية، بل أصبحت قوائم. يتيح ذلك دمجها كما هي بدلاً من تسلسلها. تم أيضًا توفير واجهات برمجة تطبيقات أفضل للاختبار من أجل الاستفادة من هذه التغييرات (Ica6bf وb/184825850).
• تم إيقاف Modifier.focusModifier() نهائيًا واستبداله بـ Modifier.focusTarget() (I6c860)
• لم يعُد Modifier.onSizeChanged() وModifier.onGloballyPositioned() دالتَين مضمّنتَين (I727f6، b/186109675)
• يتم استبدال تعداد KeyboardType بفئة مضمّنة. (I73045، b/187055290)
• تم استبدال التعداد FocusState بواجهة FocusState (Iccc1a، b/187055290)
• تم استبدال تعداد ImeAction بفئة مضمّنة. (I18be5، b/187055290)
• يتم تحويل PlaceholderVerticalAlign إلى فئة مضمّنة. (If6290)
• أصبح TextUnitType الآن فئة مضمّنة. (I4cba9)
• أصبحت دوال AnnotatedString.withAnnotation الآن ExperimentalTextApi بدلاً من ExperimentalComposeApi. (I0cd0a)
  • أصبح منشئ TextUnit الذي يتضمّن TextUnitType الآن ExperimentalTextApi بدلاً من ExperimentalComposeApi.

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

• تم إصلاح الخطأ الذي تم تقديمه في الإصدار التجريبي 07 والذي كان يتسبّب في عرض عناصر LazyColumn/Row بشكل جزئي بعد التمرير (I8c9ac، b/188566058)
• سيتم الآن استهلاك تغيير الموضع تلقائيًا في detectDragGesures وdetectVerticalGestures وdetectHorizontalGestures، ولن يكون عليك استدعاء change.consumePositionChange في عمليات إعادة الاستدعاء onDrag (I42fc4 وb/185096350 وb/187320697).
• تم إصلاح المشكلة المتعلّقة بـ LayoutModifiers التي توفّر خطوط المحاذاة. تم إصلاح خطأ كان يتسبّب في عدم إعادة قياس العنصر الرئيسي عند تغيير خطوط المحاذاة للعناصر الفرعية. (I4401f، b/174315652)
• تم تغيير Modifier.onGloballyPositioned() للإبلاغ عن إحداثيات أداة التعديل هذه في سلسلة أدوات التعديل، وليس إحداثيات التصميم بعد تطبيق جميع أدوات التعديل. وهذا يعني أنّ ترتيب المعدِّلات يؤثّر الآن في الإحداثيات التي سيتم تسجيلها. (Ieb67d، b/177926591)

الإصدار ‎1.0.0-beta07

‫18 أيار (مايو) 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-beta07. يتضمّن الإصدار 1.0.0-beta07 هذه التعديلات.

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

• تمت إضافة واجهة ViewRootForInspector لاستخدامها في "أداة الفحص" (Ib70df)
• يتيح SubcomposeLayoutState الآن ضبط عدد الخانات القابلة لإعادة الاستخدام. سيحافظ التصميم على عدد الخانات النشطة هذا بدلاً من التخلص منها لإعادة استخدام الخانة في المرة التالية التي نحتاج فيها إلى خانة جديدة (Ieb981).
• تم استبدال تعداد KeyEventType بفئة مضمّنة. (Id670a، b/187055290)
• يتم استبدال تعداد FocusDirection بفئة مضمّنة. (Ib6d03، b/187055290، b/184086802)
• تتيح هذه الميزة إمكانية نقل حالة SubcomposeLayout، ما يسمح لك بتجهيز المحتوى مسبقًا في slotId مطلوب، ما يؤدي إلى تسريع عملية القياس التالية، لأنّه عند محاولة إنشاء تركيبة فرعية باستخدام slotId المحدّد في المرة التالية، لن تكون هناك حاجة إلى إنشاء تركيبة. (I42580، b/184940225)
• إضافة مقبض اختيار المقطع (Iff80d، b/183408447)
• تمت إزالة واجهات برمجة التطبيقات غير المستخدَمة ذات الصلة بتوافق LayoutInspector. (I2ac78)

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

• ستحتفظ السمة LazyColumn/Row الآن بما يصل إلى عنصرَين مرئيَين سابقًا نشطَين (لم يتم التخلص منهما) حتى عند إيقاف التمرير. يتيح ذلك للمكوّن إعادة استخدام التركيبات الفرعية النشطة عندما نحتاج إلى إنشاء عنصر جديد، ما يحسّن أداء التمرير. (Ie5555)
• سيتم تطبيق TextGeomerticTransform وTextDecoration على AnnotatedString على النحو المحدّد. (I61900، b/184760917)

الإصدار ‎1.0.0-beta06

‫5 مايو 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-beta06. يتضمّن الإصدار 1.0.0-beta06 هذه التعديلات.

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

• حلّ التعارض مع إيماءة التنقّل (I1145e)
• لم يعُد @ComposeCompilerApi @RequiresOptIn (Iab690)
• تمت إضافة واجهات برمجة تطبيقات تسهيل الاستخدام CollectionInfo وCollectionItemInfo التي تتيح وضع علامة على المجموعة وعناصرها لخدمات تسهيل الاستخدام (Id54ef وb/180479017).
• تمت إضافة SemanticsActions.ScrollToIndex لتمرير قائمة تتضمّن عناصر مفهرسة إلى العنصر الذي يتضمّن فهرسًا معيّنًا، وSemanticsProperties.IndexForKey للحصول على فهرس عنصر في قائمة تتضمّن عناصر مفتاحية. يتم تنفيذ كلا الإجرائين من خلال LazyList.
  • تمت إضافة SemanticsNodeInteraction.performScrollToIndex التي تنقل قائمة إلى الفهرس المحدّد، وSemanticsNodeInteraction.performScrollToKey التي تنقل قائمة إلى العنصر الذي يتضمّن المفتاح المحدّد. (I4fe63، b/178483889، b/161584524)
• تمت إضافة ownerViewId إلى GraphicLayerInfo (I19f62)
• تمت إضافة عمليات تحميل زائدة إلى Font() لتحميل الخطوط من مواد العرض والملفات وFileDescriptor (I5d382)
• تمت إضافة واجهة برمجة تطبيقات تسهيل الاستخدام error التي تتيح وضع علامة على عقدة تحتوي على إدخال غير صالح (I12997، b/180584804، b/182142737)
• تمت إضافة Font() حمولات زائدة لتحميل الخطوط من مواد العرض والملفات وFileDescriptor (I43007)
• إتاحة حفظ AnnotatedString في TextFieldValue.Saver تمّت إضافة الدالتَين المساعدتَين addTtsAnnotation وwithAnnotation إلى AnnotatedString.Builder (I8cbdc، b/178446304)
• تمت إضافة دالة إنشاء TextUnit TextUnit(value: Float, type: TextUnitType) (I7ecce، b/178446304)

الإصدار ‎1.0.0-beta05

‫21 أبريل 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-beta05. يتضمّن الإصدار 1.0.0-beta05 هذه التعديلات.

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

• تمّت إضافة FocusManager.moveFocus(In) وFocusManager.moveFocus(Out) التجريبيتين (Ic5534، b/183746743)
• تمت إضافة واجهة برمجة التطبيقات التجريبية performTextInputSelection (I2dcbb، b/178510628)
• تم إيقاف واجهة InputEventCallback نهائيًا. لم يكن من الممكن استخدام الواجهة في أي واجهة برمجة تطبيقات عامة، ولم يتم استخدامها في الرمز البرمجي. (I34a02، b/184003208)
• تم إيقاف الدالة TextLayoutResult/createTextLayoutResult نهائيًا. وهي دالة عامة غير مستخدَمة تمت إضافتها لأغراض الاختبار. لا تنفّذ الدالة أي إجراء قابل للاستخدام مع واجهات برمجة التطبيقات النصية في Compose. تم إيقاف هذه الوظيفة نهائيًا وستتم إزالتها لاحقًا. (I80413)

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

• تم إصلاح إجراءات التمرير الخاصة بتسهيل الاستخدام في ACTION_SCROLL_FORWARD وACTION_SCROLL_BACKWARD وaccessibilityActionScrollLeft وaccessibilityActionScrollUp وaccessibilityActionScrollRight وaccessibilityActionScrollDown. بدلاً من التمرير إلى نهاية المحتوى القابل للتمرير، سيتم الآن التمرير بمقدار شاشة واحدة في الاتجاه المحدّد. (Ieccb0)
• أصبحت ملفات AndroidManifest من ui-test-manifest وui-tooling-data متوافقة الآن مع Android 12 (I6f9de وb/184718994).

الإصدار ‎1.0.0-beta04

‫7 أبريل 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-beta04. يتضمّن الإصدار 1.0.0-beta04 هذه التعديلات.

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

• أعِد تسمية hideSoftwareKeyboard وshowSoftwareKeyboard على SoftwareKeyboardController إلى hide() وshow() على التوالي.
  • توفير واجهة CompositionLocal الكاملة لفئة LocalSoftwareKeyboardController، ما يسمح بضبطها (مفيد بشكل خاص في الاختبارات) (I579a6)
• تمت إضافة واجهة برمجة التطبيقات LiveRegion التي تتيح استخدام أدوات تسهيل الاستخدام. إذا تم وضع علامة على العقدة كمحتوى ديناميكي متغيّر، ستُعلم خدمات تسهيل الاستخدام المستخدم تلقائيًا بالتغييرات التي تطرأ عليها (Idcf6f، b/172590946).
• تم تقديم TextOverflow.Visible. (Ic8f89)

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

• تم إصلاح المشكلة التي كانت تؤدي إلى تحديد موضع عناصر LazyColumn/LazyRow الموجودة على الحواف بشكل غير صحيح بعد التقديم السريع (Ie4d13، b/183877420)
• تزيل AndroidViewBinding الآن بشكل صحيح الأجزاء التي تم تضخيمها من خلال FragmentContainerView عند إزالة AndroidViewBinding من التسلسل الهرمي لـ Compose. (Ib0248، b/179915946)
• تعمل السمة AndroidViewBinding الآن على تضمين الأجزاء التي تم توسيعها من خلال FragmentContainerView بشكل صحيح عندما يكون ComposeView ضمن Fragment، ما يؤدي إلى حل المشاكل المتعلقة بحفظ حالة هذه الأجزاء واستعادتها. (I70eb0، b/179915946)
• تعتمد Compose ViewBinding الآن على Fragment 1.3.2 وتعرض الآن باستمرار الأجزاء التي تم تضخيمها من خلال FragmentContainerView بعد تغييرات الإعدادات. (I0743d، b/179915946)

الإصدار ‎1.0.0-beta03

‫24 مارس 2021

تم طرح androidx.compose.ui:ui-*:1.0.0-beta03. يتضمّن الإصدار 1.0.0-beta03 هذه التعديلات.

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

• التحقّق المؤجّل من التبعيات في ViewTree الخاصة بـ ComposeView (I8dbbf، b/182466548)
• تمت إضافة المَعلمتَين الاختياريتَين startX/endX وstartY/endY إلى الدوال swipeUp/swipeDown/swipeLeft/swipeRight في GestureScope. (I49e2d، b/182063305)