text-vertical

  
--
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
21 de outubro de 2026 - - 1.0.0-beta03 -

Declarar dependências

Para adicionar uma dependência ao Text, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

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

Kotlin

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

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0-beta03

21 de outubro de 2026

Lançamento de androidx.text:text-vertical:1.0.0-beta03 e androidx.text:text-vertical-compose:1.0.0-beta03. A versão 1.0.0-beta03 contém estes commits.

Observação: esta é a última versão Beta.

Novos recursos

  • Adicionamos uma guia "Subtitle Cue" ao VerticalTextSampleActivity para demonstrar os recursos do VerticalText, incluindo renderização com altura ajustada, toVerticalTextStyle(), RubySpan, EmphasisSpan, Tate-chu-yoko, FontShearSpan, UnderlineSpan e StrikethroughSpan. I4799d1 b/571750156

Correções de bugs

  • Correção da altura da linha horizontal RubySpan e EmphasisSpan ao usar fontes com padding grande na parte de cima e de baixo, como Noto Sans JP. (Ib0507, b/557316470) - Agradecemos o relatório, Numero-san!
  • As dependências do Compose foram atualizadas para 1.12.1. (I9ee7f, b/569780191).
  • VerticalText agora aplica estilos de span AnnotatedString e preserva spans e anotações AnnotatedString na semântica. (Ib077f, b/502088091).
  • Correção de RubySpan e EmphasisSpan que não preenchiam a cor de plano de fundo de TextPaint.bgColor ou BackgroundColorSpan no layout horizontal. (I66ba8, b/561269843).
  • Correção das cores de plano de fundo em texto vertical que eram desenhadas como contornos após um conjunto de span Paint.Style.STROKE. (I692ed, b/566429122).
  • Os períodos de CharacterStyle que cobrem um intervalo completo de RubySpan em VerticalTextLayout agora também se aplicam ao texto ruby, e RubySpan.textScale dimensiona os tamanhos de fonte definidos por eles. As cores de plano de fundo agora também preenchem o espaço vazio acima e abaixo do texto ruby e do texto base mais curtos. (I0dadc, b/564268825).
  • Correção da altura do plano de fundo de VerticalTextLayout quando o texto vertical tem várias execuções de estilo. (I7e31a, b/565211671)
  • Correção de VerticalText que mantinha uma cor de plano de fundo desatualizada quando VerticalTextStyle.background mudava para Color.Unspecified. (Ia0861, b/565211671).
  • Correção de layouts horizontais de ruby e ênfase que pulavam campos TextPaint ao copiar a pintura do autor da chamada. (Ia3043, b/561269843)
  • O VerticalText agora extrai a cor do plano de fundo de VerticalTextStyle.background atrás do texto simples String e atrás das anotações ruby simples String em RubySpan. (If0493, b/564268825).
  • Correção do layout horizontal de ruby que deixava a pintura de trabalho compartilhada dimensionada após a inicialização. (I33760, b/561269843).
  • Correção do app de exemplo de texto vertical para que um gesto de arrastar não possa mover o texto para fora da visualização. (If0108, b/563461635).
  • Correção do app de teste para demonstrar a posição da marca de ênfase (I3ffa3, b/559972132).
  • Adicionamos testes de ramificação de execução simbólica do Kex para LineLayout, TextUtils, CanvasCompat e PaintCompat. I47edf b/569212211

Versão 1.0.0-beta02

23 de setembro de 2026

Lançamento de androidx.text:text-vertical:1.0.0-beta02 e androidx.text:text-vertical-compose:1.0.0-beta02. A versão 1.0.0-beta02 contém estes commits.

Mudanças importantes

  • Adicionamos casos de teste para garantir a compatibilidade com versões anteriores até a API 24 (Android 7.0), e os resultados foram muito positivos.
  • As bibliotecas agora têm como destino o Kotlin 2.2 e exigem o kotlinc 2.2 (I82396, b/498369605).
  • As bibliotecas de texto vertical agora são compiladas com o SDK 37. Os apps que os usam precisam ser compilados com o SDK 37 e usar o AGP 9.1.0 ou mais recente. (I0f757, b/562182206).

Correções de bugs

  • EmphasisSpan.position agora move a marca de ênfase. AnnotationPosition.Before coloca a marca acima do texto horizontal e à direita do texto vertical. AnnotationPosition.After coloca o elemento no lado oposto. (Ic9bfd, b/559972132).
  • Correção da escala de marca de ênfase no layout de texto horizontal. A altura da linha reservada não assume mais uma marca sem escala. (I6d7fe, b/562254557).
  • Correção do backport para avanços de texto vertical. O backport ignorou o deslocamento solicitado em níveis da API anteriores ao 34. (I8877a, b/495457561).
  • Correção do texto ruby horizontal que reservava muito espaço vertical em níveis da API anteriores ao 28, o que poderia deixar uma linha mais alta do que o necessário. (Iceb60, b/561323466).
  • Os testes de ruby vertical e orientação de texto agora são executados em todos os níveis da API compatíveis. (If07d4, b/495457561).
  • A dependência androidx.lifecycle:lifecycle-runtime foi atualizada para 2.10.0. Essa versão é necessária para que as verificações de lint do ciclo de vida do pacote sejam executadas com a versão 9.5.0-alpha04 ou mais recente do AGP. (I7264b, b/556807521).
  • Correção de um problema em que RubySpan.position era ignorado no layout de texto horizontal. AnnotationPosition.After agora renderiza corretamente o texto ruby abaixo do texto de base. (Iaffa1, b/559972124, b/561323466)
  • Correção de um problema em que RubySpan.position era ignorado no layout de texto vertical. AnnotationPosition.After agora renderiza corretamente o texto ruby no lado esquerdo do texto base. (I0be1c, b/495457561).
  • As dependências do Compose foram atualizadas para a versão 1.11.4 (I9ef07, b/536925341).

Versão 1.0.0-beta01

26 de agosto de 2026

Lançamento de androidx.text:text-vertical:1.0.0-beta01 e androidx.text:text-vertical-compose:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

Mudanças na API

  • Mudança de VerticalTextScope de uma interface para uma classe concreta. (I44e71, b/549288808).

Correções de bugs

  • Atualização da documentação de combineUpright. (Ib534b, b/548992014).
  • A documentação incorreta do requisito mínimo da API 36 foi removida de VerticalText. (I4f8e9, b/549288799).
  • Foi usada a proporção de subida calculada para o deslocamento vertical da linha de base no modo de compatibilidade com versões anteriores (07339d7, b/502088091).

Versão 1.0.0-alpha06

29 de julho de 2026

Lançamento de androidx.text:text-vertical:1.0.0-alpha06 e androidx.text:text-vertical-compose:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estas confirmações.

Mudanças importantes

  • Esta versão marca a última versão Alfa planejada da biblioteca.
  • Finalizou e refinou os parâmetros no elemento combinável VerticalText.

Mudanças na API

  • Introdução de VerticalTextStyle para layout de texto vertical. (I647a8, b/512424512).
  • Introdução de uma nova DSL pública (VerticalTextScope e buildVerticalText) na biblioteca text-vertical-compose (I6faa7, b/502088091).
  • Introdução ao elemento combinável VerticalText (I96509, b/502088091).

Correções de bugs

  • Documentação esclarecida para o comportamento de fallback de VerticalTextLayout em níveis da API mais antigos. (Ia7ccc, b/449184326)

Versão 1.0.0-alpha05

22 abril de 2026

Lançamento de androidx.text:text-vertical:1.0.0-alpha05 e androidx.text:text-vertical-compose:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estes commits.

Novos recursos

  • Adicionamos funções combináveis para oferecer suporte ao layout de texto vertical, alinhando-se à iniciativa Compose-first do Google.

Mudanças na API

  • Introdução ao artefato da biblioteca :text:text-vertical-compose. (I939e4).
  • A propriedade lineCount foi adicionada à classe VerticalTextLayout. (I93884, b/502088091).

Correções de bugs

  • Atualizamos a documentação do KDoc para maior clareza e precisão. (I71c8f, b/449184326).

Versão 1.0.0-alpha04

8 de abril de 2026

Lançamento de androidx.text:text-vertical:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estes commits.

Novos recursos

  • Refatoração de todas as classes públicas para fornecer APIs Kotlin mais convenientes e idiomáticas para uso geral, mantendo uma forte interoperabilidade com o Java.

Mudanças na API

  • Adicionamos um construtor padrão de argumento zero a FontShearSpan para compatibilidade com Java (I73065, b/493692287).
  • A implementação de Parcelable em RubySpan e EmphasisSpan foi removida (I49884, b/493693386).
  • Refatoramos EmphasisSpan para melhorar a compatibilidade (I34c40, b/493693310).
  • Refatoração de AnnotationPosition para melhorar a superfície da API (I10dce, b/493693386).
  • TextOrientation foi convertido em uma classe de tipo enumerado, AnnotationPosition foi refatorado para uma classe selada e RubySpan.Builder foi removido (Ib4a77, b/493693386).
  • Adicionamos o tipo enumerado AnnotationPosition e refatoramos a classe RubySpan (Ibfcff, b/493692426).
  • Refatoramos o TextOrientation para uso geral e melhoramos as extensões internas de dimensionamento de texto (I82152, b/493692428).

Versão 1.0.0-alpha03

25 de março de 2026

Lançamento de androidx.text:text-vertical:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estes commits.

Novos recursos

  • VerticalTextLayout agora oferece suporte ao layout horizontal para exibir períodos especiais em japonês, como Ruby e Emphasis (Boten).

Mudanças na API

Versão 1.0.0-alpha02

8 de outubro de 2025

Lançamento de androidx.text:text-vertical:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estes commits.

Novos recursos

  • Adição do método VerticalTextLayout#isVerticalTextLayoutSupported() para verificar a capacidade de texto vertical (Ie2802, b/442608654).

Mudanças na API

  • Introdução de um substituto simples na API < 36 (I8a67a, b/442608654).
  • O minSDK foi rebaixado para 23 para ser usado em outras bibliotecas do AndroidX (I2d6b5, b/442608654).

Versão 1.0.0-alpha01

27 de agosto de 2025

Lançamento de androidx.text:text-vertical:1.0.0-alpha01. A versão 1.0.0-alpha01 inclui estes commits.

Novos recursos

  • Uma nova biblioteca de texto vertical para oferecer suporte ao layout de texto vertical, principalmente para japonês, usando a nova flag VERTICAL_TEXT_FLAG adicionada no Android 16.
  • Adicionamos VerticalTextLayout, que mostra texto vertical com quebras de linha adequadas, orientação mista (por exemplo, caracteres latinos horizontais em uma linha vertical) e texto ruby. (8b3a10).
  • Adição de FontShearSpan para estilo semelhante ao itálico em texto vertical. (1ffd78).
  • Adição de EmphasisRun para marcas de ênfase. (fe12d9).