tv

  
Cung cấp cho nhà phát triển các chức năng Compose và Material Design để viết ứng dụng cho TV
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 8 tháng 2 năm 2023 - - - 1.0.0-alpha04

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

Để thêm các phần phụ thuộc trên tv-foundation và tv-material, 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.tv:tv-foundation:1.0.0-alpha04"
    implementation "androidx.tv:tv-material:1.0.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.tv:tv-foundation:1.0.0-alpha04")
    implementation("androidx.tv:tv-material:1.0.0-alpha04")
}

Để 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ề Công cụ theo dõi lỗi để biết thêm thông tin.

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

Phiên bản 1.0.0

Phiên bản 1.0.0-alpha04

Ngày 8 tháng 2 năm 2023

Phát hành androidx.tv:tv-foundation:1.0.0-alpha04 và androidx.tv:tv-material: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

  • Trong các hàng, cột và lưới tải từng phần, pivot sẽ bị ghi đè (nếu cần) để đảm bảo toàn bộ mục được đưa vào khung hiển thị. (11d7e40)
  • Thêm chế độ tuỳ chỉnh màu thẻ ở các trạng thái khác nhau. (21b2925)
  • Băng chuyền hiện chấp nhận ảnh động tuỳ chỉnh để cuộn tiến và lùi theo cách thủ công. (431494a)

Các thay đổi về API

  • Đổi tên androidx.tv.material thành androidx.tv.material3 và làm phẳng cấu trúc gói trong androidx.tv.material3. (I6ca52)
  • Chỉ báo trong hàng Chỉ báo băng chuyền hiện là một vùng có thể được nhà phát triển tuỳ chỉnh. (268af2a)
  • Đổi tên focusableItem thành immersiveListItem. Người dùng sẽ phải thêm đối tượng sửa đổi focusable() hoặc clickable() theo cách thủ công cùng với immersiveListItem (5dd5078)(b/263061052)
  • Đổi tên timeToDisplayMillis thành autoScrollDurationMillis trong thành phần của Băng chuyền. (431494a)
  • CarouselItem đang bị hạn chế sử dụng trong Carousel. (431494a)
  • Băng chuyền hiện chấp nhận ContentTransforms làm định nghĩa ảnh động thay vì EnterTransition và ExitTransitions. (431494a)
  • Giới thiệu API PinnableContainer được phân phát theo danh sách tải từng phần thông qua một thành phần cục bộ cho phép ghim mục hiện tại. (Ib8881, b/259274257, b/195049010)
  • Thêm thuộc tính mainAxisItemSpacing vào TvLazyListLayoutInfo và TvLazyGridLayoutInfo (I37765)

Sửa lỗi

  • Cập nhật hàng thẻ nhằm đảm bảo hàng này xử lý chính xác số thẻ là 0 hoặc 1. (I44009), (1c01525), (b/264018028)
  • Khắc phục sự cố tìm kiếm theo tâm điểm khi TvLazyColumn chứa TvLazyRow rỗng. (e11b4fe), (b/260299091)
  • Đối tượng sửa đổi clickable hiện tương thích với ImmersiveList. (5dd5078), (b/263061052)
  • Phím Quay lại hiện được xử lý và dùng để thoát khỏi Băng chuyền nổi bật. (84c138c)
  • Băng chuyền không làm mất tâm điểm trên nhiều lần nhấn phím nhanh. (799489f)
  • Băng chuyền không làm mất tâm điểm trên lần nhấn giữ phím. (b2cf37e)
  • Giải quyết các sự cố khi thay đổi số lượng trang trình bày trong băng chuyền. (b261247)

Phiên bản 1.0.0-alpha03

Ngày 7 tháng 12 năm 2022

Phát hành androidx.tv:tv-foundation:1.0.0-alpha03 và androidx.tv:tv-material: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

  • TabRow hiện được cung cấp dưới dạng một API thử nghiệm cho phép người dùng thêm các thanh điều hướng trên cùng vào ứng dụng của họ. Nhìn chung, các thiết bị TV yêu cầu tải thẻ khi tiêu đề thẻ được lấy tiêu điểm trong hàng thẻ.
  • Chỉ báo cụ thể cho TV như chỉ báo gạch chân và chỉ báo hình bầu dục được cung cấp sẵn. Bạn có thể xem cách sử dụng mẫu trong tv-samples

Phiên bản 1.0.0-alpha02

Ngày 9 tháng 11 năm 2022

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

Sửa lỗi

  • Cải thiện hiệu suất cuộn khi cuộn qua một tập hợp TvLazyRows/TvLazyColumns bằng cách giảm không gian tìm kiếm tâm điểm. (I723a3)

Phiên bản 1.0.0-alpha01

Ngày 5 tháng 10 năm 2022

Phát hành androidx.tv:tv-foundation:1.0.0-alpha01 và androidx.tv:tv-material: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

Phiên bản alpha đầu tiên bao gồm những phương thức triển khai xem trước sớm cho các thành phần trong trường hợp sử dụng của TV, bao gồm:

  • Thêm đối tượng sửa đổi scrollableWithPivot để cho phép các vùng chứa cuộn không tải từng phần như Hàng, Cột, Lưới có vùng chứa cuộn cuộn nội dung sao cho các mục là tâm điểm ở cùng một vị trí trên màn hình TV.
  • Thêm các thành phần kết hợp TvLazyRow,TvLazyColumn, TvLazyHorizontalGrid, TvLazyVerticalGrid để vùng chứa cuộn di chuyển nội dung sao cho các mục là tâm điểm vẫn ở cùng một vị trí trên màn hình TV.
  • Thêm thành phần kết hợp Băng chuyền nổi bật (Featured Carousel) cho TV, cho phép người dùng tạo băng chuyền biểu ngữ cuộn tự động.
  • Thêm thành phần kết hợp Danh sách sống động (Immersive List) cho TV, cho phép người dùng tạo Hàng/Cột/Lưới sống động để thay đổi nền dựa trên các mục trong danh sách là tâm điểm.

Vấn đề đã biết

  • Khi vùng chứa cuộn trở thành tâm điểm, theo mặc định, phần tử đầu tiên thường không được làm tâm điểm.
  • Tâm điểm tại TextField không phải lúc nào cũng mở bàn phím nhập hoặc có thể ngăn tâm điểm di chuyển đến các trường khác.
  • Thao tác cuộn theo chiều dọc kém hiệu quả trong LazyColumn chứa LazyRows.