text-vertical

  
待办事项
最近更新时间 稳定版 候选版 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")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

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）

bug 修复

  • EmphasisSpan.position 现在可移动强调标记。 AnnotationPosition.Before 将标记放在横向文本上方和纵向文本右侧。AnnotationPosition.After 会将其放置在另一侧。 （Ic9bfd、b/559972132）
  • 修复了横向文本布局中的强调标记缩放问题。预留的行高不再假定为未缩放的标记。（I6d7fe、b/562254557）
  • 修复了垂直文本前进的向后移植。在 API 级别低于 34 的情况下，向后移植忽略了所请求的偏移量。（I8877a、b/495457561）
  • 在低于 28 的 API 级别上，固定水平 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 现在可以正确呈现基本文字下方的 Ruby 文字。（Iaffa1、b/559972124、b/561323466）
  • 修复了在竖排文字布局中忽略 RubySpan.position 的问题。AnnotationPosition.After 现在可以正确呈现基本文字左侧的 Ruby 文字。（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 变更

bug 修复

  • 更新了 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）

bug 修复

  • 明确了旧版 API 级别上的 VerticalTextLayout 回退行为的文档。（Ia7ccc、b/449184326）

此工件没有版本说明。

文字竖排版本 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)
  • 向 VerticalTextLayout 类添加了 lineCount 属性。（I93884、b/502088091）

bug 修复

版本 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 Surface（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 现在支持横向布局，以显示日语中的特殊 span，例如 Ruby 和 Emphasis (Boten)。

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，可显示具有正确换行符的竖排文字、混合方向（例如，竖排文字中的横排拉丁字符）和 Ruby 文字。(8b3a10)
  • 为竖排文字中类似斜体的样式添加了 FontShearSpan。(1ffd78)
  • 添加了 EmphasisRun 以表示强调标记。(fe12d9)