text-vertical

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

종속 항목 선언

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

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

Groovy

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

Kotlin

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

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

의견

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

새로운 문제 제출하기

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

텍스트-세로

버전 1.0

버전 1.0.0-beta03

2026년 10월 21일

androidx.text:text-vertical:1.0.0-beta03 및 androidx.text:text-vertical-compose:1.0.0-beta03이 출시되었습니다. 버전 1.0.0-beta03에 포함된 커밋을 확인하세요.

참고: 이 버전은 마지막 베타 버전입니다.

새로운 기능

  • VerticalTextSampleActivity에 '자막 큐' 탭을 추가하여 래핑된 높이, toVerticalTextStyle(), RubySpan, EmphasisSpan, 다테추요코, FontShearSpan, UnderlineSpan, StrikethroughSpan를 사용한 렌더링을 비롯한 VerticalText 기능을 보여줍니다. I4799d1 b/571750156

버그 수정

  • Noto Sans JP와 같이 상단 및 하단 패딩이 큰 글꼴을 사용할 때 가로 RubySpan 및 EmphasisSpan 줄 높이를 수정했습니다. (Ib0507, b/557316470) - 누메로님, 신고해 주셔서 감사합니다.
  • Compose 종속 항목을 1.12.1로 업데이트했습니다. (I9ee7f, b/569780191)
  • VerticalText는 이제 AnnotatedString 스팬 스타일을 적용하고 시맨틱스에서 AnnotatedString 스팬과 주석을 보존합니다. (Ib077f, b/502088091)
  • 가로 레이아웃에서 RubySpan 및 EmphasisSpan가 TextPaint.bgColor 또는 BackgroundColorSpan의 배경 색상을 채우지 않는 문제를 수정했습니다. (I66ba8, b/561269843)
  • 스팬이 Paint.Style.STROKE를 설정한 후 윤곽선으로 그려진 세로 텍스트의 배경 색상을 수정했습니다. (I692ed, b/566429122)
  • 이제 VerticalTextLayout에서 전체 RubySpan 범위를 포괄하는 CharacterStyle 스팬이 루비 텍스트에도 적용되며 RubySpan.textScale는 설정된 글꼴 크기를 조정합니다. 이제 배경 색상이 루비 텍스트와 기본 텍스트 중 더 짧은 텍스트의 위와 아래에 있는 빈 공간도 채웁니다. (I0dadc, b/564268825)
  • 세로 텍스트에 여러 스타일 실행이 있는 경우 VerticalTextLayout 배경 높이를 수정했습니다. (I7e31a, b/565211671)
  • VerticalTextStyle.background가 Color.Unspecified로 변경될 때 VerticalText가 오래된 배경 색상을 유지하는 문제를 수정했습니다. (Ia0861, b/565211671)
  • 호출자 페인트를 복사할 때 가로 루비 및 강조 레이아웃이 TextPaint 필드를 건너뛰는 문제를 수정했습니다. (Ia3043, b/561269843)
  • 이제 VerticalText는 RubySpan의 일반 String 텍스트 뒤와 일반 String 루비 주석 뒤에 있는 VerticalTextStyle.background에서 배경 색상을 가져옵니다. (If0493, b/564268825)
  • 초기화 후 공유 작업 페인트의 크기가 조정된 상태로 유지되는 가로 루비 레이아웃을 수정했습니다. (I33760, b/561269843)
  • 팬 동작으로 텍스트를 뷰 밖으로 이동할 수 없도록 세로 텍스트 샘플 앱을 수정했습니다. (If0108, b/563461635)
  • 강조 표시 위치를 보여주는 테스트 앱을 수정했습니다. (I3ffa3, b/559972132)
  • LineLayout, TextUtils, CanvasCompat, PaintCompat에 관한 Kex 기호 실행 브랜치 테스트를 추가했습니다. I47edf b/569212211

버전 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)