‫Material Design for XR

איך יוצרים אפליקציות עם רכיבים ופריסות של Material שמותאמים ל-XR
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫3 בדצמבר 2025 - - - ‎1.0.0-alpha13

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

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

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

מגניב

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

Kotlin

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

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא הכלי למעקב אחר בעיות.

גירסה 1.0

גרסה ‎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 מכילה את הקומטים האלה.

תכונות חדשות

  • כברירת מחדל, TopAppBar מומר ל-Orbiter כשהמשתמשים משתמשים ב-EnableXrComponentOverrides.
  • כברירת מחדל, כשמשתמשים ב-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 getters כבר לא@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 לא תומכים בכמה חלוניות מרחביות