text-vertical

  
TODO
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
23 de setembro de 2026 - - 1.0.0-beta02 -

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-beta02"
}

Kotlin

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

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.

Text-Vertical

Versão 1.0

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 são direcionadas ao 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

  • O 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 texto no lado oposto. (Ic9bfd, b/559972132)
  • Correção da escala da marca de ênfase no layout de texto horizontal. A altura de linha reservada não pressupõe mais uma marca não dimensionada. (I6d7fe, b/562254557).
  • Correção do backport para avanços de texto vertical. O backport ignorou o deslocamento solicitado em níveis da API inferiores a 34. (I8877a, b/495457561)
  • Correção do texto ruby horizontal que reservava muito espaço vertical em níveis de API abaixo de 28, o que poderia deixar uma linha mais alta do que o necessário. (Iceb60, b/561323466).
  • Os testes para ruby vertical e orientação de texto agora são executados em todos os níveis de 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 tempo de execução do ciclo de vida agrupado sejam executadas com o AGP versão 9.5.0-alpha04 ou mais recente. (I7264b, b/556807521).
  • Correção do problema em que RubySpan.position era ignorado no layout de texto horizontal. O AnnotationPosition.After agora renderiza corretamente o texto ruby abaixo do texto base. (Iaffa1, b/559972124, b/561323466)
  • O RubySpan.position não será mais ignorado no layout de texto vertical. AnnotationPosition.After agora renderiza corretamente o texto ruby no lado esquerdo do texto base. (I0be1c, b/495457561)
  • Atualização das dependências do Compose para 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 estes commits.

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)
  • Removemos a documentação incorreta de requisito mínimo da API 36 de VerticalText. (I4f8e9, b/549288799)
  • Usamos a proporção de ascensão calculada para o deslocamento vertical da linha de base no modo de backport (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 estes commits.

Mudanças importantes

  • Esta versão marca a versão Alfa final planejada da biblioteca.
  • Finalização e refinamento dos parâmetros no elemento combinável VerticalText

Mudanças na API

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

Correções de bugs

  • Esclarecemos a documentação sobre o comportamento de substituição de VerticalTextLayout em níveis de API mais antigos. (Ia7ccc, b/449184326)

Não há notas de versão para este artefato.

Texto vertical: versão 1.0

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

  • Foram adicionadas 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 melhorar a clareza e a 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

  • Refatoramos todas as classes públicas para oferecer APIs Kotlin mais convenientes e idiomáticas para uso geral, mantendo uma forte interoperabilidade com Java.

Mudanças na API

  • Adição de um construtor padrão de zero argumentos a FontShearSpan para compatibilidade com Java (I73065, b/493692287).
  • A implementação de Parcelable em RubySpan e EmphasisSpan foi removida (I49884, b/493693386).
  • O EmphasisSpan foi refatorado para melhorar a compatibilidade (I34c40, b/493693310).
  • Refatoração de AnnotationPosition para melhorar a superfície da API (I10dce, b/493693386).
  • Convertemos TextOrientation em uma classe de enumeração, refatoramos AnnotationPosition em uma classe selada e removemos RubySpan.Builder (Ib4a77, b/493693386).
  • Adição da enumeração AnnotationPosition e refatoração da classe RubySpan (Ibfcff, b/493692426).
  • Refatoração de TextOrientation para uso geral e melhoria das extensões internas de escalonamento 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

  • O VerticalTextLayout agora oferece suporte ao layout horizontal para mostrar extensões especiais em japonês, como Ruby e ênfase (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

  • Foi introduzido um fallback gradual na API < 36.(I8a67a, b/442608654)
  • Fazer downgrade do minSDK para 23 para uso 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, aproveitando a nova flag VERTICAL_TEXT_FLAG adicionada no Android 16.
  • Adição de VerticalTextLayout que mostrava 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).
  • Adicionamos EmphasisRun para marcas de ênfase. (fe12d9).