text-vertical

  
לביצוע
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫21 באוקטובר 2026 - - ‎1.0.0-beta03 -

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

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

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

מגניב

dependencies {
    implementation "androidx.text:text-vertical:1.0.0-beta03"
}

Kotlin

dependencies {
    implementation("androidx.text:text-vertical:1.0.0-beta03")
}

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

משוב

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

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

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

טקסט – אנכי

גירסה 1.0

גרסה ‎1.0.0-beta03

‫21 באוקטובר 2026

‫androidx.text:text-vertical:1.0.0-beta03 ו-androidx.text:text-vertical-compose:1.0.0-beta03 מופצים. גרסה ‎1.0.0-beta03 מכילה את השמירות האלה.

הערה: זו אמורה להיות גרסת הבטא האחרונה.

תכונות חדשות

  • הוספנו את הכרטיסייה "Subtitle Cue" (אות כתוביות) ל-VerticalTextSampleActivity כדי להדגים את היכולות של VerticalText, כולל עיבוד עם גובה גלישה, toVerticalTextStyle(), RubySpan, EmphasisSpan, ‏Tate-chu-yoko, ‏FontShearSpan, ‏UnderlineSpan ו-StrikethroughSpan. I4799d1 b/571750156

תיקוני באגים

  • תוקן גובה השורה האופקי של RubySpan ו-EmphasisSpan כשמשתמשים בגופנים עם מרווח פנימי גדול למעלה ולמטה, כמו Noto Sans JP. ‫(Ib0507, b/557316470) – תודה על הדיווח, Numero-san!
  • עדכנו את יחסי התלות של Compose ל-1.12.1. (I9ee7f, b/569780191)
  • עכשיו VerticalText מחיל סגנונות של AnnotatedString טווחים ושומר על AnnotatedString טווחים והערות בסמנטיקה. (Ib077f, b/502088091)
  • תוקנה הבעיה שבה RubySpan ו-EmphasisSpan לא מילאו את צבע הרקע של TextPaint.bgColor או BackgroundColorSpan בפריסה אופקית. (I66ba8, b/561269843)
  • תוקנו צבעי הרקע בטקסט אנכי ששורטטו כקווי מתאר אחרי שהוגדר span Paint.Style.STROKE. (I692ed, b/566429122)
  • טווחים של CharacterStyle שמכסים טווח מלא של RubySpan ב-VerticalTextLayout חלים עכשיו גם על טקסט הרובי, ו-RubySpan.textScale משנה את גודל הגופנים שהם מגדירים. צבעי הרקע ממלאים עכשיו גם את החלל הריק מעל ומתחת לטקסט הקצר יותר מבין טקסט הרובי וטקסט הבסיס. (I0dadc, b/564268825)
  • תוקן גובה הרקע של VerticalTextLayout כשטקסט אנכי כולל כמה סגנונות. (I7e31a, b/565211671)
  • תוקנה בעיה שבה VerticalText שמר על צבע רקע ישן כש-VerticalTextStyle.background השתנה ל-Color.Unspecified. (Ia0861, b/565211671)
  • תוקן דילוג על פריסות אופקיות של רובי והדגשה בשדות TextPaint בזמן העתקת צבע המתקשר. (Ia3043, b/561269843)
  • עכשיו VerticalText שואב את צבע הרקע מ-VerticalTextStyle.background מאחורי טקסט String פשוט ומאחורי הערות רובי String פשוטות ב-RubySpan. (If0493, b/564268825)
  • תוקנה בעיה שבה פריסת רובי אופקית השאירה את ה-paint המשותף בקנה מידה שונה אחרי האתחול. (I33760, b/561269843)
  • תוקנה האפליקציה לדוגמה של טקסט אנכי, כך שתנועת הזזה לא יכולה להזיז את הטקסט אל מחוץ לתצוגה. (If0108, b/563461635)
  • תוקנה אפליקציית הבדיקה להדגמת המיקום של סימן ההדגשה (I3ffa3, ‏ b/559972132)
  • נוספו בדיקות של הסתעפויות הרצה סימבוליות של Kex ל-LineLayout,‏ TextUtils,‏ CanvasCompat ו-PaintCompat. I47edf b/569212211

גרסה ‎1.0.0-beta02

‫23 בספטמבר 2026

‫androidx.text:text-vertical:1.0.0-beta02 ו-androidx.text:text-vertical-compose:1.0.0-beta02 מופצים. גרסה ‎1.0.0-beta02 מכילה את השמירות האלה.

שינויים חשובים

  • הוספנו מקרי בדיקה כדי להבטיח תאימות לדורות קודמים עד API 24 (Android 7.0), והתוצאות היו חיוביות מאוד.
  • הספריות מטרגטות עכשיו את Kotlin 2.2 ודורשות את kotlinc 2.2‏ (I82396, ‏ b/498369605)
  • ספריות הטקסט האנכי עוברות עכשיו קומפילציה מול SDK 37. אפליקציות שמשתמשות בהם צריכות לעבור קומפילציה מול SDK 37 ולהשתמש ב-AGP 9.1.0 ואילך. (I0f757, b/562182206)

תיקוני באגים

  • עכשיו EmphasisSpan.position מזיז את סימן ההדגשה. הסימן AnnotationPosition.Before מופיע מעל טקסט אופקי ומימין לטקסט אנכי. ‫AnnotationPosition.After שם אותו בצד השני. ‫(Ic9bfd, ‏ b/559972132)
  • תוקן קנה המידה של סימן ההדגשה בפריסת טקסט אופקית. גובה השורה השמור לא מניח יותר שהסימן לא מותאם. (I6d7fe, ‏ b/562254557)
  • תוקן ההיסב בגרסאות מוקדמות יותר (backporting) של התקדמות הטקסט האנכי. ההיסב בגרסאות מוקדמות יותר התעלם מההיסט המבוקש ברמות API נמוכות מ-34. (I8877a, b/495457561)
  • תוקנה בעיה שבה טקסט רובי אופקי תפס יותר מדי מקום אנכי ברמות API נמוכות מ-28, מה שיכול היה לגרום לשורה להיות גבוהה מהנדרש. (Iceb60, b/561323466)
  • הבדיקות של רובי אנכי וכיוון טקסט פועלות עכשיו בכל רמות ה-API הנתמכות. (If07d4, b/495457561)
  • התלות androidx.lifecycle:lifecycle-runtime עודכנה לגרסה 2.10.0. הגרסה הזו נדרשת כדי להריץ בדיקות lint של זמן ריצה של מחזור חיים בחבילה עם AGP בגרסה 9.5.0-alpha04 ואילך. (I7264b, b/556807521)
  • תוקנה הבעיה שבה המערכת התעלמה מהתו RubySpan.position בפריסת טקסט אופקית. עכשיו AnnotationPosition.After מעבד בצורה נכונה טקסט רובי מתחת לטקסט הבסיס. (Iaffa1, b/559972124, b/561323466)
  • תוקנה הבעיה שבה המערכת התעלמה מהתג RubySpan.position בפריסת טקסט אנכית. עכשיו AnnotationPosition.After מעבד בצורה נכונה טקסט רובי בצד שמאל של טקסט הבסיס. (I0be1c, ‏ b/495457561)
  • שדרוג יחסי התלות של Compose לגרסה 1.11.4 (I9ef07, ‏ b/536925341)

גרסה 1.0.0-beta01

‫26 באוגוסט 2026

‫androidx.text:text-vertical:1.0.0-beta01 ו-androidx.text:text-vertical-compose:1.0.0-beta01 מופצים. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • השתנה VerticalTextScope מממשק למחלקה קונקרטית. (I44e71, ‏ b/549288808)

תיקוני באגים

  • המסמכים של combineUpright עודכנו. (Ib534b, ‏ b/548992014)
  • הסרנו מ-VerticalText את התיעוד השגוי לגבי הדרישה המינימלית של API 36. (I4f8e9, b/549288799)
  • שימוש ביחס העלייה המחושב לקיזוז קו הבסיס האנכי במצב היסב בגרסאות מוקדמות יותר (07339d7, ‏ b/502088091)

גרסה 1.0.0-alpha06

‫29 ביולי 2026

‫androidx.text:text-vertical:1.0.0-alpha06 ו-androidx.text:text-vertical-compose:1.0.0-alpha06 מופצים. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

שינויים חשובים

  • זו גרסת האלפא האחרונה של הספרייה.
  • סיימנו להגדיר את הפרמטרים ברכיב הקומפוזבילי VerticalText

שינויים ב-API

  • הוספנו את VerticalTextStyle לפריסת טקסט אנכית. (I647a8, b/512424512)
  • הוספנו DSL ציבורי חדש (VerticalTextScope ו-buildVerticalText) בספרייה text-vertical-compose (I6faa7, ‏ b/502088091)
  • הוספת פונקציה קומפוזבילית VerticalText (I96509, b/502088091)

תיקוני באגים

  • הבהרנו את התיעוד לגבי התנהגות החלופה של VerticalTextLayout ברמות API ישנות יותר. (Ia7ccc, b/449184326)

אין נתוני גרסה לארטיפקט הזה.

גרסה 1.0 של Text Vertical

גרסה ‎1.0.0-alpha05

‫22 באפריל 2026

‫androidx.text:text-vertical:1.0.0-alpha05 ו-androidx.text:text-vertical-compose:1.0.0-alpha05 מופצים. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו פונקציות קומפוזביליות שתומכות בפריסת טקסט אנכית, בהתאם ליוזמה של Google לתת עדיפות ל-Compose.

שינויים ב-API

  • הוספנו את פריט המידע של הספרייה :text:text-vertical-compose. (I939e4)
  • המאפיין lineCount נוסף למחלקה VerticalTextLayout. (I93884, b/502088091)

תיקוני באגים

  • עדכנו את התיעוד של KDoc כדי שיהיה ברור ומדויק יותר. (I71c8f, ‏ b/449184326)

גרסה ‎1.0.0-alpha04

‫8 באפריל 2026

‫androidx.text:text-vertical:1.0.0-alpha04 מופץ. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • כל המחלקות הציבוריות עברו refactoring כדי לספק ממשקי API נוחים ואידיומטיים יותר של Kotlin לשימוש כללי, תוך שמירה על יכולת פעולה הדדית חזקה עם Java.

שינויים ב-API

  • נוסף בנאי ברירת מחדל ללא ארגומנטים ל-FontShearSpan כדי לאפשר תאימות ל-Java‏ (I73065, ‏ b/493692287).
  • הוסרה ההטמעה של Parcelable ב-RubySpan וב-EmphasisSpan (I49884, ‏ b/493693386).
  • בוצע שכתוב של EmphasisSpan כדי לשפר את התאימות (I34c40, ‏ b/493693310).
  • בוצע refactoring של AnnotationPosition כדי לשפר את פני השטח של ה-API‏ (I10dce, ‏ b/493693386).
  • ההמרה של TextOrientation למחלקת enum, ה-refactoring של AnnotationPosition למחלקה אטומה וההסרה של RubySpan.Builder (Ib4a77,‏ b/493693386).
  • הוספנו את ה-enum‏ AnnotationPosition ושינינו את המבנה של המחלקה RubySpan (Ibfcff, ‏ b/493692426).
  • שינינו את המבנה של TextOrientation לשימוש כללי ושיפרנו את התוספים הפנימיים לשינוי גודל הטקסט (I82152, ‏ b/493692428).

גרסה 1.0.0-alpha03

‫25 במרץ 2026

‫androidx.text:text-vertical:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • עכשיו VerticalTextLayout תומך בפריסה אופקית, כדי להציג טקסטים מיוחדים ביפנית כמו Ruby ו-Emphasis (Boten).

שינויים ב-API

  • ‫RubySpan ו-EmphasisSpan יורשים עכשיו את ReplacementSpan כדי לתמוך בהם בטקסט אופקי (I38db6, ‏ b/447239659, ‏ b/447224892)

גרסה 1.0.0-alpha02

‫8 באוקטובר 2025

‫androidx.text:text-vertical:1.0.0-alpha02 מופץ. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו את השיטה VerticalTextLayout#isVerticalTextLayoutSupported() כדי לבדוק את היכולת של טקסט אנכי (Ie2802, ‏ b/442608654)

שינויים ב-API

  • הוספנו חלופה חלקה ב-API < 36.‏(I8a67a, ‏ b/442608654)
  • הורדת הגרסה של minSDK ל-23 כדי להשתמש בה בספריות אחרות של AndroidX‏ (I2d6b5, ‏ b/442608654)

גרסה 1.0.0-alpha01

‫27 באוגוסט 2025

‫androidx.text:text-vertical:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • ספריית טקסט אנכי חדשה לתמיכה בפריסת טקסט אנכי, בעיקר ביפנית, באמצעות הדגל החדש VERTICAL_TEXT_FLAG שנוסף ב-Android 16.
  • הוספנו את VerticalTextLayout, שמציג טקסט אנכי עם מעברי שורה מתאימים, כיוון מעורב (למשל, תווים לטיניים אופקיים בתוך שורה אנכית) וטקסט רובי. (8b3a10)
  • הוספנו את FontShearSpan לסגנון דמוי-נטוי בטקסט אנכי. (1ffd78)
  • נוסף EmphasisRun לסימני הדגשה. (fe12d9)