text-vertical

声明依赖项

如需添加 Text 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库 。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

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

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

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

反馈

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

创建新问题

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

此工件没有版本说明。

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)
• 向 VerticalTextLayout 类添加了 lineCount 属性。(I93884、b/502088091)

bug 修复

• 更新了 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)。
• 移除了 Parcelable 实现，位于 RubySpan 和 EmphasisSpan (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 变更

• RubySpan 和 EmphasisSpan 现在继承了 ReplacementSpan，以支持横向文本 (I38db6、b/447239659、b/447224892)

版本 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 变更

• 在 API < 36 中引入了优雅的回退。(I8a67a、b/442608654)
• 将 minSDK 降级为 23，以便在其他 AndroidX 库中使用 (I2d6b5、b/442608654)

版本 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)