طراحی متریال برای XR

با کامپوننت‌ها و طرح‌بندی‌های متریال که برای واقعیت افزوده (XR) سازگار هستند، بسازید
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۲۲ اکتبر ۲۰۲۵ - - - ۱.۰.۰-آلفا۱۲

اعلام وابستگی‌ها

برای افزودن یک وابستگی به هسته XR Compose Material3، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven گوگل را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

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

کاتلین 

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

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۱۲

۲۲ اکتبر ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha12 منتشر شد. نسخه 1.0.0-alpha12 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • SpaceModeToggleButton برای تغییر بین HomeSpace و FullSpace اضافه شد ( Ic6865 )

رفع اشکالات

  • بهبود نوارهای ابزار XR ( Ied1f5 )

نسخه ۱.۰.۰-آلفا۱۱

۲۷ آگوست ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha11 منتشر شد. نسخه 1.0.0-alpha11 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل رفتار FAB در XR NavRail ( Ibe20b )

نسخه ۱.۰.۰-آلفا۱۰

۳۰ ژوئیه ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha10 منتشر شد. نسخه 1.0.0-alpha10 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ایجاد پیاده‌سازی XR و ComponentOverride برای نوار ابزار افقی و عمودی ( 0e9496c ، dcfef96 )

رفع اشکالات

  • رفع مشکل عدم نمایش برخی از محتوا در پنجره XR ( c82e61b )

نسخه ۱.۰.۰-آلفا۰۸

۲۰ مه ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha08 منتشر شد. نسخه 1.0.0-alpha08 شامل این کامیت‌ها است.

رفع اشکالات

  • رفع مشکل کرش کردن ListDetailPaneScaffold یا SupportingPaneScaffold که فرزندی نداشتند ( 46df990 )
  • حداقل ضخامت دیواره داخلی مواد XR به 24 ( 6064706 )

نسخه ۱.۰.۰-آلفا۰۷

۷ مه ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha07 منتشر شد. نسخه 1.0.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

  • پروژه‌هایی که با کاتلین ۲.۰ منتشر شده‌اند، برای استفاده به KGP ۲.۰.۰ یا جدیدتر نیاز دارند. ( IDb6b5 )

نسخه ۱.۰.۰-alpha06

۲۶ مارس ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 شامل این کامیت‌ها است.

نسخه ۱.۰.۰-آلفا۰۵

۱۲ مارس ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha05 منتشر شد. نسخه 1.0.0-alpha05 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • TopAppBar به طور پیش‌فرض هنگام استفاده از EnableXrComponentOverrides به صورت مکانی به یک Orbiter تبدیل می‌شود.
  • هنگام استفاده از EnableXrComponentOverrides به طور پیش‌فرض، Material AlertDialog به صورت SpatialPanel نمایش داده می‌شود.

تغییرات API

  • تغییر نام انواع ComponentOverride به Override و انواع ComponentOverrideContext به OverrideScope ( Id973c )

رفع اشکالات

  • رفع مشکل نام‌گذاری و اسکریمینگ نادرست در NavigationRail و NavigationBar فضایی ( I9db52 )

نسخه ۱.۰.۰-آلفا۰۴

۲۶ فوریه ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha04 منتشر شد. نسخه 1.0.0-alpha04 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • ListDetailPaneScaffold و SupportingPaneScaffold هنگام استفاده از EnableXrComponentOverrides ( I166b0 ) به طور پیش‌فرض SpatialPanels استفاده می‌کنند.

تغییرات API

  • دریافت‌کننده‌های DefaultNavigationRailOrbiterProperties و DefaultNavigationBarOrbiterProperties دیگر @Composable ( I61618 ) نیستند.
  • LocalNavigationRailOrbiterProperties و LocalNavigationBarOrbiterProperties دیگر قابل تهی‌سازی نیستند ( I61618 )

نسخه ۱.۰.۰-آلفا۰۳

۱۲ فوریه ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha03 بدون هیچ تغییر قابل توجهی از آخرین نسخه آلفا منتشر شده است. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

نسخه ۱.۰.۰-آلفا۰۲

۲۹ ژانویه ۲۰۲۵

androidx.xr.compose.material3:material3:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • فعال کردن سفارشی‌سازی ویژگی‌های Orbiter در XR NavigationBar و NavigationRail ( Ic300f )

تغییرات API

  • ایجاد قابلیت لغو ThreePaneScaffold در XR ( Ib66f1 )
  • پیاده‌سازی لغو Pane غیر متحرک برای XR ( I7f620 )
  • افزودن و استفاده از حاشیه‌نویسی آزمایشی جدید ExperimentalMaterial3ComponentOverrideApi ( Ia1eaf )

رفع اشکالات

  • وابستگی XR به XR Compose را پین کنید ( Ia02cc )

نسخه ۱.۰.۰-آلفا۰۱

۱۲ دسامبر ۲۰۲۴

androidx.xr.compose.material3:material3:1.0.0-alpha01 منتشر شد.

ویژگی‌های انتشار اولیه

نسخه اولیه توسعه‌دهندگان از طراحی متریال برای XR. با استفاده از کتابخانه موجود متریال ۳، کامپوننت‌ها و طرح‌بندی‌های تطبیقی ​​با رفتارهای رابط کاربری فضایی بهبود یافته‌اند. می‌توانید مستقیماً با کامپوننت‌های M3 XR بسازید، یا پیاده‌سازی فعلی خود را با اضافه کردن پوشش EnableXrComponentOverrides تطبیق دهید. برای اطلاعات بیشتر به این راهنمای توسعه‌دهندگان مراجعه کنید.

سازگاری‌های XR پشتیبانی‌شده:

مشکلات شناخته شده

  • ListDetailPaneScaffold و SupportingPaneScaffold در حال حاضر از چندین پنل مکانی پشتیبانی نمی‌کنند.