text-vertical

Cómo declarar dependencias

Para agregar una dependencia en Text, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

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

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

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la herramienta Issue Tracker para obtener más información.

Text-Vertical

Versión 1.0

Versión 1.0.0-beta02

23 de septiembre de 2026

Lanzamiento de androidx.text:text-vertical:1.0.0-beta02 y androidx.text:text-vertical-compose:1.0.0-beta02. La versión 1.0.0-beta02 contiene estas confirmaciones.

Cambios importantes

• Agregamos casos de prueba para garantizar la compatibilidad con versiones anteriores hasta la API 24 (Android 7.0), y los resultados fueron muy positivos.
• Ahora, las bibliotecas se orientan a Kotlin 2.2 y requieren kotlinc 2.2 (I82396, b/498369605).
• Ahora las bibliotecas de texto vertical se compilan con el SDK 37. Las apps que los usan deben compilarse con el SDK 37 y usar AGP 9.1.0 o una versión posterior. (I0f757, b/562182206)

Correcciones de errores

• EmphasisSpan.position ahora mueve la marca de énfasis. AnnotationPosition.Before coloca la marca arriba del texto horizontal y a la derecha del texto vertical. AnnotationPosition.After la coloca en el lado opuesto. (Ic9bfd, b/559972132)
• Se corrigió la escala de la marca de énfasis en el diseño de texto horizontal. La altura de línea reservada ya no supone una marca sin escalar. (I6d7fe, b/562254557)
• Se corrigió la adaptación de versiones anteriores para los avances de texto vertical. La adaptación a versiones anteriores ignoró el desplazamiento solicitado en los niveles de API inferiores a 34. (I8877a, b/495457561)
• Se corrigió el texto ruby horizontal que reservaba demasiado espacio vertical en los niveles de API inferiores a 28, lo que podía dejar una línea más alta de lo necesario. (Iceb60, b/561323466)
• Las pruebas de Ruby vertical y orientación del texto ahora se ejecutan en todos los niveles de API admitidos. (If07d4, b/495457561)
• Se actualizó la dependencia de androidx.lifecycle:lifecycle-runtime a la versión 2.10.0. Esta versión es necesaria para que las verificaciones de lint del tiempo de ejecución del ciclo de vida incluidas se ejecuten con la versión 9.5.0-alpha04 o posterior de AGP. (I7264b, b/556807521)
• Se corrigió el problema por el que se ignoraba RubySpan.position en el diseño de texto horizontal. AnnotationPosition.After ahora renderiza correctamente el texto ruby debajo del texto base. (Iaffa1, b/559972124, b/561323466)
• Se corrigió el problema por el que se ignoraba RubySpan.position en el diseño de texto vertical. AnnotationPosition.After ahora renderiza correctamente el texto ruby en el lado izquierdo del texto base. (I0be1c, b/495457561)
• Se actualizaron las dependencias de Compose a la versión 1.11.4 (I9ef07, b/536925341).

Versión 1.0.0-beta01

26 de agosto de 2026

Lanzamiento de androidx.text:text-vertical:1.0.0-beta01 y androidx.text:text-vertical-compose:1.0.0-beta01. La versión 1.0.0-beta01 contiene estas confirmaciones.

Cambios en la API

• Se cambió VerticalTextScope de una interfaz a una clase concreta. (I44e71, b/549288808)

Correcciones de errores

• Se actualizó la documentación de combineUpright. (Ib534b, b/548992014)
• Se quitó la documentación incorrecta sobre el requisito mínimo de la API 36 de VerticalText. (I4f8e9, b/549288799)
• Se usó el ratio de ascenso calculado para la compensación de la línea de base vertical en el modo de portabilidad a versiones anteriores (07339d7, b/502088091).

Versión 1.0.0-alpha06

29 de julio de 2026

Lanzamiento de androidx.text:text-vertical:1.0.0-alpha06 y androidx.text:text-vertical-compose:1.0.0-alpha06. La versión 1.0.0-alpha06 contiene estas confirmaciones.

Cambios importantes

• Esta versión marca la versión alfa final planificada de la biblioteca.
• Se finalizaron y perfeccionaron los parámetros en el elemento VerticalText componible.

Cambios en la API

• Se introdujo VerticalTextStyle para el diseño de texto vertical. (I647a8, b/512424512)
• Se introdujo un nuevo DSL público (VerticalTextScope y buildVerticalText) en la biblioteca text-vertical-compose (I6faa7, b/502088091).
• Se introdujo el elemento VerticalText componible (I96509, b/502088091).

Correcciones de errores

• Se aclaró la documentación sobre el comportamiento de resguardo de VerticalTextLayout en niveles de API anteriores. (Ia7ccc, b/449184326)

No hay notas de la versión para este artefacto.

Versión 1.0 de Text Vertical

Versión 1.0.0-alpha05

22 de abril de 2026

Lanzamiento de androidx.text:text-vertical:1.0.0-alpha05 y androidx.text:text-vertical-compose:1.0.0-alpha05. La versión 1.0.0-alpha05 contiene estas confirmaciones.

Nuevas funciones

• Se agregaron funciones de componibilidad para admitir el diseño de texto vertical, lo que se alinea con la iniciativa de Google de priorizar Compose.

Cambios en la API

• Se introdujo el artefacto de la biblioteca :text:text-vertical-compose. (I939e4)
• Se agregó la propiedad lineCount a la clase VerticalTextLayout. (I93884, b/502088091)

Correcciones de errores

• Se actualizó la documentación de KDoc para mayor claridad y precisión. (I71c8f, b/449184326)

Versión 1.0.0-alpha04

8 de abril de 2026

Lanzamiento de androidx.text:text-vertical:1.0.0-alpha04. La versión 1.0.0-alpha04 contiene estas confirmaciones.

Nuevas funciones

• Se refactorizaron todas las clases públicas para proporcionar APIs de Kotlin idiomáticas y más convenientes para el uso general, a la vez que se mantiene una sólida interoperabilidad con Java.

Cambios en la API

• Se agregó un constructor predeterminado sin argumentos a FontShearSpan para la compatibilidad con Java (I73065, b/493692287).
• Se quitó la implementación de Parcelable en RubySpan y EmphasisSpan (I49884, b/493693386).
• Se refactorizó EmphasisSpan para mejorar la compatibilidad (I34c40, b/493693310).
• Se refactorizó AnnotationPosition para mejorar la superficie de la API (I10dce, b/493693386).
• Se convirtió TextOrientation en una clase de enumeración, se refactorizó AnnotationPosition en una clase sellada y se quitó RubySpan.Builder (Ib4a77, b/493693386).
• Se agregó la enumeración AnnotationPosition y se refactorizó la clase RubySpan (Ibfcff, b/493692426).
• Se refactorizó TextOrientation para uso general y se mejoraron las extensiones internas de ajuste de texto (I82152, b/493692428).

Versión 1.0.0-alpha03

25 de marzo de 2026

Lanzamiento de androidx.text:text-vertical:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Nuevas funciones

• VerticalTextLayout ahora admite el diseño horizontal para mostrar tramos especiales en japonés, como Ruby y Emphasis (Boten).

Cambios en la API

• RubySpan y EmphasisSpan ahora heredan ReplacementSpan para admitir texto horizontal (I38db6, b/447239659, b/447224892).

Versión 1.0.0-alpha02

8 de octubre de 2025

Lanzamiento de androidx.text:text-vertical:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

• Se agregó el método VerticalTextLayout#isVerticalTextLayoutSupported() para verificar la capacidad de texto vertical (Ie2802, b/442608654).

Cambios en la API

• Se introdujo una alternativa elegante en la API < 36 (I8a67a, b/442608654).
• Se disminuyó la versión de minSDK a 23 para que se pueda usar en otras bibliotecas de AndroidX (I2d6b5, b/442608654).

Versión 1.0.0-alpha01

27 de agosto de 2025

Lanzamiento de androidx.text:text-vertical:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

• Se agregó una nueva biblioteca de texto vertical para admitir el diseño de texto vertical, principalmente para japonés, aprovechando la nueva marca VERTICAL_TEXT_FLAG agregada en Android 16.
• Se agregó VerticalTextLayout que mostraba texto vertical con saltos de línea adecuados, orientación mixta (p.ej., caracteres latinos horizontales dentro de una línea vertical) y texto ruby. (8b3a10)
• Se agregó FontShearSpan para el estilo similar a la cursiva en el texto vertical. (1ffd78)
• Se agregó EmphasisRun para las marcas de énfasis. (fe12d9)