text-vertical

  
TODO
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2026 年 9 月 23 日 - - 1.0.0-beta02 -

宣告依附元件

如要為 Text 新增依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

Text-Vertical

1.0 版本

1.0.0-beta02 版

2026 年 9 月 23 日

發布 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 進行編譯。使用這些 API 的應用程式必須針對 SDK 37 進行編譯，並使用 AGP 9.1.0 以上版本。(I0f757、b/562182206)

修正錯誤

  • EmphasisSpan.position 現在會移動強調標記。 AnnotationPosition.Before 會將標記放在水平文字上方，以及直向文字右側。AnnotationPosition.After 放在另一側。(Ic9bfd、b/559972132)
  • 修正橫向文字版面配置中的強調標記比例。保留的行高不再假設為未縮放的標記。(I6d7fe、b/562254557)
  • 修正垂直文字前進的向後移植問題。回溯移植作業會忽略 API 級別低於 34 的要求位移。(I8877a、b/495457561)
  • 修正 API 級別低於 28 時，水平 Ruby 文字保留過多垂直空間的問題，這可能會導致行高超出必要高度。(Iceb60、b/561323466)
  • 直向 Ruby 和文字方向的測試現在會在所有支援的 API 級別執行。(If07d4、b/495457561)
  • androidx.lifecycle:lifecycle-runtime 依附元件已更新至 2.10.0 版。如要使用 AGP 9.5.0-alpha04 以上版本執行隨附的生命週期執行階段 Lint 檢查，就必須使用這個版本。(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 版

2026 年 8 月 26 日

發布 androidx.text:text-vertical:1.0.0-beta01 和 androidx.text:text-vertical-compose:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。

API 變更

修正錯誤

  • 更新了 combineUpright 的說明文件。(Ib534b、b/548992014)
  • 從 VerticalText 移除不正確的 API 36 最低需求文件。(I4f8e9、b/549288799)
  • 在回溯模式中，使用計算出的升幅比率做為垂直基準線偏移量 (07339d7、b/502088091)

1.0.0-alpha06 版本

2026 年 7 月 29 日

發布 androidx.text:text-vertical:1.0.0-alpha06 和 androidx.text:text-vertical-compose:1.0.0-alpha06。1.0.0-alpha06 版包含這些修訂項目。

重要變更

  • 這是程式庫預計推出的最後一個 Alpha 版。
  • 完成並調整 VerticalText 可組合函式中的參數

API 變更

  • 導入 VerticalTextStyle，用於直書文字版面配置。(I647a8、b/512424512)
  • 在 text-vertical-compose 程式庫中導入新的公開 DSL (VerticalTextScope 和 buildVerticalText) (I6faa7、b/502088091)
  • 導入 VerticalText 可組合項 (I96509、b/502088091)

修正錯誤

  • 釐清舊版 API 級別的 VerticalTextLayout 備援行為說明文件。(Ia7ccc、b/449184326)

這個構件沒有任何版本資訊。

Text Vertical 1.0 版

1.0.0-alpha05 版本

2026 年 4 月 22 日

發布 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 版本

2026 年 4 月 8 日

發布 androidx.text:text-vertical:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。

新功能

  • 重構所有公開類別，為一般用途提供更方便、符合 Kotlin 習慣的 API，同時維持強大的 Java 互通性。

API 變更

  • 為 FontShearSpan 新增預設的零引數建構函式，以確保 Java 相容性 (I73065、b/493692287)。
  • 移除了 RubySpan 和 EmphasisSpan 中的 Parcelable 實作項目 (I49884、b/493693386)。
  • 重構 EmphasisSpan，提升相容性 (I34c40、b/493693310)。
  • 重構 AnnotationPosition，改善 API 介面 (I10dce、b/493693386)。
  • 將 TextOrientation 轉換為列舉類別，將 AnnotationPosition 重構為密封類別，並移除 RubySpan.Builder (Ib4a77、b/493693386)。
  • 新增 AnnotationPosition 列舉，並重構 RubySpan 類別 (Ibfcff、b/493692426)。
  • 為一般用途重構 TextOrientation，並改善內部文字縮放擴充功能 (I82152、b/493692428)。

1.0.0-alpha03 版本

2026 年 3 月 25 日

發布 androidx.text:text-vertical:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

新功能

  • VerticalTextLayout 現在支援橫向版面配置，可顯示日文的特殊跨度，例如 Ruby 和強調 (傍點)。

API 變更

1.0.0-alpha02 版

2025 年 10 月 8 日

發布 androidx.text:text-vertical:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。

新功能

  • 新增 VerticalTextLayout#isVerticalTextLayoutSupported() 方法，用於檢查直向文字功能 (Ie2802、b/442608654)

API 變更

1.0.0-alpha01 版

2025 年 8 月 27 日

發布 androidx.text:text-vertical:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。

新功能

  • 新的直向文字程式庫，主要用於支援日文的直向文字版面配置，並運用 Android 16 中新增的 VERTICAL_TEXT_FLAG 旗標。
  • 新增 VerticalTextLayout，可顯示直向文字 (含正確的換行符號)、混合方向 (例如直向行中的橫向拉丁字元) 和附註標音。(8b3a10)
  • 在直向文字中新增了 FontShearSpan，可設定類似斜體的樣式。(1ffd78)
  • 新增了用於強調標記的 EmphasisRun。(fe12d9)