إنشاء Material3 بشكل تكيُّفي

  
استخدام مكتبة Material 3 التكيُّفية لإنشاء واجهات مستخدم تكيُّفية تتكيّف تلقائيًا وفقًا للنافذة الحالية مثل فئات حجم النافذة أو وضعيات الأجهزة. توفر المكتبة كل من عمليات تنفيذ عناصر الإدارة الافتراضية والعناصر الضرورية للإنشاء لإنشاء تجارب مخصّصة لك
التعديل الأخير الإصدار المستقر سحب المرشح الإصدار التجريبي إصدار أولي
4 سبتمبر 2024 1.0.0 - - 1.1.0-alpha02

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

لإضافة اعتمادية على 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. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية عن طريق بالنقر فوق زر النجمة.

إنشاء عدد جديد

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

إنشاء الإصدار 1.1 التكيُّفي من Material3

الإصدار 1.1.0-alpha02

4 سبتمبر 2024

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

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

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

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

  • إضافة APis لتوسيع الجزء الناقص إلى السقالات (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)

إنشاء الإصدار 1.0 التكيُّفي من Material3

الإصدار 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).

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

  • تغيير الكسر الانتقالي إلى lambda (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