text-vertical

  
TODO
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
21 ottobre 2026 - - 1.0.0-beta03 -

Dichiara le dipendenze

Per aggiungere una dipendenza da Text, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

Alla moda

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

Kotlin

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

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Testo verticale

Versione 1.0

Versione 1.0.0-beta03

21 ottobre 2026

androidx.text:text-vertical:1.0.0-beta03 e androidx.text:text-vertical-compose:1.0.0-beta03 sono state rilasciate. La versione 1.0.0-beta03 contiene questi commit.

Nota: questa è l'ultima versione beta.

Nuove funzionalità

  • È stata aggiunta una scheda "Cue dei sottotitoli" a VerticalTextSampleActivity per mostrare le funzionalità di VerticalText, tra cui il rendering con altezza con ritorno a capo, toVerticalTextStyle(), RubySpan, EmphasisSpan, Tate-chu-yoko, FontShearSpan, UnderlineSpan e StrikethroughSpan. I4799d1 b/571750156

Correzioni di bug

  • Risolto il problema relativo all'altezza della linea orizzontale RubySpan e EmphasisSpan quando si utilizzano caratteri con spaziatura interna superiore e inferiore di grandi dimensioni, come Noto Sans JP. (Ib0507, b/557316470) - Grazie per la segnalazione, Numero-san!
  • Le dipendenze di Compose sono state aggiornate alla versione 1.12.1. (I9ee7f, b/569780191)
  • VerticalText ora applica gli stili degli span AnnotatedString e conserva gli span e le annotazioni AnnotatedString nella semantica. (Ib077f, b/502088091)
  • Risolto il problema per cui RubySpan e EmphasisSpan non riempivano il colore di sfondo di TextPaint.bgColor o BackgroundColorSpan nel layout orizzontale. (I66ba8, b/561269843)
  • Risolto il problema dei colori di sfondo nel testo verticale che venivano disegnati come contorni dopo un set di intervalli Paint.Style.STROKE. (I692ed, b/566429122)
  • Gli intervalli CharacterStyle che coprono un intervallo RubySpan completo in VerticalTextLayout ora si applicano anche al testo ruby e RubySpan.textScale scala le dimensioni dei caratteri impostate. I colori di sfondo ora riempiono anche lo spazio vuoto sopra e sotto il testo ruby e il testo di base più corti. (I0dadc, b/564268825)
  • È stata corretta l'altezza dello sfondo VerticalTextLayout quando il testo verticale ha più sequenze di stile. (I7e31a, b/565211671)
  • Risolto il problema per cui VerticalText manteneva un colore di sfondo obsoleto quando VerticalTextStyle.background cambiava in Color.Unspecified. (Ia0861, b/565211671)
  • Risolto il problema relativo ai layout ruby e di enfasi orizzontali che saltavano i campi TextPaint durante la copia del paint del chiamante. (Ia3043, b/561269843)
  • VerticalText ora estrae il colore di sfondo da VerticalTextStyle.background dietro il testo normale String e dietro le annotazioni ruby normali String in RubySpan. (If0493, b/564268825)
  • È stato corretto il layout ruby orizzontale che lasciava l'area di disegno di lavoro condivisa scalata dopo l'inizializzazione. (I33760, b/561269843)
  • È stata corretta l'app di esempio per il testo verticale in modo che un gesto di panoramica non possa spostare il testo fuori dalla visualizzazione. (If0108, b/563461635)
  • È stata corretta l'app di test per mostrare la posizione del segno di enfasi (I3ffa3, b/559972132)
  • Sono stati aggiunti test dei rami di esecuzione simbolica Kex per LineLayout, TextUtils, CanvasCompat e PaintCompat. I47edf b/569212211

Versione 1.0.0-beta02

23 settembre 2026

androidx.text:text-vertical:1.0.0-beta02 e androidx.text:text-vertical-compose:1.0.0-beta02 sono state rilasciate. La versione 1.0.0-beta02 contiene questi commit.

Modifiche importanti

  • Abbiamo aggiunto scenari di test per garantire la compatibilità con le versioni precedenti fino all'API 24 (Android 7.0) e i risultati sono stati molto positivi.
  • Le librerie ora hanno come target Kotlin 2.2 e richiedono kotlinc 2.2 (I82396, b/498369605)
  • Le librerie di testo verticale ora vengono compilate con l'SDK 37. Le app che li utilizzano devono essere compilate con l'SDK 37 e utilizzare AGP 9.1.0 o versioni successive. (I0f757, b/562182206)

Correzioni di bug

  • EmphasisSpan.position ora sposta il segno di enfasi. AnnotationPosition.Before posiziona il segno sopra il testo orizzontale e a destra del testo verticale. AnnotationPosition.After lo posiziona sul lato opposto. (Ic9bfd, b/559972132)
  • È stata corretta la scala dei segni di enfasi nel layout del testo orizzontale. L'altezza della riga riservata non presuppone più un segno non scalato. (I6d7fe, b/562254557)
  • Risolto il problema relativo al backport per l'avanzamento del testo verticale. Il backport ha ignorato l'offset richiesto sui livelli API inferiori a 34. (I8877a, b/495457561)
  • Risolto il problema per cui il testo ruby orizzontale fisso riservava troppo spazio verticale sui livelli API precedenti alla versione 28, il che poteva lasciare una riga più alta del necessario. (Iceb60, b/561323466)
  • I test per il ruby verticale e l'orientamento del testo ora vengono eseguiti su tutti i livelli API supportati. (If07d4, b/495457561)
  • La dipendenza androidx.lifecycle:lifecycle-runtime è stata aggiornata alla versione 2.10.0. Questa versione è necessaria per eseguire i controlli lint del runtime del ciclo di vita in bundle con AGP versione 9.5.0-alpha04 o successive. (I7264b, b/556807521)
  • Risolto il problema per cui RubySpan.position veniva ignorato nel layout del testo orizzontale. AnnotationPosition.After ora visualizza correttamente il testo ruby sotto il testo di base. (Iaffa1, b/559972124, b/561323466)
  • Risolto il problema per cui RubySpan.position veniva ignorato nel layout del testo verticale. AnnotationPosition.After ora esegue correttamente il rendering del testo ruby sul lato sinistro del testo di base. (I0be1c, b/495457561)
  • È stato eseguito l'upgrade delle dipendenze di Compose alla versione 1.11.4. (I9ef07, b/536925341)

Versione 1.0.0-beta01

26 agosto 2026

androidx.text:text-vertical:1.0.0-beta01 e androidx.text:text-vertical-compose:1.0.0-beta01 sono state rilasciate. La versione 1.0.0-beta01 contiene questi commit.

Modifiche alle API

  • VerticalTextScope è stato modificato da un'interfaccia a una classe concreta. (I44e71, b/549288808)

Correzioni di bug

  • Documentazione aggiornata per combineUpright. (Ib534b, b/548992014)
  • È stata rimossa la documentazione errata relativa al requisito minimo dell'API 36 da VerticalText. (I4f8e9, b/549288799)
  • È stato utilizzato il rapporto di ascesa calcolato per l'offset della linea di base verticale in modalità di backport (07339d7, b/502088091)

Versione 1.0.0-alpha06

29 luglio 2026

androidx.text:text-vertical:1.0.0-alpha06 e androidx.text:text-vertical-compose:1.0.0-alpha06 sono state rilasciate. La versione 1.0.0-alpha06 contiene questi commit.

Modifiche importanti

  • Questa release segna l'ultima versione alpha pianificata della libreria.
  • Finalizzato e perfezionato i parametri nel componibile VerticalText

Modifiche alle API

  • Introdotto VerticalTextStyle per il layout del testo verticale. (I647a8, b/512424512)
  • È stato introdotto un nuovo DSL pubblico (VerticalTextScope e buildVerticalText) nella libreria text-vertical-compose (I6faa7, b/502088091)
  • È stato introdotto il componibile VerticalText (I96509, b/502088091)

Correzioni di bug

  • Documentazione più chiara per il comportamento di riserva di VerticalTextLayout sui livelli API precedenti. (Ia7ccc, b/449184326)

Non sono presenti note di rilascio per questo artefatto.

Versione 1.0 verticale di testo

Versione 1.0.0-alpha05

22 aprile 2026

androidx.text:text-vertical:1.0.0-alpha05 e androidx.text:text-vertical-compose:1.0.0-alpha05 sono state rilasciate. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Sono state aggiunte funzioni componibili per supportare il layout del testo verticale, in linea con l'iniziativa Compose-first di Google.

Modifiche alle API

  • È stato introdotto l'artefatto della libreria :text:text-vertical-compose. (I939e4)
  • È stata aggiunta la proprietà lineCount alla classe VerticalTextLayout. (I93884, b/502088091)

Correzioni di bug

  • Documentazione KDoc aggiornata per maggiore chiarezza e accuratezza. (I71c8f, b/449184326)

Versione 1.0.0-alpha04

8 aprile 2026

androidx.text:text-vertical:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Rifattorizzate tutte le classi pubbliche per fornire API Kotlin idiomatiche più pratiche per l'utilizzo generale, mantenendo al contempo una forte interoperabilità con Java.

Modifiche alle API

  • È stato aggiunto un costruttore predefinito senza argomenti a FontShearSpan per la compatibilità con Java (I73065, b/493692287).
  • È stata rimossa l'implementazione di Parcelable in RubySpan e EmphasisSpan (I49884, b/493693386).
  • È stato rifattorizzato EmphasisSpan per una migliore compatibilità (I34c40, b/493693310).
  • Rifattorizzato AnnotationPosition per migliorare la superficie dell'API (I10dce, b/493693386).
  • TextOrientation è stato convertito in una classe enum, AnnotationPosition è stato rifattorizzato in una classe sealed e RubySpan.Builder è stato rimosso (Ib4a77, b/493693386).
  • È stato aggiunto l'enum AnnotationPosition ed è stata rifattorizzata la classe RubySpan (Ibfcff, b/493692426).
  • Rifattorizzato TextOrientation per l'utilizzo generale e migliorate le estensioni interne di ridimensionamento del testo (I82152, b/493692428).

Versione 1.0.0-alpha03

25 marzo 2026

androidx.text:text-vertical:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

  • VerticalTextLayout ora supporta il layout orizzontale per visualizzare intervalli speciali in giapponese, come Ruby ed Emphasis (Boten).

Modifiche alle API

Versione 1.0.0-alpha02

8 ottobre 2025

androidx.text:text-vertical:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto il metodo VerticalTextLayout#isVerticalTextLayoutSupported() per verificare la funzionalità del testo verticale (Ie2802, b/442608654)

Modifiche alle API

  • È stato introdotto un fallback controllato nell'API < 36.(I8a67a, b/442608654)
  • Esegui il downgrade di minSDK a 23 per l'utilizzo in altre librerie AndroidX (I2d6b5, b/442608654)

Versione 1.0.0-alpha01

27 agosto 2025

androidx.text:text-vertical:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Una nuova libreria di testo verticale per supportare il layout del testo verticale, principalmente per il giapponese, sfruttando il nuovo flag VERTICAL_TEXT_FLAG aggiunto in Android 16.
  • Aggiunta di VerticalTextLayout che mostrava testo verticale con interruzioni di riga appropriate, orientamento misto (ad es. caratteri latini orizzontali all'interno di una riga verticale) e testo ruby. (8b3a10)
  • Aggiunta di FontShearSpan per lo stile simile al corsivo nel testo verticale. (1ffd78)
  • Aggiunto EmphasisRun per i segni di enfasi. (fe12d9)