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 23 tháng 9 năm 2026 - - 1.0.0-beta02 -

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-beta02"
}

Kotlin

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

Để 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.

Text-Vertical

Phiên bản 1.0

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.

Các 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 tích cực!
  • Giờ đây, các thư việ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 dựa trên SDK 37. Những ứng dụng sử dụng các 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. 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 nó ở phía đối diện. (Ic9bfd, b/559972132)
  • Đã khắc phục tỷ lệ dấu nhấn trong bố cục văn bản ngang. Chiều cao dòng được dành riêng không còn giả định một dấu chưa được chia tỷ lệ nữa. (I6d7fe, b/562254557)
  • Đã sửa lỗi chuyển ngược cho các bước tiến của văn bản dọc. Hoạt động chuyển ngược bỏ qua độ lệch được yêu cầu trên các cấp độ API nhỏ hơn 34. (I8877a, b/495457561)
  • Đã khắc phục văn bản ruby ngang cố định chiếm quá nhiều khoảng trống theo chiều dọc trên các cấp độ API dưới 28, điều này có thể khiến một dòng cao hơn mức cần thiết. (Iceb60, b/561323466)
  • Các 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 2.10.0. Bạn cần có phiên bản này để các quy trình kiểm tra lint thời gian chạy theo gói có thể chạy 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)
  • Đã khắc phục lỗi RubySpan.position bị bỏ qua 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 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)
  • Xoá tài liệu yêu cầu tối thiểu không chính xác về API 36 khỏi VerticalText. (I4f8e9, b/549288799)
  • Sử dụng tỷ lệ tăng được tính toán cho độ lệch đường cơ sở dọc ở chế độ truyền ngược (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.

Các 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 tất và tinh chỉnh các tham số trong thành phần kết hợp VerticalText

Thay đổi về API

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

Sửa lỗi

  • Làm rõ tài liệu về hành vi dự phòng VerticalTextLayout ở 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 có khả năng kết hợp để 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

  • Giới thiệu 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 đặc trưng, thuận tiện 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 một hàm khởi tạo không có đối số mặc định vào FontShearSpan để tương thích với Java (I73065, b/493692287).
  • Xoá 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 khu vực 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 chia 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 khoảng đặc biệt bằng tiếng Nhật, chẳng hạn như Ruby và Emphasis (Boten).

Thay đổi về API

  • RubySpan và EmphasisSpan hiện kế thừa ReplacementSpan để hỗ trợ các thành phần này cho văn bản ngang (I38db6, b/447239659, b/447224892)

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

  • Giới thiệu một cơ chế 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 dành 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 có dấu ngắt dòng thích hợp, hướng kết hợp (ví dụ: các ký tự Latinh ngang trong một dòng dọc) và văn bản ruby. (8b3a10)
  • Đã thêm FontShearSpan cho kiểu chữ giống như in nghiêng trong văn bản dọc. (1ffd78)
  • Thêm EmphasisRun cho dấu nhấn. (fe12d9)