text-vertical

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:

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

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

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-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 casi 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 in base all'SDK 37. Le app che li utilizzano devono essere compilate in base all'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 sposta sul lato opposto. (Ic9bfd, b/559972132)
• È stata corretta la scala del segno di enfasi nel layout di testo orizzontale. L'altezza della riga riservata non presuppone più un segno non scalato. (I6d7fe, b/562254557)
• È stato corretto il backport per gli avanzamenti del testo verticale. Il backport ha ignorato l'offset richiesto nei livelli API inferiori a 34. (I8877a, b/495457561)
• Testo ruby orizzontale fisso che riserva troppo spazio verticale nei livelli API inferiori a 28, il che potrebbe lasciare una riga più alta del necessario. (Iceb60, b/561323466)
• I test per il testo 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 l'esecuzione dei controlli lint del runtime del ciclo di vita in bundle con AGP versione 9.5.0-alpha04 o successive. (I7264b, b/556807521)
• È stato corretto il problema relativo all'ignoranza di RubySpan.position nel layout di testo orizzontale. AnnotationPosition.After ora esegue il rendering corretto del testo ruby sotto il testo di base. (Iaffa1, b/559972124, b/561323466)
• È stato corretto il problema relativo all'ignoramento di RubySpan.position nel layout di testo verticale. AnnotationPosition.After ora esegue correttamente il rendering del testo ruby sul lato sinistro del testo di base. (I0be1c, b/495457561)
• Aggiorna le 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 è stata modificata 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 salita 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 rappresenta l'ultima versione alpha pianificata della libreria.
• Finalizzato e perfezionato i parametri nel componibile VerticalText

Modifiche alle API

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

Correzioni di bug

• È stata chiarita la documentazione relativa al comportamento di riserva di VerticalTextLayout nei livelli API precedenti. (Ia7ccc, b/449184326)

Non sono disponibili note di rilascio per questo artefatto.

Text Vertical versione 1.0

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 di 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

• Aggiornamento della documentazione KDoc per maggiore chiarezza e precisione. (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à

• È stato eseguito il refactoring di tutte le classi pubbliche per fornire API Kotlin più pratiche e idiomatiche per l'utilizzo generale, mantenendo al contempo una forte interoperabilità 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 eseguito il refactoring di EmphasisSpan per una migliore compatibilità (I34c40, b/493693310).
• È stato eseguito il refactoring di AnnotationPosition per migliorare la superficie API (I10dce, b/493693386).
• È stato convertito TextOrientation in una classe enum, è stato eseguito il refactoring di AnnotationPosition in una classe sigillata ed è stato rimosso RubySpan.Builder (Ib4a77, b/493693386).
• È stata aggiunta l'enumerazione AnnotationPosition ed è stato eseguito il refactoring della classe RubySpan (Ibfcff, b/493692426).
• È stato eseguito il refactoring di TextOrientation per l'utilizzo generale e sono state migliorate le estensioni di ridimensionamento del testo interno (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 gli span speciali in giapponese come Ruby ed Enfasi (Boten).

Modifiche alle API

• RubySpan e EmphasisSpan ora ereditano ReplacementSpan per supportarli per il testo orizzontale (I38db6, b/447239659, b/447224892)

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 alla versione 23 da utilizzare 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 di testo verticale principalmente per il giapponese, sfruttando il nuovo flag VERTICAL_TEXT_FLAG aggiunto in Android 16.
• È stato aggiunto VerticalTextLayout che visualizzava testo verticale con interruzioni di riga corrette, 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)
• Aggiunta di EmphasisRun per i segni di enfasi. (fe12d9)