text-vertical

  
VIỆC CẦN LÀM
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 21 tháng 10 năm 2026 - - 1.0.0-beta03 -

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên Text, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

Groovy

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

Kotlin

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

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Trình theo dõi sự cố để biết thêm thông tin.

Văn bản dọc

Phiên bản 1.0

Phiên bản 1.0.0-beta03

Ngày 21 tháng 10 năm 2026

Phát hành androidx.text:text-vertical:1.0.0-beta03 và androidx.text:text-vertical-compose:1.0.0-beta03. Phiên bản 1.0.0-beta03 bao gồm các thay đổi sau.

Lưu ý: Đây là bản phát hành thử nghiệm cuối cùng.

Tính năng mới

  • Thêm thẻ "Subtitle Cue" (Gợi ý phụ đề) vào VerticalTextSampleActivity để minh hoạ các chức năng của VerticalText, bao gồm cả việc kết xuất với chiều cao được gói, toVerticalTextStyle(), RubySpan, EmphasisSpan, Tate-chu-yoko, FontShearSpan, UnderlineSpan và StrikethroughSpan. I4799d1 b/571750156

Sửa lỗi

  • Sửa chiều cao dòng RubySpan và EmphasisSpan theo chiều ngang khi sử dụng phông chữ có khoảng đệm trên và dưới lớn, chẳng hạn như Noto Sans JP. (Ib0507, b/557316470) – Cảm ơn Numero-san đã báo cáo!
  • Cập nhật các phần phụ thuộc của Compose lên 1.12.1. (I9ee7f, b/569780191)
  • VerticalText hiện áp dụng kiểu span AnnotatedString và giữ nguyên span cũng như chú thích AnnotatedString trong ngữ nghĩa. (Ib077f, b/502088091)
  • Sửa lỗi RubySpan và EmphasisSpan không lấp đầy màu nền của TextPaint.bgColor hoặc BackgroundColorSpan trong bố cục ngang. (I66ba8, b/561269843)
  • Khắc phục lỗi màu nền trong văn bản dọc được vẽ dưới dạng đường viền sau khi đặt dải ô Paint.Style.STROKE. (I692ed, b/566429122)
  • CharacterStyle span bao phủ toàn bộ dải ô RubySpan trong VerticalTextLayout hiện cũng áp dụng cho văn bản ruby và RubySpan.textScale điều chỉnh cỡ chữ mà các span này đặt. Màu nền giờ đây cũng lấp đầy khoảng trống phía trên và phía dưới văn bản ruby và văn bản cơ sở ngắn hơn. (I0dadc, b/564268825)
  • Đã sửa chiều cao nền VerticalTextLayout khi văn bản dọc có nhiều kiểu chạy. (I7e31a, b/565211671)
  • Sửa lỗi VerticalText giữ lại màu nền cũ khi VerticalTextStyle.background thay đổi thành Color.Unspecified. (Ia0861, b/565211671)
  • Sửa lỗi bố cục ruby và bố cục nhấn mạnh theo chiều ngang bỏ qua các trường TextPaint khi sao chép nét vẽ của phương thức gọi. (Ia3043, b/561269843)
  • VerticalText hiện lấy màu nền từ VerticalTextStyle.background phía sau văn bản thuần tuý String và phía sau chú thích ruby thuần tuý String trong RubySpan. (If0493, b/564268825)
  • Khắc phục lỗi bố cục ruby ngang khiến vùng vẽ hoạt động chung bị điều chỉnh tỷ lệ sau khi khởi chạy. (I33760, b/561269843)
  • Sửa ứng dụng mẫu văn bản dọc để cử chỉ kéo không thể di chuyển văn bản ra khỏi khung hiển thị. (If0108, b/563461635)
  • Sửa ứng dụng thử nghiệm để minh hoạ vị trí dấu nhấn mạnh (I3ffa3, b/559972132)
  • Thêm các bài kiểm thử nhánh thực thi tượng trưng Kex cho LineLayout, TextUtils, CanvasCompat và PaintCompat. I47edf b/569212211

Phiên bản 1.0.0-beta02

Ngày 23 tháng 9 năm 2026

Phát hành androidx.text:text-vertical:1.0.0-beta02 và androidx.text:text-vertical-compose:1.0.0-beta02. Phiên bản 1.0.0-beta02 bao gồm các thay đổi sau.

Thay đổi quan trọng

  • Chúng tôi đã thêm các trường hợp kiểm thử để đảm bảo khả năng tương thích ngược xuống API 24 (Android 7.0) và kết quả rất khả quan!
  • Các thư viện hiện nhắm đến Kotlin 2.2 và yêu cầu kotlinc 2.2 (I82396, b/498369605)
  • Các thư viện văn bản dọc hiện biên dịch theo SDK 37. Các ứng dụng sử dụng những API này phải biên dịch dựa trên SDK 37 và sử dụng AGP 9.1.0 trở lên. (I0f757, b/562182206)

Sửa lỗi

  • EmphasisSpan.position hiện di chuyển dấu nhấn mạnh. AnnotationPosition.Before đặt dấu phía trên văn bản ngang và bên phải văn bản dọc. AnnotationPosition.After đặt thành phần đó ở phía đối diện. (Ic9bfd, b/559972132)
  • Khắc phục tỷ lệ dấu nhấn mạnh trong bố cục văn bản ngang. Chiều cao dòng dành riêng không còn giả định dấu không được điều chỉnh theo tỷ lệ. (I6d7fe, b/562254557)
  • Đã khắc phục lỗi chuyển đổi ngược cho các bước tiến văn bản dọc. Cổng sau bỏ qua độ lệch được yêu cầu trên các cấp độ API thấp hơn 34. (I8877a, b/495457561)
  • Sửa lỗi văn bản ruby ngang chiếm quá nhiều không gian dọc trên các cấp độ API dưới 28, có thể khiến một dòng cao hơn mức cần thiết. (Iceb60, b/561323466)
  • Các bài kiểm thử cho ruby dọc và hướng văn bản hiện chạy trên tất cả các cấp độ API được hỗ trợ. (If07d4, b/495457561)
  • Phần phụ thuộc androidx.lifecycle:lifecycle-runtime đã được cập nhật lên phiên bản 2.10.0. Bạn cần có phiên bản này để chạy các quy trình kiểm tra tìm lỗi mã nguồn trong thời gian chạy của vòng đời đi kèm với AGP phiên bản 9.5.0-alpha04 trở lên. (I7264b, b/556807521)
  • Khắc phục lỗi RubySpan.position bị bỏ qua trong bố cục văn bản ngang. AnnotationPosition.After hiện hiển thị chính xác văn bản ruby bên dưới văn bản cơ sở. (Iaffa1, b/559972124, b/561323466)
  • Sửa lỗi bỏ qua RubySpan.position trong bố cục văn bản dọc. AnnotationPosition.After hiện hiển thị chính xác văn bản ruby ở bên trái văn bản cơ sở. (I0be1c, b/495457561)
  • Nâng cấp các phần phụ thuộc của Compose lên phiên bản 1.11.4 (I9ef07, b/536925341)

Phiên bản 1.0.0-beta01

Ngày 26 tháng 8 năm 2026

Phát hành androidx.text:text-vertical:1.0.0-beta01 và androidx.text:text-vertical-compose:1.0.0-beta01. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.

Thay đổi về API

  • Thay đổi VerticalTextScope từ giao diện thành một lớp cụ thể. (I44e71, b/549288808)

Sửa lỗi

  • Cập nhật tài liệu cho combineUpright. (Ib534b, b/548992014)
  • Đã xóa tài liệu về yêu cầu tối thiểu không chính xác của API 36 khỏi VerticalText. (I4f8e9, b/549288799)
  • Sử dụng tỷ lệ tăng dần được tính toán cho độ lệch đường cơ sở dọc trong chế độ backport (07339d7, b/502088091)

Phiên bản 1.0.0-alpha06

Ngày 29 tháng 7 năm 2026

Phát hành androidx.text:text-vertical:1.0.0-alpha06 và androidx.text:text-vertical-compose:1.0.0-alpha06. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.

Thay đổi quan trọng

  • Bản phát hành này đánh dấu phiên bản alpha cuối cùng theo kế hoạch của thư viện.
  • Hoàn thiện và tinh chỉnh các tham số trong thành phần kết hợp VerticalText

Thay đổi về API

  • Ra mắt VerticalTextStyle cho bố cục văn bản dọc. (I647a8, b/512424512)
  • Ra mắt DSL công khai mới (VerticalTextScope và buildVerticalText) trong thư viện text-vertical-compose (I6faa7, b/502088091)
  • Ra mắt thành phần kết hợp VerticalText (I96509, b/502088091)

Sửa lỗi

  • Làm rõ tài liệu về hành vi dự phòng của VerticalTextLayout trên các cấp độ API cũ. (Ia7ccc, b/449184326)

Không có ghi chú phát hành cho cấu phần phần mềm này.

Text Vertical Phiên bản 1.0

Phiên bản 1.0.0-alpha05

Ngày 22 tháng 4 năm 2026

Phát hành androidx.text:text-vertical:1.0.0-alpha05 và androidx.text:text-vertical-compose:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm các hàm composable để hỗ trợ bố cục văn bản dọc, phù hợp với sáng kiến ưu tiên Compose của Google.

Thay đổi về API

  • Ra mắt cấu phần phần mềm thư viện :text:text-vertical-compose. (I939e4)
  • Thêm thuộc tính lineCount vào lớp VerticalTextLayout. (I93884, b/502088091)

Sửa lỗi

  • Cập nhật tài liệu KDoc để đảm bảo tính rõ ràng và chính xác. (I71c8f, b/449184326)

Phiên bản 1.0.0-alpha04

Ngày 8 tháng 4 năm 2026

Phát hành androidx.text:text-vertical:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Tính năng mới

  • Tái cấu trúc tất cả các lớp công khai để cung cấp các API Kotlin thuận tiện và đặc trưng hơn cho mục đích sử dụng chung, đồng thời duy trì khả năng tương tác mạnh mẽ với Java.

Thay đổi về API

  • Thêm hàm khởi tạo không có đối số mặc định vào FontShearSpan để đảm bảo khả năng tương thích với Java (I73065, b/493692287).
  • Đã xóa phương thức triển khai Parcelable trong RubySpan và EmphasisSpan (I49884, b/493693386).
  • Tái cấu trúc EmphasisSpan để có khả năng tương thích tốt hơn (I34c40, b/493693310).
  • Tái cấu trúc AnnotationPosition để cải thiện giao diện API (I10dce, b/493693386).
  • Chuyển đổi TextOrientation thành một lớp enum, tái cấu trúc AnnotationPosition thành một lớp kín và xoá RubySpan.Builder (Ib4a77, b/493693386).
  • Thêm enum AnnotationPosition và tái cấu trúc lớp RubySpan (Ibfcff, b/493692426).
  • Tái cấu trúc TextOrientation để sử dụng chung và cải thiện các tiện ích mở rộng điều chỉnh tỷ lệ văn bản nội bộ (I82152, b/493692428).

Phiên bản 1.0.0-alpha03

Ngày 25 tháng 3 năm 2026

Phát hành androidx.text:text-vertical:1.0.0-alpha03. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • VerticalTextLayout hiện hỗ trợ bố cục ngang để hiển thị các dải đặc biệt bằng tiếng Nhật, chẳng hạn như Ruby và Emphasis (Boten).

Thay đổi về API

Phiên bản 1.0.0-alpha02

Ngày 8 tháng 10 năm 2025

Phát hành androidx.text:text-vertical:1.0.0-alpha02. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm phương thức VerticalTextLayout#isVerticalTextLayoutSupported() để kiểm tra khả năng của văn bản dọc (Ie2802, b/442608654)

Thay đổi về API

  • Ra mắt tính năng dự phòng linh hoạt trong API < 36.(I8a67a, b/442608654)
  • Hạ cấp minSDK xuống 23 để dùng trong các thư viện AndroidX khác (I2d6b5, b/442608654)

Phiên bản 1.0.0-alpha01

Ngày 27 tháng 8 năm 2025

Phát hành androidx.text:text-vertical:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

  • Một thư viện văn bản dọc mới hỗ trợ bố cục văn bản dọc chủ yếu cho tiếng Nhật, bằng cách tận dụng cờ VERTICAL_TEXT_FLAG mới được thêm vào Android 16.
  • Thêm VerticalTextLayout để hiển thị văn bản dọc với dấu ngắt dòng thích hợp, hướng kết hợp (ví dụ: ký tự Latinh ngang trong dòng dọc) và văn bản ruby. (8b3a10)
  • Thêm FontShearSpan cho kiểu giống như in nghiêng trong văn bản dọc. (1ffd78)
  • Thêm EmphasisRun cho dấu nhấn mạnh. (fe12d9)