Compose Material 3 Adaptive

الإعلان عن التبعيات

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

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

dependencies {
    implementation "androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02")
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإنشاء.

ملاحظات

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

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

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

Compose Material3 Adaptive Version 1.1

الإصدار 1.1.0-alpha08

12 كانون الأول (ديسمبر) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha08. يتضمّن الإصدار 1.1.0-alpha08 عمليات الربط هذه.

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

• عرِّف المستخدمين على الدالة currentWindowDpSize. (I99125، b/296300441)
• تعريض PaneScaffoldParentData وThreePaneScaffoldHorizontalOrder.toLtrOrder() (I2d6b7)
• أزِل PaneScaffoldMotionScope واجعله حقلًا ضمن PaneScaffoldTransitionScope. أعِد أيضًا تسميتها إلى PaneScaffoldMotionDataProvider وأزِل إذن الوصول إلى بنية البيانات الأساسية لـ PaneMotionData، وبدلًا من ذلك، قدِّم طرقًا للحصول على البيانات وتكرارها للوصول إليها. (Id8884)
• أنشئ آلية إلغاء لـ ThreePaneScaffold لتتمكّن من تنفيذ عمليات التثبيت من مصدر غير معروف لأشكال أجهزة مختلفة. (I5280f)
• تجعل حالة توسيع اللوحة فارغة تلقائيًا (Ia65f8، b/376394520)

الإصدار 1.1.0-alpha07

13 تشرين الثاني (نوفمبر) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha07. يتضمّن الإصدار 1.1.0-alpha07 عمليات الربط هذه.

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

• أزِل تنفيذ مقبض السحب في المكتبة التكيُّفية وشجِّع المستخدمين على استخدام إصدار M3 منها. وفي الوقت نفسه، يمكنك تقديم مُعدِّل لتوفير إمكانية سحب توسيع اللوحة إلى مقبض سحب قابل للتركيب. يمكنك أيضًا إخفاء DraggableState كتفاصيل تنفيذ حتى نتمكّن من تغييرها لاحقًا إذا لزم الأمر. (Ib50cd)
• نقل نقطة دخول تخصيص حركة اللوحة من دوالّ الإطار إلى AnimatedPane وفقًا لملاحظات خبراء تجربة المستخدم (I10f72)
• توفير إمكانية التمرير السريع وتوفير مواصفات مخصّصة للصور المتحركة لتوسيع اللوحة (Ie207d، b/362584341)

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

• حلّ المشاكل المتعلّقة بعرض الإعلانات المتوقّعة عند الإلغاء (36a3e0a)، (b/369899645)

الإصدار 1.1.0-alpha06

30 تشرين الأول (أكتوبر) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha06. يتضمّن الإصدار 1.1.0-alpha06 عمليات الربط هذه.

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

• أضِف FloatRange إلى PaneScaffoldTransitionScope.motionProgress. (Iac0dd)
• غيِّر نوع مَعلمات المخطِّط إلى أنواع عامة في الهياكل الأساسية القابلة للتنقّل. (I1da6e)

الإصدار 1.1.0-alpha05

16 أكتوبر 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha05. يتضمّن الإصدار 1.1.0-alpha05 عمليات الربط هذه.

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

• تقديم فئة مواصفات الصور المتحركة لضمان سلوك حركة أكثر اتساقًا وقابلية للتوسيع في المستقبل (I2d3cc)
• أدخِل نوع الحركة وأعِد تسمية currentXXXXX في PaneMotionData إلى originXXXX. (I7c61a)

الإصدار 1.1.0-alpha04

2 أكتوبر 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha04. يتضمّن الإصدار 1.1.0-alpha04 عمليات الربط هذه.

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

• تمت إضافة ميزة "الرجوع التوقّعي" إلى NavigableListDetailPaneScaffold وNavigableSupportingPaneScaffold. (I4dc21، b/359616816)

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

• تمت إضافة ThreePaneScaffoldState إلى ThreePaneScaffoldNavigator. تم تصميم طرق التنقّل suspend لتتيح التنقّل باستخدام الصور المتحركة. تمت إضافة seekBack لإتاحة حالات التنقّل الجزئية (مثل الرجوع التوقّعي). (I5a651، b/359616816)
• تمت إضافة MutableThreePaneScaffoldState للتحكّم في الانتقال بين قيم الإطار. تم ضبط ThreePaneScaffoldState الحالي على "للقراءة فقط". (Idb3c6)
• عرض عمليات تنفيذ حركة اللوحة التلقائية (I95a7b)
• تفعيل ضبط العنصر الأساسي الأولي لحالة توسيع اللوحة (Ie41b3، b/362350560)

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

• فرض الحد الأدنى لحجم استهداف اللمس لمقبّل السحب على 48×48dp (7ce6635، b/366018217)
• استعادة موضع الربط بعد تغييرات الإعداد (3c9fc6b، b/362353672)

الإصدار 1.1.0-alpha03

18 أيلول (سبتمبر) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha03. يتضمّن الإصدار 1.1.0-alpha03 عمليات الربط هذه.

الإصدار 1.1.0-alpha02

4 أيلول (سبتمبر) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha02. يتضمّن الإصدار 1.1.0-alpha02 عمليات الربط هذه.

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

• يمكن لصنّاع المحتوى تخصيص الصور المتحركة (I0bf9c) و(I80e66) لتغيير الصور المتحركة التلقائية أثناء تغييرات حالة الإطارات الأساسية التكيُّفية. يمكن لصنّاع المحتوى الاختيار من بين مجموعة من الانتقالات التلقائية للدخول والخروج، أو تنفيذ انتقالات مخصّصة بالكامل باستخدام المعلومات المقدَّمة من خلال نطاقات الحركة الجديدة.
• تنفيذ صورة متحركة للاختفاء لمقابض سحب توسيع اللوحة (46e3c69)
• إتاحة حفظ PaneExpansionState التي تم تذكُّرها (61ff76f)

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

• إضافة واجهات برمجة التطبيقات غير المتوفّرة لتوسيع اللوحة إلى تصاميم الإطارات الأساسية (Ic5bc0)
• تمت إعادة تسمية ThreePaneScaffoldDestinationItem.content إلى contentKey. تم تغيير مَعلمة النوع التلقائي لـ rememberListDetailPaneScaffoldNavigator وrememberSupportingPaneScaffoldNavigator من Nothing إلى Any. (I58749)
• وضع علامة على ThreePaneScaffoldState على أنّه إصدار ثابت (I64aec)
• ضبط نطاق مَعلمات مقابض السحب (Ic0aa2)

الإصدار 1.1.0-alpha01

21 آب (أغسطس) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 عمليات الربط هذه.

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

• توفير إمكانية توسيع اللوحة في إطارات العمل التكيُّفية

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

• إتاحة واجهات برمجة التطبيقات الخاصة بتوسيع الأقسام للجميع (I301d6)
• تمّ تقديم ThreePaneScaffoldState للتحكّم في انتقالات قيم اللوحة. تمّت إضافة حالات تحميل زائدة ListDetailPaneScaffold وSupportingPaneScaffold التي تقبل هذه الحالة. (I5db3b)
• تقديم مفتاح توسيع اللوحة وواجهة مقدّم المفتاح (Id621f)

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

• إصلاح احتساب غير صحيح للقسم عند ظهور مفصلات مستبعدة (9dfd483)

Compose Material3 Adaptive Version 1.0

الإصدار 1.0.0

4 أيلول (سبتمبر) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.

الميزات الرئيسية في الإصدار 1.0.0

• دوال قابلة للتجميع من سطر واحد currentWindowSize() وcollectFoldingFeaturesAsState() وcurrentWindowAdaptiveInfo() للحصول على معلومات النافذة المطلوبة لتكييف التطبيقات، مثل أحجام النوافذ وميزات الطي
• ‫ListDetailPaneScaffold وSupportingPaneScaffold لتوفير تنسيقَين أساسيَين من Material3 يتكيّفان تلقائيًا وفقًا لإعدادات النوافذ المختلفة يمكن أيضًا تخصيص هذين الهيكلَين بالكامل ليناسبا احتياجات صنّاع المحتوى المختلفة.
• ThreePaneScaffoldNavigator ودوالّ التذكر ذات الصلة، rememberListDetailPaneScaffoldNavigator() وrememberSupportingPaneScaffoldNavigator() لتوفير حلول للملاحة ضمن إطار عمل قابل للتكيّف، والذي يمكنه عرض وجهات متعددة للملاحة في الوقت نفسه، مقارنةً بالإعداد الشائع لوجهة واحدة في كل مرة في العالم غير المتوافق.
• الرسومات المتحركة التلقائية والمضمّنة في Material3 عند تغيير حالات إطار العمل التكيُّفي

الإصدار 1.0.0-rc01

21 آب (أغسطس) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على عمليات الربط هذه.

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

• إصلاح احتساب غير صحيح للقسم عند ظهور مفصلات مستبعدة (9dfd483)

الإصدار 1.0.0-beta04

26 حزيران (يونيو) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04. يتضمّن الإصدار 1.0.0-beta04 عمليات الربط هذه.

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

• إصلاح مشكلة عدم تعديل التنسيق وفقًا لتعديل حدود المفصل (71e9cf1)

الإصدار 1.0.0-beta03

12 يونيو 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03. يتضمّن الإصدار 1.0.0-beta03 عمليات الربط هذه.

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

• إصلاح الأعطال الناتجة عن حلّ التبعيات غير الصحيح في الإصدار التجريبي 02

الإصدار 1.0.0-beta02

29 أيار (مايو) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02. يتضمّن الإصدار 1.0.0-beta02 عمليات الربط هذه.

الإصدار 1.0.0-beta01

14 أيار (مايو) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01. يتضمّن الإصدار 1.0.0-beta01 عمليات الربط هذه.

الإصدار 1.0.0-alpha12

1 مايو 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12. يتضمّن الإصدار 1.0.0-alpha12 عمليات الربط هذه.

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

• إضافة معلومات isFlat إلى HingeInfo (Ie0516، b/333784198)
• جعل واجهات برمجة التطبيقات التكيُّفية غير تجريبية (I1d038)
• جعل واجهات برمجة التطبيقات للتنسيقات التكيُّفية غير تجريبية (Id23df)
• تم تغيير BackNavigationBehavior من قائمة أرقام مميزة إلى فئة قيمة (Id8757).

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

• تغيير جزء الانتقال إلى لامبادا (I6f5a9)
• حلّ مشكلة الحالة الأولية في SizeTracker (18326a9)
• تضمين قائمة الوصلات في عملية التحقّق من تساوي Posture (6687137)

الإصدار 1.0.0-alpha11

17 نيسان (أبريل) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11. يتضمّن الإصدار 1.0.0-alpha11 عمليات الربط هذه.

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

• يجب أن تكون واجهات النطاقات مغلقة. (Iefa57)
• عرِّف AnimatedPaneScope. (I62d73، b/332750742)
• يجب أن يكون AdaptStrategy محكم الإغلاق وثابتًا. (Ia28b2)
• أدخِل طريقة نسخ PaneScaffoldDirective. (I9291f)
• وضع علامة "تجريبي" على ThreePaneScaffoldScope (I9d527)
• يجب توفير واجهات برمجة تطبيقات سهلة الاستخدام لإطار العمل توفّر إمكانية التنقّل. (I263f0، b/321010778)

الإصدار 1.0.0-alpha10

3 نيسان (أبريل) 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10. يتضمّن الإصدار 1.0.0-alpha10 عمليات الربط هذه.

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

• اجعل العرض المفضّل التلقائي قابلاً للتكيّف والتخصيص. (Ic3abc)
• إعادة تسمية دوالّ حساب توجيهات الهيكل الأساسية (I10855)
• أزِل الحشوات والعناصر المضمّنة من واجهات برمجة التطبيقات لإطار العمل. (I786f8)
• أضِف طرق تذكُّر المستكشف بدون أنواع عامة. (I607c3)

الإصدار 1.0.0-alpha09

20 مارس 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 عمليات الربط هذه.

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

• أضِف حقول انتقال الحالة إلى ThreePaneScaffoldScope. (I3d917)
• إعادة ترتيب مَعلمات الهيكل (I4dff5)
• أدخِل القيمة التلقائية لمَعلمة المُعدِّل AnimatedPane. (I77dd7)

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

• يجب تضمين حجم الفاصل في حركات اللوحة. (a3174ca)

الإصدار 1.0.0-alpha08

‫6 مارس 2024

تم إصدار androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08. يحتوي الإصدار 1.0.0-alpha08 على عمليات الربط هذه.

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

• تنفيذ ميزة التمرير المتأخر للداخل عند تبديل الأقسام (I1a38e)

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

• تمت إزالة واجهة ThreePaneScaffoldState. (I63f23)

الإصدار 1.0.0-alpha07

21 شباط (فبراير) 2024