Compose Material 3 Adaptive

  
استخدِم مكتبة Material 3 المتوافقة مع مختلف الأجهزة لإنشاء واجهات مستخدم متوافقة مع مختلف الأجهزة ستتلاءم تلقائيًا وفقًا لإعدادات النافذة الحالية، مثل فئات حجم النوافذ أو أوضاع الجهاز. توفّر المكتبة كلّ من عمليات تنفيذ إطار العمل التلقائية وعناصر الوحدات الأساسية اللازمة لإنشاء تجاربك المخصّصة.
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار التجريبي الأول
13 تشرين الثاني (نوفمبر) 2024 1.0.0 - - 1.1.0-alpha07

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

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

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

Groovy

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"
}

Kotlin

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-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