‫Material Design ל-XR

יצירה באמצעות רכיבים ופריסות של Material שמותאמים ל-XR
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫19 במאי 2026 - - - ‎1.0.0-alpha17

הצהרה על יחסי תלות

כדי להוסיף תלות ב-XR Compose Material3 core, צריך להוסיף את מאגר Maven של Google לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

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

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גירסה 1.0

גרסה ‎1.0.0-alpha17

‫19 במאי 2026

‫androidx.xr.compose.material3:material3:1.0.0-alpha17 מופץ. גרסה ‎1.0.0-alpha17 מכילה את השמירות האלה.

שינויים ב-API

  • השתנה Orbiter לשימוש ב-OrbiterAnchorPoint + VolumeOffset או ב-OrbiterPoseProvider במקום במיקום, בהיסט, ב-offsetType, ביישור ובגובה. הוסר גם הפרמטר shouldRenderInNonSpatial. אם המפתח לא רוצה שהאובייקט ירוץ במיקום לא מרחבי, הוא צריך להוסיף אותו לתוך משפט 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 מכילה את השמירות האלה.

שינויים ב-API

  • השתנה השימוש ב-Orbiter לשימוש ב-OrbiterAnchorPoint + VolumeOffset או ב-OrbiterPoseProvider במקום ב-position,‏ offset,‏ offsetType,‏ alignment ובגובה. הוסר גם הפרמטר shouldRenderInNonSpatial. אם המפתח לא רוצה שהאובייקט ירוץ במיקום לא מרחבי, הוא צריך להוסיף אותו לתוך משפט if ולבדוק את SpatialCapabilities. (I9fbb3, ‏ b/462428503)

גרסה ‎1.0.0-alpha15

‫25 בפברואר 2026

‫androidx.xr.compose.material3:material3:1.0.0-alpha15 מופץ. גרסה ‎1.0.0-alpha15 מכילה את השמירות האלה.

שינויים ב-API

  • שינויים בריווח של עיבוד מרחבים משניים כדי להתאים לכיוון הפריסה (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

‫3 בדצמבר 2025

‫androidx.xr.compose.material3:material3:1.0.0-alpha13 מופץ. גרסה ‎1.0.0-alpha13 מכילה את השמירות האלה.

תכונות חדשות

  • יצירת הטמעה של XR ושל 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)

תיקוני באגים

  • שיפור סרגלי הכלים של XR‏ (Ied1f5)

גרסה ‎1.0.0-alpha11

‫27 באוגוסט 2025

‫androidx.xr.compose.material3:material3:1.0.0-alpha11 מופץ. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון ההתנהגות של לחצן הפעולה הצף ב-XR NavRail ‏ (Ibe20b)

גרסה ‎1.0.0-alpha10

‫30 ביולי 2025

‫androidx.xr.compose.material3:material3:1.0.0-alpha10 מופץ. גרסה ‎1.0.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

  • יצירת הטמעה של XR ו-ComponentOverride עבור סרגל כלים אופקי ואנכי (0e9496c, ‏ dcfef96)

תיקוני באגים

  • תיקון של בעיה שגורמת לכך שחלק מהתוכן לא מוצג בתיבת הדו-שיח של XR ‏ (c82e61b)

גרסה ‎1.0.0-alpha08

‫20 במאי 2025

‫androidx.xr.compose.material3:material3:1.0.0-alpha08 מופץ. גרסה ‎1.0.0-alpha08 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון קריסה כש-ListDetailPaneScaffold או SupportingPaneScaffold לא מכילים רכיבי צאצא (46df990)
  • הורדת Material XR minSdk ל-24 (6064706)

גרסה ‎1.0.0-alpha07

‫7 במאי 2025

‫androidx.xr.compose.material3:material3:1.0.0-alpha07 מופץ. גרסה ‎1.0.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP בגרסה 2.0.0 ומעלה. (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 מכילה את השמירות האלה.

תכונות חדשות

  • כשמשתמשים ב-EnableXrComponentOverrides,‏ TopAppBar מומר כברירת מחדל ל-Orbiter.
  • כברירת מחדל, כשמשתמשים ב-EnableXrComponentOverrides, חומר AlertDialog עובר מרחבי ל-SpatialPanel.

שינויים ב-API

  • שינוי השם של סוגי ComponentOverride ל-Override, ושל סוגי ComponentOverrideContext ל-OverrideScope (Id973c)

תיקוני באגים

  • תיקון של aliasing ושל scrimming שגוי בתוכן מרחבי 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)

שינויים ב-API

  • המאפיינים DefaultNavigationRailOrbiterProperties ו-DefaultNavigationBarOrbiterProperties כבר לא@Composable (I61618)
  • השדות LocalNavigationRailOrbiterProperties ו-LocalNavigationBarOrbiterProperties לא יכולים יותר להכיל ערך null (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 ב-XR NavigationBar וב-NavigationRail. (Ic300f)

שינויים ב-API

  • יצירת אפשרות לשינוי ברירת המחדל של ThreePaneScaffold ב-XR‏ (Ib66f1)
  • הטמעה של ביטול ברירת מחדל של חלונית לא מונפשת עבור XR ‏ (I7f620)
  • הוספה ושימוש בהערה ניסיונית חדשה ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

תיקוני באגים

  • הצמדת התלות של Material3 XR ב-XR Compose. (Ia02cc)

גרסה 1.0.0-alpha01

‫12 בדצמבר 2024

‫androidx.xr.compose.material3:material3:1.0.0-alpha01 מופץ.

תכונות של הגרסה הראשונית

השקנו גרסה ראשונית של Material Design ל-XR למפתחים. הספרייה הקיימת של Material 3, הרכיבים והפריסות הדינמיות משופרים באמצעות התנהגויות מרחביות של ממשק המשתמש. אפשר ליצור ישירות באמצעות רכיבי M3 XR, או להתאים את ההטמעה הנוכחית על ידי הוספת רכיב העטיפה EnableXrComponentOverrides. מידע נוסף זמין במדריך למפתחים.

התאמות נתמכות של XR:

בעיות מוכרות

  • נכון לעכשיו, הרכיבים ListDetailPaneScaffold ו-SupportingPaneScaffold לא תומכים בכמה חלוניות מרחביות