text-vertical

  
TODO
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2026년 9월 23일 - - 1.0.0-beta02 -

종속 항목 선언

Text의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

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

Kotlin

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

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

Text-Vertical

버전 1.0

버전 1.0.0-beta02

2026년 9월 23일

androidx.text:text-vertical:1.0.0-beta02 및 androidx.text:text-vertical-compose:1.0.0-beta02이 출시되었습니다. 버전 1.0.0-beta02에는 이러한 커밋이 포함되어 있습니다.

중요한 변경사항

  • API 24 (Android 7.0)까지 하위 호환성을 보장하기 위해 테스트 사례를 추가했으며 결과는 매우 긍정적이었습니다.
  • 이제 라이브러리가 Kotlin 2.2를 타겟팅하고 kotlinc 2.2가 필요합니다 (I82396, b/498369605).
  • 이제 세로 텍스트 라이브러리가 SDK 37에 대해 컴파일됩니다. 이러한 기능을 사용하는 앱은 SDK 37에 대해 컴파일하고 AGP 9.1.0 이상을 사용해야 합니다. (I0f757, b/562182206)

버그 수정

  • 이제 EmphasisSpan.position가 강조 표시를 이동합니다. AnnotationPosition.Before는 가로 텍스트 위, 세로 텍스트 오른쪽에 표시를 배치합니다. AnnotationPosition.After는 반대쪽에 배치합니다. (Ic9bfd, b/559972132)
  • 가로 텍스트 레이아웃에서 강조 표시 스케일을 수정했습니다. 예약된 줄 높이는 더 이상 확장되지 않은 표시를 가정하지 않습니다. (I6d7fe, b/562254557)
  • 세로 텍스트 전진 백포트 수정 백포트가 API 수준 34 미만에서 요청된 오프셋을 무시했습니다. (I8877a, b/495457561)
  • API 수준 28 미만에서 수직 공간을 너무 많이 예약하는 가로 루비 텍스트를 수정하여 필요 이상으로 줄이 길어질 수 있는 문제를 해결했습니다. (Iceb60, b/561323466)
  • 이제 세로 루비 및 텍스트 방향 테스트가 지원되는 모든 API 수준에서 실행됩니다. (If07d4, b/495457561)
  • androidx.lifecycle:lifecycle-runtime 종속 항목이 2.10.0으로 업데이트되었습니다. 이 버전은 번들 수명 주기 런타임 린트 검사가 AGP 버전 9.5.0-alpha04 이상에서 실행되는 데 필요합니다. (I7264b, b/556807521)
  • 가로 텍스트 레이아웃에서 RubySpan.position가 무시되는 문제 수정 이제 AnnotationPosition.After가 기본 텍스트 아래에 루비 텍스트를 올바르게 렌더링합니다. (Iaffa1, b/559972124, b/561323466)
  • 세로 텍스트 레이아웃에서 RubySpan.position가 무시되는 문제 수정 이제 AnnotationPosition.After가 기본 텍스트의 왼쪽에 루비 텍스트를 올바르게 렌더링합니다. (I0be1c, b/495457561)
  • Compose 종속 항목을 1.11.4로 업그레이드 (I9ef07, b/536925341)

버전 1.0.0-beta01

2026년 8월 26일

androidx.text:text-vertical:1.0.0-beta01 및 androidx.text:text-vertical-compose:1.0.0-beta01이 출시되었습니다. 버전 1.0.0-beta01에는 이 커밋이 포함되어 있습니다.

API 변경사항

  • VerticalTextScope를 인터페이스에서 구체적인 클래스로 변경했습니다. (I44e71, b/549288808)

버그 수정

  • combineUpright 관련 문서가 업데이트되었습니다. (Ib534b, b/548992014)
  • VerticalText에서 잘못된 API 36 최소 요구사항 문서를 삭제했습니다. (I4f8e9, b/549288799)
  • 백포트 모드에서 수직 기준선 오프셋에 계산된 어센트 비율 사용 (07339d7, b/502088091)

버전 1.0.0-alpha06

2026년 7월 29일

androidx.text:text-vertical:1.0.0-alpha06 및 androidx.text:text-vertical-compose:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에는 이러한 커밋이 포함되어 있습니다.

중요한 변경사항

  • 이 출시 버전은 라이브러리의 최종 계획된 알파 버전입니다.
  • VerticalText 컴포저블의 매개변수 최종 확정 및 개선

API 변경사항

  • 세로 텍스트 레이아웃을 위해 VerticalTextStyle를 도입했습니다. (I647a8, b/512424512)
  • text-vertical-compose 라이브러리에 새로운 공개 DSL (VerticalTextScope 및 buildVerticalText) 도입 (I6faa7, b/502088091)
  • VerticalText 컴포저블 도입 (I96509, b/502088091)

버그 수정

  • 이전 API 수준에서 VerticalTextLayout 대체 동작에 관한 문서가 명확해졌습니다. (Ia7ccc, b/449184326)

이 아티팩트의 출시 노트는 없습니다.

텍스트 세로 버전 1.0

버전 1.0.0-alpha05

2026년 4월 22일

androidx.text:text-vertical:1.0.0-alpha05 및 androidx.text:text-vertical-compose:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Google의 Compose 우선 이니셔티브에 따라 세로 텍스트 레이아웃을 지원하는 컴포저블 함수가 추가되었습니다.

API 변경사항

  • :text:text-vertical-compose 라이브러리 아티팩트를 도입했습니다. (I939e4)
  • VerticalTextLayout 클래스에 lineCount 속성이 추가되었습니다. (I93884, b/502088091)

버그 수정

  • 명확성과 정확성을 위해 KDoc 문서가 업데이트되었습니다. (I71c8f, b/449184326)

버전 1.0.0-alpha04

2026년 4월 8일

androidx.text:text-vertical:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 강력한 Java 상호 운용성을 유지하면서 일반적인 용도로 더 편리하고 직관적인 Kotlin API를 제공하도록 모든 공개 클래스를 리팩터링했습니다.

API 변경사항

  • Java 호환성을 위해 FontShearSpan에 기본 0 인수 생성자를 추가했습니다 (I73065, b/493692287).
  • RubySpan 및 EmphasisSpan에서 Parcelable 구현을 삭제했습니다 (I49884, b/493693386).
  • 호환성 향상을 위해 EmphasisSpan 리팩터링 (I34c40, b/493693310)
  • API 노출 영역을 개선하기 위해 AnnotationPosition 리팩터링 (I10dce, b/493693386)
  • TextOrientation를 enum 클래스로 변환하고, AnnotationPosition를 봉인 클래스로 리팩터링하고, RubySpan.Builder를 삭제했습니다 (Ib4a77, b/493693386).
  • AnnotationPosition enum을 추가하고 RubySpan 클래스를 리팩터링했습니다 (Ibfcff, b/493692426).
  • 일반적인 사용을 위해 TextOrientation를 리팩터링하고 내부 텍스트 크기 조절 확장 프로그램을 개선했습니다 (I82152, b/493692428).

버전 1.0.0-alpha03

2026년 3월 25일

androidx.text:text-vertical:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • VerticalTextLayout는 이제 일본어의 루비 및 강조 (보텐)와 같은 특수 스팬을 표시하기 위해 가로 레이아웃을 지원합니다.

API 변경사항

  • 이제 RubySpan 및 EmphasisSpan가 가로 텍스트를 지원하기 위해 ReplacementSpan을 상속합니다. (I38db6, b/447239659, b/447224892)

버전 1.0.0-alpha02

2025년 10월 8일

androidx.text:text-vertical:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 세로 텍스트 기능을 확인하는 VerticalTextLayout#isVerticalTextLayoutSupported() 메서드를 추가했습니다. (Ie2802, b/442608654)

API 변경사항

  • API 36 미만에서 그레이스풀 폴백 도입(I8a67a, b/442608654)
  • 다른 AndroidX 라이브러리에서 사용할 수 있도록 minSDK을 23으로 다운그레이드 (I2d6b5, b/442608654)

버전 1.0.0-alpha01

2025년 8월 27일

androidx.text:text-vertical:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Android 16에 추가된 새로운 VERTICAL_TEXT_FLAG 플래그를 활용하여 주로 일본어의 세로 텍스트 레이아웃을 지원하는 새로운 세로 텍스트 라이브러리
  • 적절한 줄바꿈, 혼합 방향 (예: 세로 줄 내의 가로 라틴 문자), 루비 텍스트로 세로 텍스트를 표시하는 VerticalTextLayout가 추가되었습니다. (8b3a10)
  • 세로 텍스트의 기울임꼴 스타일을 위한 FontShearSpan가 추가되었습니다. (1ffd78)
  • 강조 표시를 위한 EmphasisRun가 추가되었습니다. (fe12d9)