التصميم المتعدد الأبعاد لتجربة الواقع المُمتد

إنشاء تطبيقات باستخدام مكوّنات وتنسيقات Material تتكيّف مع تجربة الواقع المُمتد
آخر خبر الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫19 مايو 2026 - - - ‫1.0.0-alpha17

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

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

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

Groovy

dependencies {
    // Use to implement XR Compose Material3
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
}

Kotlin

dependencies {
    // Use to implement XR Compose Material3
   implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
}

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

الملاحظات

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

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

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

الإصدار 1.0

الإصدار ‎1.0.0-alpha17

‫19 مايو 2026

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha17. يتضمّن الإصدار ‎1.0.0-alpha17 هذه التعديلات.

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

  • تم تغيير Orbiter لاستخدام OrbiterAnchorPoint + VolumeOffset أو OrbiterPoseProvider بدلاً من الموضع والإزاحة و`offsetType` والمحاذاة والارتفاع. تم أيضًا إزالة المعلَمة shouldRenderInNonSpatial. إذا لم يرِد للمطوّر عرض `Orbiter` في مساحة غير مكانية، عليه تضمين `Orbiter` في عبارة if والتحقّق من SpatialCapabilities. (I9fbb3)
  • تمت إضافة المعدِّلات القابلة للنقل. تعمل هذه المعدِّلات حاليًا مع SpatialPanels وSpatialExternalSurface. ستكون متاحة في المستقبل لـ SpatialGltfModel وفي النهاية لجميع SubspaceComposables. (I9a3cd)

الإصدار ‎1.0.0-alpha16

‫25 مارس 2026

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha16. يتضمّن الإصدار ‎1.0.0-alpha16 هذه التعديلات.

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

  • تم تغيير Orbiter لاستخدام OrbiterAnchorPoint + VolumeOffset أو OrbiterPoseProvider بدلاً من position وoffset وoffsetType وalignment والارتفاع. تم أيضًا إزالة المعلَمة shouldRenderInNonSpatial. إذا لم يرِد للمطوّر عرض `Orbiter` في مساحة غير مكانية، عليه تضمين `Orbiter` في عبارة if والتحقّق من SpatialCapabilities. (I9fbb3, b/462428503)

الإصدار ‎1.0.0-alpha15

‫25 فبراير 2026

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha15. يتضمّن الإصدار ‎1.0.0-alpha15 هذه التعديلات.

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

  • تغييرات في مساحة الحشو الخاصة بمعدِّل المساحة الفرعية من أجل مراعاة اتجاه التنسيق (I53e25، b/475290780، b/474410590)

الإصدار ‎1.0.0-alpha14

‫28 يناير 2026

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha14. يتضمّن الإصدار ‎1.0.0-alpha14 هذه التعديلات.

الإصدار ‎1.0.0-alpha13

‫03 ديسمبر 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha13. يتضمّن الإصدار ‎1.0.0-alpha13 هذه التعديلات.

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

  • إنشاء عملية تنفيذ لتجربة الواقع المُمتد وComponentOverride لـ WideNavigationRail وModalWideNavigationRail (I1e86d، b/407769444)
  • تستخدم الآن كل من NavigationSuiteScaffold وListDetailPaneScaffold وSupportingPaneScaffold السمة recommendedContentBoxInFullSpace لضبط أحجامها التلقائية (Ic54f1، b/388111668، b/394913962، b/394913962)

الإصدار ‎1.0.0-alpha12

‫22 أكتوبر 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha12. يتضمّن الإصدار ‎1.0.0-alpha12 هذه التعديلات.

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

  • تمت إضافة SpaceModeToggleButton للتبديل بين HomeSpace وFullSpace (Ic6865)

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

  • تحسين أشرطة الأدوات في تجربة الواقع المُمتد (Ied1f5)

الإصدار ‎1.0.0-alpha11

‫27 أغسطس 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha11. يتضمّن الإصدار ‎1.0.0-alpha11 هذه التعديلات.

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

  • إصلاح سلوك الزر العائم في `NavRail` لتجربة الواقع المُمتد (Ibe20b)

الإصدار ‎1.0.0-alpha10

‫30 يوليو 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha10. يتضمّن الإصدار ‎1.0.0-alpha10 هذه التعديلات.

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

  • إنشاء عملية تنفيذ لتجربة الواقع المُمتد وComponentOverride لشريط الأدوات الأفقي والعمودي (0e9496c, dcfef96)

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

  • إصلاح مشكلة عدم عرض بعض المحتوى في مربّع الحوار لتجربة الواقع المُمتد (c82e61b)

الإصدار ‎1.0.0-alpha08

‫20 مايو 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha08. يتضمّن الإصدار ‎1.0.0-alpha08 هذه التعديلات.

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

  • إصلاح مشكلة تعطُّل التطبيق عندما لا يكون لدى ListDetailPaneScaffold أو SupportingPaneScaffold أي عناصر فرعية (46df990)
  • خفض `minSdk` في Material XR إلى 24 (6064706)

الإصدار ‎1.0.0-alpha07

‫7 مايو 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha07. يتضمّن الإصدار ‎1.0.0-alpha07 هذه التعديلات.

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

  • تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام الإصدار 2.0.0 أو إصدار أحدث من KGP. (Idb6b5)

الإصدار ‎1.0.0-alpha06

‫26 مارس 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha06. يتضمّن الإصدار ‎1.0.0-alpha06 هذه التعديلات.

الإصدار ‎1.0.0-alpha05

‫12 مارس 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha05. يتضمّن الإصدار ‎1.0.0-alpha05 هذه التعديلات.

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

  • يتم تلقائيًا تحويل TopAppBar إلى `Orbiter` عند استخدام EnableXrComponentOverrides.
  • يتم تلقائيًا تحويل AlertDialog في Material إلى SpatialPanel عند استخدام EnableXrComponentOverrides.

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

  • تمت إعادة تسمية أنواع ComponentOverride إلى Override، وأنواع ComponentOverrideContext إلى OverrideScope (Id973c)

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

  • تم إصلاح مشكلة التمويه والتعتيم غير الصحيحَين في NavigationRail وNavigationBar اللذَين تم تحويلهما إلى مساحة مكانية. (I9db52)

الإصدار ‎1.0.0-alpha04

‫26 فبراير 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha04. يتضمّن الإصدار ‎1.0.0-alpha04 هذه التعديلات.

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

  • تستخدم كل من ListDetailPaneScaffold وSupportingPaneScaffold السمة SpatialPanels تلقائيًا عند استخدام EnableXrComponentOverrides (I166b0)

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

  • لم تعُد دوال جلب DefaultNavigationRailOrbiterProperties وDefaultNavigationBarOrbiterProperties تتضمّن الرمز @Composable (I61618)
  • لم يعُد كل من LocalNavigationRailOrbiterProperties وLocalNavigationBarOrbiterProperties يقبلان القيم الخالية (I61618)

الإصدار ‎1.0.0-alpha03

‫12 فبراير 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha03 بدون أي تغييرات ملحوظة منذ الإصدار الأولي الأخير. يتضمّن الإصدار ‎1.0.0-alpha03 هذه التعديلات.

الإصدار ‎1.0.0-alpha02

‫29 يناير 2025

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha02. يتضمّن الإصدار ‎1.0.0-alpha02 هذه التعديلات.

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

  • تفعيل تخصيص خصائص Orbiter في NavigationBar وNavigationRail لتجربة الواقع المُمتد (Ic300f)

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

  • إمكانية إلغاء ThreePaneScaffold في تجربة الواقع المُمتد (Ib66f1)
  • تنفيذ عملية إلغاء `Pane` غير متحركة لتجربة الواقع المُمتد (I7f620)
  • إضافة واستخدام التعليق التوضيحي التجريبي الجديد ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

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

  • تثبيت اعتمادية Material3 XR على XR Compose (Ia02cc)

الإصدار ‎1.0.0-alpha01

‫12 ديسمبر 2024

تم إصدار androidx.xr.compose.material3:material3:1.0.0-alpha01.

ميزات الإصدار الأولي

الإصدار الأولي من "التصميم المتعدد الأبعاد لتجربة الواقع المُمتد" للمطوّرين باستخدام مكتبة Material 3 الحالية، يتم تحسين المكوّنات والتنسيقات التكيّفية من خلال سلوكيات واجهة المستخدم المكانية. يمكنك إنشاء التطبيقات مباشرةً باستخدام مكوّنات M3 XR، أو تكييف عملية التنفيذ الحالية من خلال إضافة أداة التغليف EnableXrComponentOverrides. مزيد من المعلومات في دليل المطوّر هذا

عمليات التكييف المتاحة لتجربة الواقع المُمتد:

المشاكل المعروفة

  • لا يتيح حاليًا كل من `ListDetailPaneScaffold` و`SupportingPaneScaffold` استخدام لوحات مكانية متعددة