כרטיסי מידע ב-Wear

יצירת אפליקציות לשעונים חכמים של Wear OS by Google.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
13 בנובמבר 2024 1.4.1 - - 1.5.0-alpha04

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

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

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

Groovy

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0-alpha05"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha05"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha05"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha05"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha05"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha05"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0-alpha05")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha05")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha05")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha05")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha05")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha05")
}

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

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

גירסה 1.5

גרסה 1.5.0-alpha04

13 בנובמבר 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha04 משוחרר. גרסת 1.5.0-alpha04 כוללת את ההוספות האלה.

גרסה 1.5.0-alpha03

30 באוקטובר 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha03 משוחרר. גרסת 1.5.0-alpha03 מכילה את ההוספות האלה.

גרסה 1.5.0-alpha02

16 באוקטובר 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha02 משוחרר. גרסת 1.5.0-alpha02 כוללת את ההוספות האלה.

תיקוני אבטחה

  • החל מהשינוי הזה, androidx מבצע קומפילציה מול protobuf 4.28.2 כדי לטפל בבעיה CVE-2024-7254. כדי לטפל בסיכון של נקודת החולשה, צריך לשדרג את התלות בגרסה 1.5.0-alpha01 של androidx.wear.tiles:tiles-proto לגרסה 1.5.0-alpha02.

גרסה 1.5.0-alpha01

2 באוקטובר 2024

androidx.wear.tiles:tiles-*:1.5.0-alpha01 משוחרר. גרסת 1.5.0-alpha01 כוללת את ההוספות האלה.

גרסה 1.4

גרסה 1.4.1

16 באוקטובר 2024

androidx.wear.tiles:tiles-*:1.4.1 משוחרר. גרסה 1.4.1 מכילה את ההוספות האלה.

תיקוני אבטחה

  • החל מהשינוי הזה, androidx מבצע קומפילציה מול protobuf 4.28.2 כדי לטפל בבעיה CVE-2024-7254. כדי לטפל בסיכון של נקודת החולשה, צריך לשדרג את התלות בגרסה 1.4.0 של androidx.wear.tiles:tiles-proto לגרסה 1.4.1.

גרסה 1.4.0

7 באוגוסט 2024

androidx.wear.tiles:tiles-*:1.4.0 משוחרר. גרסת 1.4.0 כוללת את ההוספות האלה.

שינויים חשובים מאז גרסה 1.3.0

  • תמיכה בכלים להגדרת נתוני פלטפורמה בהתאמה אישית לקטע המקדים של המשבצות ב-Android Studio.

גרסה 1.4.0-rc01

24 ביולי 2024

androidx.wear.tiles:tiles-*:1.4.0-rc01 פורסמת ללא שינויים מהגרסה הקודמת. גרסת 1.4.0-rc01 כוללת את ההוספות האלה.

גרסה 1.4.0-beta01

10 ביולי 2024

androidx.wear.tiles:tiles-*:1.4.0-beta01 משוחרר. גרסת 1.4.0-beta01 כוללת את ההוספות האלה.

תכונות חדשות

הגרסה 1.4.0-beta01 של Wear Tiles מציינת שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול (למעט במקרים שבהם הוא מסומן כניסיוני). הגרסה 1.4 של Wear Tiles כוללת את הפונקציונליות ואת ממשקי ה-API החדשים הבאים:

  • תמיכה בכלים להגדרת נתוני פלטפורמה בהתאמה אישית לקטע המקדים של המשבצות ב-Android Studio.

גרסה 1.4.0-alpha05

26 ביוני 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha05 משוחרר. גרסת 1.4.0-alpha05 כוללת את ההוספות האלה.

גרסה 1.4.0-alpha04

29 במאי 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha04 משוחרר. גרסת 1.4.0-alpha04 מכילה את ההוספות האלה.

גרסה 1.4.0-alpha03

14 במאי 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha03 משוחרר. גרסת 1.4.0-alpha03 כוללת את ההוספות האלה.

תיקוני באגים

  • TileService#getActiveTilesAsync משתמש עכשיו ב-WearSdk API (כשהוא זמין) כדי לספק תוצאה מדויקת יותר. (I57bd8)

גרסה 1.4.0-alpha02

1 במאי 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha02 משוחרר. גרסה 1.4.0-alpha02 מכילה את ההוספות האלה.

שינויים ב-API

  • מעבירים את tileId לפרמטר של ה-Builder כשדה חובה, ומתעדים את ערך ברירת המחדל של חותמת הזמן ב-getter. (I98c2b)
  • מוסיפים את הודעות ה-proto TileInteractionEvent,‏ TileEnter ו-TileLeave ואת מעטפות ה-Java הנדרשות כדי לקבץ אירועי כניסה/יציאה של משבצות. (I112b0)
  • מבצעים שינוי מבני ב-TileRenderer כך שייעשה שימוש ב-Builder במקום באובייקט TileRenderer.Config. (Ib66f9)
  • מוסיפים מאפיין platformDataProviders ל-TileRenderer.Config. (I6030d)
  • מוסיפים ל-TileRenderer קונסטרוקטור חדש שתומך בכיתה TileRenderer.Config חדשה. קונסטרוקטורים אחרים הוצאו משימוש. (Iae7ff)
  • מוסיפים את השדה platformDataValues אל TilePreviewData כדי לאפשר לשנות את ערכי הנתונים מהפלטפורמה. (If437a)

תיקוני באגים

  • מתעדים שהערך שמוגדר כברירת מחדל ל-TileRenderer.Config.Builder#setTilesTheme הוא אפס. (Iced18)

גרסה 1.4.0-alpha01

6 במרץ 2024

androidx.wear.tiles:tiles-*:1.4.0-alpha01 משוחרר. גרסת 1.4.0-alpha01 כוללת את ההוספות האלה.

גרסה 1.3

גרסה 1.3.0

7 בפברואר 2024

androidx.wear.tiles:tiles-*:1.3.0 משוחרר. גרסה 1.3.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז גרסה 1.2.0

  • עדכנו את הכלים לתמיכה בתצוגה מקדימה של משבצות.
  • תמיכה בשליחת שאילתות על משבצות פעילות ששייכות לאפליקציה.

שינויים נוספים

גרסה 1.3.0-rc01

24 בינואר 2024

androidx.wear.tiles:tiles-*:1.3.0-rc01 משוחרר. גרסה 1.3.0-rc01 כוללת את ההצהרות האלה.

שינויים ב-API

  • השם של TileService#getActiveTilesSnapshotAsync השתנה ל-getActiveTilesAsync. (If6b87)

גרסה 1.3.0-beta01

10 בינואר 2024

androidx.wear.tiles:tiles-*:1.3.0-beta01 משוחרר. גרסה 1.3.0-beta01 מכילה את ההצהרות האלה.

הגרסה 1.3.0-beta01 של Wear Tiles מציינת שהגרסה הזו של הספרייה כוללת את כל התכונות וה-API נעול (למעט במקרים שבהם הוא מסומן כניסיוני). גרסה 1.3 של Wear Tiles כוללת את הפונקציונליות וה-API החדשים הבאים:

  • העדכנו את המודול של כלי ה-Tiles ל-Wear כך שיתמוך בתצוגה מקדימה של משבצות, והוא מוכן לפרסום.
  • תמיכה בשאילתות לגבי כרטיסי המידע של האפליקציה שפעילים באמצעות TileService.getActiveTilesSnapshotAsync.

גרסה 1.3.0-alpha04

13 בדצמבר 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha04 משוחרר. גרסה 1.3.0-alpha04 מכילה את ההצהרות האלה.

גרסה 1.3.0-alpha03

29 בנובמבר 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha03 משוחרר. גרסה 1.3.0-alpha03 מכילה את ההצהרות האלה.

תכונות חדשות

  • נוספה ממשק API חדש TileService#getActiveTilesSnapshotAsync לשליחת שאילתות לגבי המשבצות הפעילות ששייכות לאפליקציה. (I6850e)

שינויים ב-API

  • משנים את השם של @TilePreview ל-@Preview (Ifc08a)

גרסה 1.3.0-alpha02

15 בנובמבר 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha02 משוחרר. גרסה 1.3.0-alpha02 מכילה את ההצהרות האלה.

תכונות חדשות

  • הוספנו ממשק API ניסיוני כדי לשנות את גודל הטקסט באופן אוטומטי בהתאם למרחב שעומד לרשותו בתוך הרכיב ההורה. (Ibbe63)

גרסה 1.3.0-alpha01

18 באוקטובר 2023

androidx.wear.tiles:tiles-*:1.3.0-alpha01 משוחרר. גרסה 1.3.0-alpha01 כוללת את ההוספות האלה.

תכונות חדשות

  • צריך לספק את ההקשר כפרמטר של שיטת התצוגה המקדימה במקום פרמטרים של קריאה חוזרת (callback) מסוג TilePreviewData. (I5e97d)
  • העדכנו את המודול של כלי ה-Tiles ל-Wear כך שיתמוך בתצוגה מקדימה של משבצות, והוא מוכן לפרסום. (I63d0f)

גרסה 1.2

גרסה 1.2.0

9 באוגוסט 2023

androidx.wear.tiles:tiles-*:1.2.0 משוחרר. גרסה 1.2.0 מכילה את ההוספות האלה.

שינויים חשובים מאז גרסה 1.1.0

  • גרסה יציבה של Wear Tiles 1.2.0 (מידע נוסף)
  • בגרסה 1.2 של Tiles נוספה תמיכה בקישור רכיבי פריסה לנתוני פלטפורמה (לעדכונים מהירים יותר) ובאנימציה. להוראות למעבר, אפשר לעיין בנתוני הגרסה של (1.2.0-rc01)

גרסה 1.2.0-rc01

26 ביולי 2023

androidx.wear.tiles:tiles-*:1.2.0-rc01 משוחרר. גרסה 1.2.0-rc01 כוללת את ההוספות האלה.

  • במהלך השקת הגרסה 1.2, ספריית Tiles עברה עיבוד מחדש, ורוב התכונות וממשקי ה-API הועברו לספריית ProtoLayout החדשה (חבילת androidx.wear.protolayout), כאשר קבוצת משנה קטנה נשארה ב-Tiles (androidx.wear.tiles):

    • כל שמות הכיתות נשארו ללא שינוי, יש רק תוספות לגרסה 1.1
    • רוב ממשקי ה-API לא השתנו, והשינוי היחיד הוא שם החבילה.
    • חלק מהשיטות ב-TileService/TileBuilder הוצאו משימוש, ויש להן עכשיו גרסאות חדשות עם שמות שונים שמקבלות סוגי ProtoLayout חדשים במקום הסוג הישן של Tiles.

  • כדי להקל על המעבר, הכנו הוראות קצרות ו-script שמבצעים את שינוי השם. אפשר למצוא אותם כאן.

שינויים ב-API

  • הגבלנו את העומק המקסימלי של פריסה ל-30 רכיבים בתצוגת המשבצות. אם עוברים את העומק הזה, ה-renderer של המשבצות יציג פריסה שהתרחבה בעבר. (I8a74b)

גרסה 1.2.0-beta01

21 ביוני 2023

androidx.wear.tiles:tiles-*:1.2.0-beta01 משוחרר ללא שינויים. גרסה 1.2.0-beta01 כוללת את ההצהרות האלה.

גרסה 1.2.0-alpha07

7 ביוני 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha07 משוחרר. גרסה 1.2.0-alpha07 מכילה את ההצהרות האלה.

תכונות חדשות

  • TileRenderer.setState מאפשר להגדיר את המצב של סשן הרינדור. המצב הזה יחול על הפריסה הנוכחית ועל כל פריסה עתידית (עד להגדרת מצב חדש) (Iaaf35)
  • יש עכשיו תמיכה מלאה בסוגי protolayout בכל ממשקי ה-API של עיבוד משבצות. (I428b0)

תיקוני באגים

  • עכשיו אפשר להגדיר עיצוב מותאם אישית ב-ProtoLayoutViewInstance. (Iae8c0)

גרסה 1.2.0-alpha06

24 במאי 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha06 משוחרר. גרסה 1.2.0-alpha06 מכילה את ההצהרות האלה.

שינויים ב-API

  • משנים את השם של StateEntryValue ל-DynamicDataValue ומעדכנים את ממשקי ה-API של המצב כך שישתמשו ב-DynamicDataKey (If1c01)
  • אנחנו מגבילים את מספר הרשומות שמותר להוסיף ל-StateStore כדי להבטיח שהשימוש בזיכרון וזמן עדכון המצב יהיו מצומצמים ומבוקרים בכל מופע של StateStore. לכן, המפתח צריך לוודא שאין לו יותר מ-MAX_STATE_ENTRY_COUNT רשומות במפה, אחרת הוא יקבל הודעת IllegalStateException כשיוצר או מעדכן את StateStore. (Ibadb3)

גרסה 1.2.0-alpha05

10 במאי 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha05 משוחרר. גרסה 1.2.0-alpha05 מכילה את ההוספות האלה.

תכונות חדשות

  • הוספנו מזהה משבצת לבקשות ולאירועים של המשבצות. אפשר להשתמש במזהה הזה כדי לשייך נתונים מסוימים למופיע של משבצת בקרוסלה. (Ic4f83)

שינויים ב-API

  • הפונקציה TileRenderer.inflateAsync מחזירה עכשיו ListenableFuture. (I2f2b9)
  • רכיבי יצירת המשבצות שיש להם תחליף בספרייה protolayout מסומנים עכשיו כמיושנים. (Ie2029)

תיקוני באגים

  • ב-javadoc של TileService.onTileResourcesRequest מוסבר עכשיו מתי המערכת עשויה להפעיל את השיטה. (Iee037)

גרסה 1.2.0-alpha04

19 באפריל 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha04 משוחרר. גרסה 1.2.0-alpha04 מכילה את ההוספות האלה.

תיקוני באגים

  • יחסי התלות של Gradle מוגדרים עכשיו בצורה נכונה כ-api במקום כ-implementation, לפי הצורך. (I40503)

גרסה 1.2.0-alpha03

5 באפריל 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha03 משוחרר. גרסה 1.2.0-alpha03 כוללת את ההוספות האלה.

שינויים ב-API

  • הוספנו תמיכה בסוגי androidx.wear.protolayout ל-TileRenderer (I4ac7f)
  • השם של ObservableStateStore שונה ל-StateStore. (Ieb0e2)
  • הוספת עומסי יתר לסוגים של protolayout ל-TileRenderer (I4ac7f)
  • הפעלת אנימציות ב-TileRenderer (I07dcf)

גרסה 1.2.0-alpha02

22 במרץ 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha02 משוחרר. גרסה 1.2.0-alpha02 מכילה את ההוספות האלה.

שינויים ב-API

  • ספריית Material של Tiles הוצאה משימוש. יש להשתמש בספרייה החדשה ProtoLayout Material עם אותן פונקציות. (If242b)

תיקוני באגים

  • הקוד של TileRenderer עודכן כך שישתמש בתכונות חדשות מספריית protolayout. (I832f9)

גרסה 1.2.0-alpha01

8 במרץ 2023

androidx.wear.tiles:tiles-*:1.2.0-alpha01 משוחרר. גרסה 1.2.0-alpha01 כוללת את ההוספות האלה.

תכונות חדשות

  • הוספנו את onTileResourceRequest אל TileService כדי לספק משאבים מהספרייה protolayout. (983d9c5)
  • עדכנו את ResourcesRequest ואת TileRequest כך שיתמכו בסוגי State ו-DeviceParameters מהספרייה protolayout. (88fa01d)
  • עדכנו את TileBuilders.Tile כך שיתמוך בסוגי State ו-Timeline מהספרייה protolayout. (168619c)

תיקוני באגים

  • שיפורים ב-Javadocs. (I3ed73)
  • צבעי ברירת המחדל של onPrimary ושל פני השטח השתנו. (I0b039)

גרסה 1.1

גרסה 1.1.0

24 באוגוסט 2022

androidx.wear.tiles:tiles-*:1.1.0 משוחרר. גרסה 1.1.0 כוללת את השמירות האלה.

שינויים חשובים מאז גרסה 1.0.0

  • זוהי הגרסה היציבה הראשונה שמכילה את ספריית Tiles Material (מידע נוסף זמין בבלוג שלנו).
  • הספרייה הזו מכילה רכיבים ותצוגות שמתאימים להנחיות של Material Design ונוחים לשימוש. הרכיבים הכלולים הם Button, ‏ Chip, ‏ CompactChip, ‏ TitleChip, ‏ CircularProgressIndicator, ‏ Text.לכל הרכיבים האלה יש אובייקט צבעים משלהם שאפשר ליצור באמצעות הכיתה הראשית Colors כדי להחיל בקלות את אותו עיצוב על כל הרכיבים. בנוסף לצבעים, יש גם את המחלקה Typography שמאפשרת לקבל בקלות אובייקטים מסוג FontStyle באמצעות שם הגופן.
  • בנוסף לרכיבים, יש פריסות מומלצות של משבצות – PrimaryLayout, ‏ EdgeContentLayout, ‏ MultiButtonLayout, ‏ MultiSlotLayout. בכל הפריסות מופעלים סגנונות ומרווחי פנייה מומלצים בהתאם להנחיות של Material.
  • רשימה של הרכיבים והפריסות בספריית Material של Tiles מופיעה בנתוני הגרסה של Tiles.

גרסה 1.1.0-rc01

10 באוגוסט 2022

androidx.wear.tiles:tiles-*:1.1.0-rc01 משוחרר. גרסה 1.1.0-rc01 כוללת את השמירות האלה.

  • לא היו שינויים חדשים בין גרסת הבטא לבין גרסת ה-RC.

גרסה 1.1.0-beta01

27 ביולי 2022

androidx.wear.tiles:tiles-*:1.1.0-beta01 משוחרר. גרסה 1.1.0-beta01 כוללת את ההצהרות האלה.

הגרסה 1.0.0-beta01 של ספריית Material של Tiles מכילה רכיבים ופלטפורמות שתואמים להנחיות של Material וקלים ליצירה.

הרכיבים הכלולים הם:

  • Button – אובייקט עגול שניתן ללחוץ עליו, עם סמל, טקסט או תמונה ב-3 גדלים מוגדרים מראש.
  • Chip – אובייקט בצורת אצטדיון שניתן ללחוץ עליו, שיכול להכיל סמל, תוויות ראשיות ומשניות, ויש לו גובה קבוע ורחב שניתן להתאמה אישית.
  • CompactChip ו-TitleChip – שתי וריאציות של הצ'יפ הרגיל עם גובה קטן יותר וגובה גדול יותר, בהתאמה, שיכולות להכיל שורה אחת של טקסט.
  • CircularProgressIndicator – קשת צבעונית סביב קצה המסך עם זוויות ההתחלה והסיום שצוינו, שיכולה לתאר עיגול מלא או חלקי עם קשת ההתקדמות המלאה מאחוריה.
  • Text – טקסט בסגנון שמשתמש בסגנונות הטיפוגרפיה המומלצים של Wear Material

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

בנוסף לרכיבים, יש פריסות מומלצות של משבצות:

  • PrimaryLayout – פריסה שאפשר להתאים אישית על ידי הוספת תוויות ראשיות או משניות, תוכן באמצע ושבב ראשי בתחתית. אפשר להוסיף את התוכן הראשי בפריסה הזו כאובייקט MultiSlotLayout או MultiButtonLayout.
  • EdgeContentLayout – פריסה לאירוח CircularProgressIndicator מסביב לקצה, עם תוכן ראשי בפנים ותווית ראשית או משנית מסביב.
  • MultiButtonLayout – פריסה שיכולה להכיל 1 עד 7 לחצנים, שמסודרים בהתאם להנחיות של Material בהתאם למספר שלהם.
  • MultiSlotLayout – פריסה בסגנון שורה עם משבצות מרווחות ויישור אופקית (לסמלים או לתוכן קטן אחר).

בכל הפריסות מופעלים סגנונות ומרווחי פנייה מומלצים בהתאם להנחיות של Material.

שינויים ב-API

  • שינוי מבני משמעותי ברכיבי הצ'יפים, שכולל הפרדה של ה-setters ב-Builder כך שכל חלק מהתוכן יועבר בנפרד, עם שינוי השם בהתאם להנחיות (תווית ראשית, תווית משנית, מזהה משאב תמונה). בנוסף, אם לא תגדירו תיאור תוכן, הוא ייווצר באופן אוטומטי. (I57622)
  • השם של ProgressIndicatorLayout שונה ל-EdgeContentLayout. (Ic1aa6)
  • השמות של תוכן הגדלים של הלחצנים שונו לשמות עם הסיומת without _BUTTON, עם הבהרות נוספות ב-Javadocs ב-Button. (I1dfe2)

תיקוני באגים

  • השוליים, המרווחים הפנימיים והסידור הכללי בפריסות של Material Design עודכנו כך שיתאימו לכל סוגי הפריסות המומלצות ולגדלים ולצורות של המסכים.
  • שיפורים בפריסות של Material Design. מעכשיו, הרוחב של מודעות MultiSlotLayout גמיש יותר והן יתלבשו על התוכן במקום להיות בגודל קבוע.(I52919),(If18b4)
  • השטח שאפשר להקיש עליו ב-CompactChip הוגדל בהתאם להנחיות הנגישות. (Ie8264)

גרסה 1.1.0-alpha09

29 ביוני 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha09 משוחרר. גרסה 1.1.0-alpha09 מכילה את ההצהרות האלה.

תכונות חדשות

  • הוספנו תמיכה בהוספת תוויות אופציונליות ב-ProgressIndicatorLayout. (I30788)

שינויים ב-API

  • שיטות העזר של ElementMetadata מקבלות עכשיו ElementMetadata במקום 'Modifers'. (I5a70f)

תיקוני באגים

  • הוסרה המגבלה של 9 תווים על CompactChip. אם הטקסט גדול מדי ולא נכנס למסך ב-PrimaryLayout, הוא יקוצר בצורת אליפסה. (Id56ec)
  • למשתני ה-getter ב-Chip יש עכשיו סיומת Content. (Iba437)
  • הבהרה ב-Javadoc לגבי כל הכיתות של Tiles Material. (I56e41),‏ (I80f31),‏ (Iba437)

גרסה 1.1.0-alpha08

1 ביוני 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha08 משוחרר. גרסה 1.1.0-alpha08 מכילה את ההצהרות האלה.

תכונות חדשות

  • תג מטא-נתונים נוסף ל-Modifiers כדי לעקוב אחרי המטא-נתונים של הרכיב באמצעות שיטות עזר שנוספו לכיתה Helper. (I70db2),‏ (I30c3d)
  • השיטה הסטטית fromLayoutElement נוספה לכל הרכיבים והפריסות ב-Tiles Material. צריך להשתמש בו לצורך בדיקה, כדי להמיר את LayoutElement שהתקבל דרך הגישה לתוכן של מאגר לסוגו המקורי. (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)

גרסה 1.1.0-alpha07

18 במאי 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha07 משוחרר. גרסה 1.1.0-alpha07 מכילה את ההוספות האלה.

שינויים ב-API

  • הוספנו ל-ProgressIndicatorLayout ול-PrimaryLayout פונקציות Getter שקשורות לפונקציות setter שונות של תוכן. עכשיו לכל ה-setters בכיתות האלה יש getters תואמים.(Iddbe5) (Iabe4e)
  • פונקציית ה-getter של תיאור התוכן ב-Material Components יכולה להחזיר null כי פונקציית ה-setter שלה לא חובה.
  • ניסיון ליצור לחצן בלי להעביר תוכן יוביל ל-IllegalArgumentException. (I7fc0c)
  • השם של השדות שקשורים לצבע הסמל ב-ChipColors השתנה מ-iconTintColor ל-iconColor. (Ic053b)

תיקוני באגים

  • הוספנו את androidTests לפריסות בחומר של כרטיסי המידע. (I96404)

גרסה 1.1.0-alpha06

11 במאי 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha06 משוחרר. גרסה 1.1.0-alpha06 מכילה את ההוספות האלה.

תכונות חדשות

  • הפריסה החדשה נוספה לספריית המשנה MultiButtonLayout של פריסות Material. הוא מייצג פריסה שיכולה להכיל בין 1 ל-7 לחצנים שמסודרים בהתאם להנחיות של Material. ברוב המקרים, צריך להעביר את הפריסה הזו כתוכן אל PrimaryLayout. (Ib727f)

שינויים ב-API

  • MultiSlotLayout עובר עיבוד מחדש כך שיכלול רק משבצות. יש להעביר את הפריסה הזו כתוכן אל PrimaryLayout הראשי. (I1870f)
  • עודכנו צבעי ברירת המחדל שהוגדרו עבור CircularProgressIndicator לערך אחד במקום צבע ראשי וצבע משני. (I64a51)
  • נוספה פונקציית getter לרווח אופקי ב-MultiSlotLayout. (I11e1e)

תיקוני באגים

  • בדיקות Android לרכיבים נוספו ל-Tiles Material. (I20041)

גרסה 1.1.0-alpha05

6 באפריל 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha05 משוחרר. גרסה 1.1.0-alpha05 מכילה את ההצהרות האלה.

תכונות חדשות

  • הוספנו שיטות עזר להמרת LayoutElement ל-Layout, ל-Timeline ול-TimelineEntry לכיתות האלה, כדי שיהיה קל יותר ליצור משבצות. (I2f6d1)
  • האובייקט Colors נוסף לספריית Material כדי להעביר את הצבעים של הרכיבים כעיצוב. (I0792c)

שינויים ב-API

  • רכיב Material Text דורש טקסט שמוענק למבנה ה-constructor. עכשיו אפשר להתאים אישית את הרכיב הזה על ידי הגדרת משקל. (I25dbd)
  • הוסרו קבועים מ-ChipDefaults שלא משמשים את ה-setters הציבוריים. (I7baed)
  • הוסרו פונקציות getter מ-CompactChip ו-TitleChip שאין להן פונקציות setter תואמות. (I99e85)
  • DEFAULT_PADDING הוסר מהרשימה ProgressIndicatorDefaults. (Idabcd)
  • רכיבי Material מקבלים עכשיו את הערך CharSequence לתיאור התוכן במקום מחרוזת. (I5b21a)

תיקוני באגים

  • שינוי מבנה של הטמעת setters של פרמטרים אופציונליים ב-Button. (Ib7135)
  • הוספנו גרסאות של סגנונות גופן לגופנים בקטע 'טיפוגרפיה'. (I8dbc6)

גרסה 1.1.0-alpha04

23 במרץ 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha04 משוחרר. גרסה 1.1.0-alpha04 מכילה את ההוספות האלה.

תכונות חדשות

  • אפשר להוסיף תווית ראשית או משנית אופציונלית ל-PrimaryLayout. (Ib9916)
  • אפשר להתאים אישית את רכיב הטקסט על ידי הגדרת גלישת טקסט, טקסט נטוי, קו תחתון וכו' (I703f7)

שינויים ב-API

  • קבועי הצבע שמוגדרים כברירת מחדל הוסרו מ-Tiles Material API. (I0ab55)
  • כל הרכיבים שניתן ללחוץ עליהם ב-Tiles Material דורשים אובייקט Clickable ב-constructor של ה-Builder במקום Action. (I2f101)

תיקוני באגים

  • עכשיו יוצג קו נטוי (ellipsis) בטקסט שחורג מרכיב הצ'יפ והטקסט. (I8a2f8)
  • רכיבים נראים טוב יותר כשהגודל של הגופן של המשתמש מוגדר ל'גדול'. (Ib63b1)
  • הבהרה של Javadocs של setPrimaryChipContent ב-PrimaryLayout. (Ie6296)

גרסה 1.1.0-alpha03

23 בפברואר 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha03 משוחרר. גרסה 1.1.0-alpha03 כוללת את ההוספות האלה.

שינויים ב-API

  • הרכיב Text עם סגנונות הטיפוגרפיה המומלצים נוסף לחומר של TIles. (Iec0ae)

גרסה 1.1.0-alpha02

9 בפברואר 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha02 משוחרר. גרסה 1.1.0-alpha02 מכילה את ההוספות האלה.

תכונות חדשות

  • נוספה ספריית משנה חדשה layouts ב-Tiles Material. הוא מכיל פריסות מומלצות של משבצות עם שוליים וריפודים מומלצים, כדי לזרז את פיתוח המשבצות ולהקל על ההטמעה שלהן. הפריסות הראשוניות הן:
    • PrimaryLayout (I7ba91) שמייצג את הפריסה עם צ'יפ ראשי בתחתית והתוכן במרכז.
    • MultiSlotLayout (I32104) שמייצג פריסה עם תוויות בשורות 1 ו-3, משבצות עם רווחים וזווית ישרה בשורה 2, ואחריה שורה 4 שמכילה צ'יפ ראשי.
    • ProgressIndicatorLayout (I9fec6) שמייצג פריסה עם אינדיקטור התקדמות מעגלי בקצה המסך והתוכן הנתון בתוכו.
  • CircularProgressIndicator (Ic4b88) נוסף לרכיבי Material של כרטיסי המידע.

שינויים ב-API

  • השמות של שאר הקבועים שבהם נעשה שימוש ב-TitleChip שונו כך שיכללו את השם. (I14f4c)
  • השיטה setHorizontalAlignment נוספה ל-Chip. (Ie6e0b)

גרסה 1.1.0-alpha01

26 בינואר 2022

androidx.wear.tiles:tiles-*:1.1.0-alpha01 משוחרר. גרסה 1.1.0-alpha01 כוללת את ההוספות האלה.

תכונות חדשות

  • נוספה הספרייה החדשה Tiles Material. הוא מכיל רכיבים ליצירת פריסות של משבצות מהר יותר ובקלות רבה יותר באמצעות עיצוב Material. הרכיבים הראשוניים הם:
    • Button
    • Chip
    • CompactChip
    • TitleChip

תיקוני באגים

  • תיקון באג ב-TileUiClient שגרם לכך שמשאבים שנשמרו במטמון הושמדו. (I60e0b)

גירסה 1.0

גרסה 1.0.1

26 בינואר 2022

androidx.wear.tiles:tiles-*:1.0.1 משוחרר. גרסה 1.0.1 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

  • תיקון באג ב-TileUiClient שגרם לכך שמשאבים שנשמרו במטמון הושמדו. (I60e0b)

גרסה 1.0.0

3 בנובמבר 2021

androidx.wear.tiles:tiles-*:1.0.0 משוחרר. גרסה 1.0.0 כוללת את ההצהרות האלה.

תכונות עיקריות בגרסה 1.0.0

  • ספריית Wear Tiles מספקת פונקציונליות ליצירת משבצות מידע מותאמות אישית למכשירי Wear OS, יחד עם הכיתות שמאפשרות למערכת לאחזר את המשבצת ולהציג אותה לצד תצוגת השעון.
  • ה-tiles-renderer מאפשר להציג אריח כחלק מפעילות ב-Android, וכך מקל על בדיקה מהירה של פריסות האריחים.

גרסה 1.0.0-rc01

27 באוקטובר 2021

androidx.wear.tiles:tiles-*:1.0.0-rc01 משוחרר. גרסה 1.0.0-rc01 כוללת את ההוספות האלה.

גרסה 1.0.0-beta01

13 באוקטובר 2021

androidx.wear.tiles:tiles-*:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 כוללת את ההצהרות האלה.

תיקוני באגים

  • תוקנה הבעיה ב-NullPointerException ב-TileUiClient כשסופקה גרסה ריקה של המשאב. (I0586e)

גרסה 1.0.0-alpha12

29 בספטמבר 2021

androidx.wear.tiles:tiles-*:1.0.0-alpha12 משוחרר. גרסה 1.0.0-alpha12 מכילה את ההוספות האלה.

תיקוני באגים

  • UpdateScheduler כבר לא משתמש בהפניה חלשה, וכך מתוקנות בעיות שבהן TileUiClient לא מתעדכן(I1120d, ‏ b/199061124)

  • הוספת הצהרה על כך ש-SysUiTileUpdateRequester שולח שאילתות ל-PackageManager, תיקון באג שבו עדכוני המשבצות לא עבדו במכשירי R ואילך. (I1120d)

גרסה 1.0.0-alpha11

1 בספטמבר 2021

androidx.wear.tiles:tiles-*:1.0.0-alpha11 משוחרר. גרסה 1.0.0-alpha11 מכילה את ההצהרות האלה.

תכונות חדשות

  • הוספנו ופרסמנו ספריית בדיקה, androidx.wear.tiles:tiles-testing library, כדי לאפשר למפתחים לבדוק את המשבצות שלהם בקלות רבה יותר. (Iedb6b)

שינויים ב-API

  • השם של TileProviderService שונה ל-TileService. (I1ad2c)
  • ה-builders של המשבצות עודכנו. שיטות .builder() סטטיות הוצאו משימוש לטובת קריאה ל-new Foo.Builder(), והוסרו עומסי יתר של setters שקיבלו מופע של Builder. (Ia9606)
  • מעכשיו, TileRenderer צריך להשתמש בהקשר של ממשק המשתמש במקום בהקשר של האפליקציה. (I84b61)

תיקוני באגים

  • תוקן באג שגרם לשימוש בכמה קווים תחתונים במצבים מסוימים. (Ib6712)

גרסה 1.0.0-alpha10

18 באוגוסט 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha10, androidx.wear.tiles:tiles-proto:1.0.0-alpha10 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 משוחררות. גרסה 1.0.0-alpha10 מכילה את ההצהרות האלה.

שינויים ב-API

  • הסרת בודקי הפריסה מה-API הציבורי. הם תמיד יהיו מופעלים, אבל יוצגו אזהרות רק אם הבדיקה תיכשל. (Ie9f29)
  • ‏TileRenderer מקבל עכשיו הקשר של ממשק משתמש במקום הקשר של האפליקציה.

תיקוני באגים

  • תוקן באג שגרם לכך שלא ניתן היה ללחוץ על אלמנטים קליקביליים ב-Spannable.

גרסה 1.0.0-alpha09

21 ביולי 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha09, androidx.wear.tiles:tiles-proto:1.0.0-alpha09 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 משוחררות. גרסה 1.0.0-alpha09 מכילה את ההוספות האלה.

תכונות חדשות

  • הוספנו בודקי פריסה למעבד של Wear Tiles. (I3a869)
    • הם משמשים לאימות השיטות המומלצות בכרטיס. קודם כול, הן יגרמו להצגת אזהרה אם המשבצת לא מכילה רכיבים עם המשתנה Semantics.
  • נוספה תיעוד ל-DefaultTileProviderClient ול-TestingTileProviderClient constructors. (I9f4b9)

שינויים ב-API

  • שינוי שם ב-TileProviderClient‏ (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • הוספנו בודקי פריסה למעבד של Wear Tiles. (I3a869)

תיקוני באגים

  • מוודאים שליעד של LaunchAction אין הרשאות מיוחדות. (I39136)

גרסה 1.0.0-alpha08

30 ביוני 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha08, androidx.wear.tiles:tiles-proto:1.0.0-alpha08 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 משוחררות. גרסה 1.0.0-alpha08 מכילה את ההצהרות האלה.

תכונות חדשות

  • עכשיו יש תמיכה ב-line_height במקום ב-line_spacing ב-Spannables.

שינויים ב-API

  • הוספת תמיכה ב-line_height ב-Spannables, הסרת line_spacing. (Ibeb54)
    • קוד שמשתמש ב-line_spacing צריך לעבור להשתמש ב-line_height במקום זאת.

תיקוני באגים

  • תיקון באג בשימוש במאפיינים פרופורציוניים. (I37ace)
  • תיקון באג שגרם לכך שרכיבי טקסט לא יכללו תיאורי תוכן. (Id2c7d)

גרסה 1.0.0-alpha07

16 ביוני 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha07, androidx.wear.tiles:tiles-proto:1.0.0-alpha07 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 משוחררות. גרסה 1.0.0-alpha07 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

שינויים ב-API

  • מוסיפים את הממשק TileProviderClient ומציגים את DefaultTileProviderClient, כדי לאפשר להטמעות להתחבר לממשק TileProviderService. (I69165)

גרסה 1.0.0-alpha06

2 ביוני 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha06, androidx.wear.tiles:tiles-proto:1.0.0-alpha06 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 משוחררות. גרסה 1.0.0-alpha06 מכילה את ההוספות האלה.

שינויים ב-API

  • כל הכיתות של ה-Builder מכילות עכשיו פונקציות getter לכל המאפיינים. הערה: האפשרויות האלה מיועדות למטרות בדיקה בלבד (I9d155)
  • שינוי בחבילה: הכיתות ב-androidx.wear.tiles.builders הועברו ל-androidx.wear.tiles.
  • הוספת תמיכה ניסיונית בגוונים לאריחים. (I38929)
  • השם של LayoutElementBuilders.HALIGN_* השתנה ל-LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58)
  • השם של LayoutElementBuilders.VALIGN_* השתנה ל-LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58)
  • השם של LayoutElementBuilders.SPAN_VALIGN_* השתנה ל-LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58)
  • נוספו כיתות יצירת אב לבקשות ולאירועים. (Ib5cf4)
  • העברה של TileProviderService כך שישתמש בבקשות ובכיתות אירועים מ-RequestBuilders ומ-EventBuilders, במקום מ-RequestReaders/EventReaders (למשל, onTileRequest מספק עכשיו RequestBuilders.TileRequest במקום RequestReaders.TileRequest). (I46ea1)

תיקוני באגים

  • תיקון באג בטעינה אסינכררונית של תמונות במעבד התמונות של Tiles. (Iad9b0)
  • תוקן באג בפריסה כשמקפידים תמונה עם רוחב או גובה מוגדרים ל-expand() ב-Box עם רוחב או גובה מוגדרים ל-wrap(). (I33770)

גרסה 1.0.0-alpha05

18 במאי 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha05, androidx.wear.tiles:tiles-proto:1.0.0-alpha05 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 משוחררות. גרסה 1.0.0-alpha05 מכילה את ההוספות האלה.

שינויים ב-API

  • הוסרה הפונקציה getTileId מאירועי המשבצות הנכנסות (TileAddEvent,‏ TileRemoveEvent, ‏ TileEnterEvent, ‏ TileLeaveEvent, ‏ TileRequest). (Ifbba2)
  • שינית את השם של ImageResource#setAndroidResourceByResid ל-setAndroidResourceByResId (I4ba6e)
  • שינינו את השם של TimelineManager#deInit ל-close והטמענו את AutoCloseable. (I5dff2)

גרסה 1.0.0-alpha04

5 במאי 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha04, androidx.wear.tiles:tiles-proto:1.0.0-alpha04 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 משוחררות. גרסה 1.0.0-alpha04 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

שינויים ב-API

  • כיתות מוסתרות של TileProviderService.
    • הבקשה של TileUpdateRequester לקחה Class<? extends TileProviderService>. (Ib7cca)
  • הוספנו את האפשרות להוסיף פריטים נוספים ל-AndroidActivity. (I748f4)

Tiles גרסה 1.0.0-alpha03

21 באפריל 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha03, androidx.wear.tiles:tiles-proto:1.0.0-alpha03 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 משוחררות. גרסה 1.0.0-alpha03 כוללת את ההצהרות האלה.

שינויים ב-API

  • שינוי השם של TileManager -> TileClient
    • שינוי השם של TileManager#create -> TileClient#connect (I91839)

תיקוני באגים

  • הוספנו כללי Proguard כדי לוודא ש-tiles ו-tiles-renderer פועלים כמו שצריך כש-Proguard מופעל (Ie3d85)

גרסה 1.0.0-alpha02

7 באפריל 2021

התכונות androidx.wear.tiles:tiles:1.0.0-alpha02, androidx.wear.tiles:tiles-proto:1.0.0-alpha02 וגם androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 משוחררות. גרסה 1.0.0-alpha02 מכילה את ההצהרות האלה.

שינויים ב-API

  • androidx.wear:wear-tiles העביר קבוצות, ועכשיו צריך להתייחס אליו בתור androidx.wear.tiles:tiles
  • androidx.wear:wear-tiles-renderer העביר קבוצות, ועכשיו צריך להתייחס אליו בתור androidx.wear.tiles:tiles-renderer
  • עכשיו TileRenderer.LoadActionListener צורך מופע של androidx.wear.tiles.builders.StateBuilders.State במקום androidx.wear.tiles.proto.StateProto.State.
  • עכשיו אפשר להשתמש ב-TileRenderer כדי לקבל משאבי משבצות מ-androidx.wear.tiles.builders.ResourceBuilders.Resources, במקום ממכונה של androidx.wear.tiles.renderer.ResourceAccessors.

תיקוני באגים

  • תוקנה חוסר היכולת להשתמש ב-LoadActionListener, כי הוא חשף כיתה פנימית.

גרסה 1.0.0-alpha01

10 במרץ 2021

התכונות androidx.wear:wear-tiles:1.0.0-alpha01, androidx.wear:wear-tiles-proto:1.0.0-alpha01 וגם androidx.wear:wear-tiles-renderer:1.0.0-alpha01 משוחררות. גרסה 1.0.0-alpha01 מכילה את ההצהרות האלה.

תכונות חדשות

  • הספרייה Wear Tiles Renderer מספקת פונקציונליות ליצירת כרטיסי מידע מותאמים אישית למכשירי Wear OS, יחד עם הכיתות שמאפשרות למערכת לאחזר את כרטיס המידע ולהציג אותו לצד תצוגת השעון.