Thẻ thông tin Wear
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 7 tháng 8 năm 2024 | 1.4.0 | - | - | - |
Khai báo phần phụ thuộc
Để thêm một phần phụ thuộc trên Wear, bạn phải thêm kho lưu trữ Maven của Google 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 { // Use to implement support for wear tiles implementation "androidx.wear.tiles:tiles:1.4.0" // Use to utilize standard components and layouts in your tiles implementation "androidx.wear.protolayout:protolayout:1.2.0" // Use to utilize components and layouts with Material Design in your tiles implementation "androidx.wear.protolayout:protolayout-material:1.2.0" // Use to include dynamic expressions in your tiles implementation "androidx.wear.protolayout:protolayout-expression:1.2.0" // Use to preview wear tiles in your own app debugImplementation "androidx.wear.tiles:tiles-renderer:1.4.0" // Use to fetch tiles from a tile provider in your tests testImplementation "androidx.wear.tiles:tiles-testing:1.4.0" }
Kotlin
dependencies { // Use to implement support for wear tiles implementation("androidx.wear.tiles:tiles:1.4.0") // Use to utilize standard components and layouts in your tiles implementation("androidx.wear.protolayout:protolayout:1.2.0") // Use to utilize components and layouts with Material Design in your tiles implementation("androidx.wear.protolayout:protolayout-material:1.2.0") // Use to include dynamic expressions in your tiles implementation("androidx.wear.protolayout:protolayout-expression:1.2.0") // Use to preview wear tiles in your own app debugImplementation("androidx.wear.tiles:tiles-renderer:1.4.0") // Use to fetch tiles from a tile provider in your tests testImplementation("androidx.wear.tiles:tiles-testing:1.4.0") }
Để 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.
Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.
Phiên bản 1.4
Phiên bản 1.4.0
Ngày 7 tháng 8 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.4.0
. Phiên bản 1.4.0 bao gồm các thay đổi sau.
Thay đổi quan trọng kể từ phiên bản 1.3.0
- Hỗ trợ công cụ để chỉ định dữ liệu nền tảng tuỳ chỉnh cho bản xem trước Thẻ thông tin trong Android Studio.
Phiên bản 1.4.0-rc01
Ngày 24 tháng 7 năm 2024
androidx.wear.tiles:tiles-*:1.4.0-rc01
được phát hành mà không có thay đổi nào so với bản phát hành trước. Phiên bản 1.4.0-rc01 bao gồm các thay đổi sau.
Phiên bản 1.4.0-beta01
Ngày 10 tháng 7 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.4.0-beta01
. Phiên bản 1.4.0-beta01 bao gồm các thay đổi sau.
Tính năng mới
Bản phát hành 1.4.0-beta01 của Wear Tiles chỉ ra rằng bản phát hành thư viện này đã hoàn thiện về tính năng và API bị khoá (ngoại trừ trường hợp được đánh dấu là thử nghiệm). Thẻ thông tin Wear 1.4 có các chức năng và API mới sau đây:
- Hỗ trợ công cụ để chỉ định dữ liệu nền tảng tuỳ chỉnh cho bản xem trước Thẻ thông tin trong Android Studio.
Phiên bản 1.4.0-alpha05
Ngày 26 tháng 6 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.4.0-alpha05
. Phiên bản 1.4.0-alpha05 bao gồm các thay đổi sau.
Phiên bản 1.4.0-alpha04
Ngày 29 tháng 5 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.4.0-alpha04
. Phiên bản 1.4.0-alpha04 bao gồm các thay đổi sau.
Phiên bản 1.4.0-alpha03
Ngày 14 tháng 5 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.4.0-alpha03
. Phiên bản 1.4.0-alpha03 bao gồm các thay đổi sau.
Sửa lỗi
TileService#getActiveTilesAsync
hiện sử dụng APIWearSdk
(nếu có) để cung cấp kết quả chính xác hơn. (I57bd8)
Phiên bản 1.4.0-alpha02
Ngày 1 tháng 5 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.4.0-alpha02
. Phiên bản 1.4.0-alpha02 bao gồm các thay đổi sau.
Thay đổi về API
- Di chuyển
tileId
sang tham số hàm khởi tạo Builder dưới dạng trường bắt buộc và giá trị dấu thời gian mặc định của tài liệu trong phương thức getter. (I98c2b) - Thêm các thông báo proto
TileInteractionEvent
,TileEnter
vàTileLeave
cũng như Trình bao bọc Java cần thiết cho các sự kiện nhập/rời khỏi thẻ thông tin theo lô. (I112b0) - Tái cấu trúc
TileRenderer
để sử dụng Builder thay vì đối tượngTileRenderer.Config
. (Ib66f9) - Thêm thuộc tính
platformDataProviders
vàoTileRenderer.Config
. (I6030d) - Thêm một hàm khởi tạo mới vào
TileRenderer
để hỗ trợ lớpTileRenderer.Config
mới. Các hàm khởi tạo khác không được dùng nữa. (Iae7ff) - Thêm trường
platformDataValues
vàoTilePreviewData
để cho phép ghi đè các giá trị dữ liệu nền tảng. (If437a)
Sửa lỗi
- Ghi nhận rằng giá trị mặc định của
TileRenderer.Config.Builder#setTilesTheme
bằng 0. (Iced18)
Phiên bản 1.4.0-alpha01
Ngày 6 tháng 3 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.4.0-alpha01
. Phiên bản 1.4.0-alpha01 bao gồm các thay đổi sau.
Phiên bản 1.3
Phiên bản 1.3.0
Ngày 7 tháng 2 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.3.0
. Phiên bản 1.3.0 bao gồm các thay đổi sau.
Những thay đổi quan trọng kể từ phiên bản 1.2.0
- Cập nhật công cụ để hỗ trợ bản xem trước thẻ thông tin.
- Hỗ trợ truy vấn các thẻ thông tin đang hoạt động thuộc về ứng dụng.
Các nội dung thay đổi khác
- Để biết tập hợp các thay đổi hoàn chỉnh hơn được giới thiệu trong phiên bản 1.3.0, hãy xem ghi chú phát hành beta01.
Phiên bản 1.3.0-rc01
Ngày 24 tháng 1 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.3.0-rc01
. Phiên bản 1.3.0-rc01 bao gồm các thay đổi sau.
Thay đổi về API
- Đổi tên
TileService#getActiveTilesSnapshotAsync
thànhgetActiveTilesAsync
. (If6b87)
Phiên bản 1.3.0-beta01
Ngày 10 tháng 1 năm 2024
Phát hành androidx.wear.tiles:tiles-*:1.3.0-beta01
. Phiên bản 1.3.0-beta01 bao gồm các thay đổi sau.
Bản phát hành 1.3.0-beta01 của Wear Tiles cho biết bản phát hành này của thư viện đã hoàn thiện về tính năng và API bị khoá (ngoại trừ trường hợp được đánh dấu là thử nghiệm). Thẻ thông tin Wear 1.3 có các chức năng và API mới sau đây:
- Cập nhật mô-đun cho công cụ thẻ thông tin trên Wear để hỗ trợ tính năng xem trước thẻ thông tin và đã sẵn sàng để xuất bản.
- Hỗ trợ truy vấn thẻ thông tin nào thuộc ứng dụng đang hoạt động bằng
TileService.getActiveTilesSnapshotAsync
.
Phiên bản 1.3.0-alpha04
Ngày 13 tháng 12 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.3.0-alpha04
. Phiên bản 1.3.0-alpha04 bao gồm các thay đổi sau.
Phiên bản 1.3.0-alpha03
Ngày 29 tháng 11 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.3.0-alpha03
. Phiên bản 1.3.0-alpha03 bao gồm các thay đổi sau.
Tính năng mới
- Thêm API mới
TileService#getActiveTilesSnapshotAsync
để truy vấn thẻ thông tin nào thuộc ứng dụng đang hoạt động. (I6850e)
Thay đổi về API
- Đổi tên
@TilePreview
thành@Preview
(Ifc08a)
Phiên bản 1.3.0-alpha02
Ngày 15 tháng 11 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.3.0-alpha02
. Phiên bản 1.3.0-alpha02 bao gồm các thay đổi sau.
Tính năng mới
- Chúng tôi đã thêm một API thử nghiệm để tự động điều chỉnh kích thước văn bản dựa trên không gian có trong thành phần mẹ. (Ibbe63)
Phiên bản 1.3.0-alpha01
Ngày 18 tháng 10 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.3.0-alpha01
. Phiên bản 1.3.0-alpha01 bao gồm các thay đổi sau.
Tính năng mới
- Hãy cung cấp ngữ cảnh dưới dạng tham số phương thức xem trước thay vì tham số gọi lại
TilePreviewData
. (I5e97d) - Cập nhật mô-đun cho công cụ thẻ thông tin trên Wear để hỗ trợ tính năng xem trước thẻ thông tin và đã sẵn sàng để xuất bản. (I63d0f)
Phiên bản 1.2
Phiên bản 1.2.0
Ngày 9 tháng 8 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0
. Phiên bản 1.2.0 bao gồm các thay đổi sau.
Thay đổi quan trọng kể từ phiên bản 1.1.0
- Bản phát hành ổn định của Wear Tiles 1.2.0 (đọc thêm)
- Thẻ thông tin 1.2 bổ sung tính năng hỗ trợ liên kết các phần tử bố cục với dữ liệu nền tảng (để cập nhật nhanh hơn) và ảnh động. Để biết hướng dẫn di chuyển, hãy xem ghi chú phát hành cho (1.2.0-rc01)
Phiên bản 1.2.0-rc01
Ngày 26 tháng 7 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-rc01
. Phiên bản 1.2.0-rc01 bao gồm các thay đổi sau.
Với bản phát hành v1.2, thư viện Thẻ thông tin đã được tái cấu trúc, đồng thời phần lớn tính năng cũng như API được chuyển vào thư viện ProtoLayout mới (gói
androidx.wear.protolayout
) và một tập hợp con nhỏ còn lại trong Thẻ thông tin (androidx.wear.tiles
):- Tất cả các tên lớp vẫn giữ nguyên, chỉ có bổ sung cho v1.1
- Phần lớn API vẫn giữ nguyên và thay đổi duy nhất là tên gói.
- Một số phương thức trong
TileService/TileBuilder
không còn được dùng nữa và hiện đã đổi tên các phiên bản chấp nhận loạiProtoLayout
mới thay vì Thẻ thông tin một loại không dùng nữa.
Để quá trình di chuyển này dễ dàng hơn, chúng tôi đã cung cấp một hướng dẫn và tập lệnh nhỏ để thực hiện việc đổi tên này, xem tại đây.
Thay đổi về API
- Chúng tôi đã giới hạn chiều sâu tối đa mà một bố cục có thể có tối đa 30 phần tử lồng nhau trong thẻ thông tin. Nếu vượt quá chiều sâu đó, trình kết xuất thẻ thông tin sẽ hiển thị bố cục được tăng cường trước đó. (I8a74b)
Phiên bản 1.2.0-beta01
Ngày 21 tháng 6 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-beta01
mà không có thay đổi nào. Phiên bản 1.2.0-beta01 bao gồm các thay đổi sau.
Phiên bản 1.2.0-alpha07
Ngày 7 tháng 6 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-alpha07
. Phiên bản 1.2.0-alpha07 bao gồm các thay đổi sau.
Tính năng mới
TileRenderer.setState
cho phép đặt trạng thái cho phiên kết xuất. Trạng thái này sẽ áp dụng cho bố cục hiện tại và mọi bố cục trong tương lai (cho đến khi bạn đặt trạng thái mới) (Iaaf35)- Các loại bố cục protolayout hiện được hỗ trợ đầy đủ trên tất cả các APIS của trình kết xuất ô. (I428b0)
Sửa lỗi
- Giờ đây, bạn có thể đặt giao diện tuỳ chỉnh trong
ProtoLayoutViewInstance
. (Iae8c0)
Phiên bản 1.2.0-alpha06
Ngày 24 tháng 5 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-alpha06
. Phiên bản 1.2.0-alpha06 bao gồm các thay đổi sau.
Thay đổi về API
- Đổi tên
StateEntryValue
thànhDynamicDataValue
và cập nhật các API trạng thái để sử dụngDynamicDataKey
(If1c01) - Chúng tôi sẽ giới hạn số lượng mục được phép trong
StateStore
để đảm bảo việc sử dụng bộ nhớ và thời gian cập nhật trạng thái được kiểm soát và kiểm soát tốt đối với mỗi thực thể củaStateStore
. Do đó, nhà phát triển cần đảm bảo rằng họ không có nhiều hơnMAX_STATE_ENTRY_COUNT
mục nhập trong bản đồ, nếu không họ sẽ nhận đượcIllegalStateException
khi tạo hoặc cập nhậtStateStore
. (Ibadb3)
Phiên bản 1.2.0-alpha05
Ngày 10 tháng 5 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-alpha05
. Phiên bản 1.2.0-alpha05 bao gồm các thay đổi sau.
Tính năng mới
- Chúng tôi đã thêm mã thẻ thông tin vào các yêu cầu và sự kiện thẻ thông tin. Bạn có thể dùng mã nhận dạng này để liên kết một số dữ liệu với một phiên bản thẻ thông tin trong băng chuyền. (Ic4f83)
Thay đổi về API
TileRenderer.inflateAsync
hiện trả về mộtListenableFuture
. (I2f2b9)- Các trình tạo thẻ thông tin có thay thế trong thư viện
protolayout
hiện được đánh dấu là không dùng nữa. (Ie2029)
Sửa lỗi
- Giờ đây, javadoc cho
TileService.onTileResourcesRequest
sẽ làm rõ thời điểm hệ thống có thể gọi phương thức này. (Iee037)
Phiên bản 1.2.0-alpha04
Ngày 19 tháng 4 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-alpha04
. Phiên bản 1.2.0-alpha04 bao gồm các thay đổi sau.
Sửa lỗi
- Các phần phụ thuộc gradle hiện đã được thiết lập chính xác thành
api
thay vìimplementation
khi bắt buộc. (I40503)
Phiên bản 1.2.0-alpha03
Ngày 5 tháng 4 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-alpha03
. Phiên bản 1.2.0-alpha03 bao gồm các thay đổi sau.
Thay đổi về API
- Chúng tôi đã hỗ trợ thêm các loại
androidx.wear.protolayout
vàoTileRenderer
(I4ac7f) ObservableStateStore
đổi tên thànhStateStore
(Ieb0e2)- Thêm các phương thức nạp chồng cho các kiểu protolayout vào
TileRenderer
(I4ac7f) - Bật ảnh động trong
TileRenderer
(I07dcf)
Phiên bản 1.2.0-alpha02
Ngày 22 tháng 3 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-alpha02
. Phiên bản 1.2.0-alpha02 bao gồm các thay đổi sau.
Thay đổi về API
- Thư viện Tiles Material không còn được dùng nữa. Vui lòng sử dụng thư viện
ProtoLayout Material
mới có các chức năng tương tự. (If242b)
Sửa lỗi
TileRenderer
đã được cập nhật để sử dụng các tính năng mới từ thư viện protolayout. (I832f9)
Phiên bản 1.2.0-alpha01
Ngày 8 tháng 3 năm 2023
Phát hành androidx.wear.tiles:tiles-*:1.2.0-alpha01
. Phiên bản 1.2.0-alpha01 bao gồm các thay đổi sau.
Tính năng mới
- Chúng tôi thêm
onTileResourceRequest
vàoTileService
để cung cấp tài nguyên trong thư việnprotolayout
. (983d9c5) - Chúng tôi đã cập nhật
ResourcesRequest
vàTileRequest
để hỗ trợ các loạiState
vàDeviceParameters
trong thư việnprotolayout
. (88fa01d) - Chúng tôi cập nhật
TileBuilders.Tile
để hỗ trợ các loạiState
vàTimeline
trong thư việnprotolayout
. (168619c)
Sửa lỗi
- Các cải tiến đối với Javadocs. (I3ed73)
- Màu mặc định cho
onPrimary
và vùng hiển thị đã thay đổi. (I0b039)
Phiên bản 1.1
Phiên bản 1.1.0
Ngày 24 tháng 8 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0
. Phiên bản 1.1.0 bao gồm các thay đổi sau.
Thay đổi quan trọng kể từ phiên bản 1.0.0
- Đây là bản phát hành ổn định đầu tiên chứa thư viện Tiles Material (xem thêm trên blog của chúng tôi).
- Thư viện này chứa các thành phần và bố cục phù hợp với các nguyên tắc của Material Design và dễ sử dụng. Các thành phần đi kèm gồm có
Button
,Chip
,CompactChip
,TitleChip
,CircularProgressIndicator
,Text
. Tất cả các thành phần này đều có đối tượng màu riêng có thể được xây dựng bằng lớp Colors (Màu sắc) chính, từ đó dễ dàng áp dụng cùng một giao diện cho mọi thành phần. Ngoài màu sắc, còn có một lớp Typography (Kiểu chữ) giúp dễ dàng lấy đối tượng FontStyle theo tên kiểu chữ. - Ngoài thành phần, còn có các bố cục ô được đề xuất –
PrimaryLayout
,EdgeContentLayout
,MultiButtonLayout
,MultiSlotLayout
. Tất cả bố cục đều áp dụng khoảng đệm và kiểu được đề xuất trong các nguyên tắc của Material Design. - Để biết danh sách thành phần và bố cục trong thư viện Tiles Material, hãy xem ghi chú phát hành cho Ô thông tin.
Phiên bản 1.1.0-rc01
Ngày 10 tháng 8 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-rc01
. Phiên bản 1.1.0-rc01 bao gồm các thay đổi sau.
- Không có thay đổi mới nào giữa bản phát hành Beta và RC.
Phiên bản 1.1.0-beta01
Ngày 27 tháng 7 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-beta01
. Phiên bản 1.1.0-beta01 bao gồm các thay đổi sau.
Bản phát hành 1.0.0-beta01 của thư viện Tiles Material chứa các thành phần và bố cục phù hợp với các nguyên tắc của Material Design và dễ xây dựng.
Các thành phần bao gồm:
Button
– đối tượng hình tròn, có thể nhấp vào, có biểu tượng, văn bản hoặc hình ảnh với 3 kích thước được xác định trước.Chip
– đối tượng có thể nhấp, có hình dạng sân vận động, có thể chứa biểu tượng, nhãn chính và nhãn phụ, đồng thời có chiều cao cố định và chiều rộng có thể tùy chỉnh.CompactChip
&TitleChip
– hai biến thể của Chip tiêu chuẩn có chiều cao nhỏ hơn và lớn hơn tương ứng, đồng thời có thể chứa một dòng văn bản.CircularProgressIndicator
– vòng cung có màu xung quanh cạnh màn hình với các góc bắt đầu và kết thúc cố định, có thể mô tả một vòng tròn đầy đủ hoặc một phần vòng tròn với vòng cung nguyên vẹn phía sau.Text
– văn bản được tạo kiểu bằng các kiểu chữ được đề xuất trên Wear Material
Tất cả các thành phần này đều có đối tượng màu riêng có thể được xây dựng bằng lớp Colors
chính để dễ dàng áp dụng cùng một giao diện cho tất cả các thành phần. Ngoài màu sắc còn có một lớp Typography
để dễ dàng lấy đối tượng FontStyle
bằng cách sử dụng tên kiểu chữ.
Ngoài các thành phần còn có các bố cục theo ô cạnh nhau được đề xuất:
PrimaryLayout
– Một bố cục có thể tùy chỉnh được bằng cách thêm nhãn chính hoặc nhãn phụ, nội dung ở giữa và khối chip chính ở dưới cùng. Bạn có thể thêm nội dung chính trong bố cục này dưới dạng đối tượngMultiSlotLayout
hoặcMultiButtonLayout
.EdgeContentLayout
– Bố cục lưu trữCircularProgressIndicator
xung quanh cạnh có nội dung chính bên trong và nhãn chính hoặc phụ xung quanh.MultiButtonLayout
– Bố cục có thể chứa từ 1-7 nút, được sắp xếp phù hợp với các nguyên tắc Material tùy theo số lượng của chúng.MultiSlotLayout
– Bố cục kiểu giống hàng có các khung được căn chỉnh và giãn cách theo chiều ngang (dành cho biểu tượng hoặc nội dung nhỏ khác).
Tất cả bố cục đều áp dụng khoảng đệm và kiểu được đề xuất trong các nguyên tắc của Material Design.
Thay đổi API
- Việc tái cấu trúc chính các thành phần Chip bao gồm các phương thức setter riêng biệt trong Bản dựng, để từng phần của nội dung được chuyển vào riêng biệt bằng cách đổi tên cho phù hợp với các nguyên tắc (nhãn chính, nhãn phụ, mã tài nguyên hình ảnh). Ngoài ra, nội dung mô tả sẽ được tạo tự động nếu không được đặt. (I57622)
ProgressIndicatorLayout
đã được đổi tên thànhEdgeContentLayout
. (Ic1aa6)- Nội dung kích thước nút đã được đổi tên thành hậu tố tên
without _BUTTON
, với thông tin giải thích bổ sung về Javadocs trênButton
. (I1dfe2)
Sửa lỗi
- Lề, khoảng đệm và cách sắp xếp tổng thể trong Bố cục Material đã được cập nhật để phù hợp với tất cả các kiểu bố cục cũng như kích thước màn hình và hình dạng đề xuất.
- Cải tiến đối với Bố cục Material. Trong
MultiSlotLayout
, các khung hiện có chiều rộng linh hoạt, nơi chúng sẽ co giãn theo nội dung thay vì kích thước cố định.(I52919),(If18b4) - Vùng được nhấn vào trên
CompactChip
đã được tăng lên để tuân thủ các nguyên tắc về khả năng hỗ trợ tiếp cận. (Ie8264)
Phiên bản 1.1.0-alpha09
Ngày 29 tháng 6 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-alpha09
. Phiên bản 1.1.0-alpha9 bao gồm các thay đổi sau.
Tính năng mới
- Chúng tôi đã hỗ trợ thêm các nhãn không bắt buộc trong
ProgressIndicatorLayout
. (I30788)
Thay đổi API
- Các phương thức trợ giúp cho
ElementMetadata
hiện chấp nhậnElementMetadata
thay vì Công cụ sửa đổi. (I5a70f)
Sửa lỗi
- Đã xóa giới hạn 9 ký tự trên
CompactChip
. Nếu văn bản quá lớn không thể vừa với màn hình trongPrimaryLayout
, văn bản đó sẽ bị elip hóa. (Id56ec) - Các phương thức getter trong
Chip
hiện có hậu tố Nội dung. (Iba437) - Giải thích về Javadoc trên các lớp Tiles Material. (I56e41), (I80f31), (Iba437)
Phiên bản 1.1.0-alpha08
Ngày 1 tháng 6 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-alpha08
. Phiên bản 1.1.0-alpha08 bao gồm các thay đổi sau.
Tính năng mới
- Chúng tôi đã thêm thẻ siêu dữ liệu vào Công cụ sửa đổi để theo dõi siêu dữ liệu của thành phần bằng các phương thức trợ giúp được thêm vào lớp
Helper
. (I70db2),(I30c3d) - Phương thức
fromLayoutElement
tĩnh đã được thêm vào tất cả các thành phần và bố cục bên trong Tiles Material. Bạn nên dùng phương thức này để thử nghiệm và truyền một LayoutElement (Phần tử bố cục) thu được từ việc truy cập nội dung của vùng chứa về lại kiểu ban đầu của nó.) (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)
Phiên bản 1.1.0-alpha07
Ngày 18 tháng 5 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-alpha07
. Phiên bản 1.1.0-alpha07 bao gồm các thay đổi sau.
Thay đổi API
- Các phương thức getter liên quan đến những phương thức setter cho nội dung hiện đã được thêm vào
ProgressIndicatorLayout
vàPrimaryLayout
. Giờ đây, tất cả phương thức setter trong các lớp này đều có phương thức getter phù hợp.(Iddbe5) (Iabe4e) - Phương thức getter cho nội dung mô tả trong Thành phần Material có thể trả về giá trị null vì phương thức setter không bắt buộc.
- Việc cố gắng tạo một Nút không có nội dung được truyền vào sẽ dẫn đến
IllegalArgumentException
. (I7fc0c) - Các trường có liên quan đến màu biểu tượng trong
ChipColors
đã được đổi tên từiconTintColor
thànhiconColor
. (Ic053b)
Sửa lỗi
- Đã thêm
androidTests
cho Bố cục trong Tiles Material. (I96404)
Phiên bản 1.1.0-alpha06
Ngày 11 tháng 5 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-alpha06
. Phiên bản 1.1.0-alpha06 chứa các cam kết này.
Tính năng mới
- Bố cục mới đã được thêm vào thư viện phụ Material Layouts –
MultiButtonLayout
. Nó biểu thị bố cục có thể chứa từ 1 đến 7 nút được sắp xếp phù hợp với các nguyên tắc Material. Trong hầu hết các trường hợp, bố cục này phải được truyền vào dưới dạng nội dung cho PrimaryLayout. (Ib727f)
Thay đổi API
MultiSlotLayout
đã được tái cấu trúc để chỉ có các vị trí trong đó. Bố cục này phải được truyền dưới dạng nội dung choPrimaryLayout
chính. (I1870f)- Cập nhật màu mặc định đã xác định cho
CircularProgressIndicator
thành một giá trị thay vì giá trị chính và phụ. (I64a51) - Đã thêm phương thức getter cho khoảng cách ngang trong
MultiSlotLayout
. (I11e1e)
Sửa lỗi
- Chúng tôi đã thêm các thử nghiệm cho Thành phần trên Android vào Tài liệu xếp kề. (I20041)
Phiên bản 1.1.0-alpha05
Ngày 6 tháng 4 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-alpha05
. Phiên bản 1.1.0-alpha05 bao gồm các thay đổi sau.
Tính năng mới
- Thêm các phương thức trợ giúp để chuyển đổi
LayoutElement
thành Bố cục, Dòng thời gian, Dòng thời gian vào các lớp này để dễ dàng xây dựng Thẻ thông tin hơn. (I2f6d1) - Đối tượng
Colors
đã được thêm vào thư viện Material để được chuyển qua các màu của thành phần. (I0792c)
Thay đổi API
- Thành phần Material Text yêu cầu văn bản phải được đưa vào hàm dựng. Bạn hiện có thể tùy chỉnh thành phần này bằng cách đặt trọng số. (I25dbd)
- Đã xóa các hằng số khỏi
ChipDefaults
, những hằng số này không được dùng trong phương thức setter công khai. (I7baed) - Đã xóa các phương thức getter khỏi
CompactChip
vàTitleChip
không có phương thức setter phù hợp. (I99e85) - Đã xóa
DEFAULT_PADDING
khỏiProgressIndicatorDefaults
. (Idabcd) - Các thành phần Material hiện chấp nhận
CharSequence
cho mô tả nội dung thay vì String. (I5b21a)
Sửa lỗi
- Phương thức triển khai phương thức setter đã được tái cấu trúc của các nút không bắt buộc trong Nút. (Ib7135)
- Đã thêm biến thể kiểu phông chữ vào phông chữ trong kiểu chữ. (I8dbc6)
Phiên bản 1.1.0-alpha04
Ngày 23 tháng 3 năm 2022
Phát hành androidx.wear.tiles:tiles-*:1.1.0-alpha04
. Phiên bản 1.1.0-alpha04 bao gồm các thay đổi sau.
Tính năng mới
- Bạn có thể thêm nhãn chính hoặc nhãn phụ trong
PrimaryLayout
. (Ib9916) - Bạn có thể tùy chỉnh thành phần văn bản bằng cách đặt chế độ tràn, in nghiêng, gạch dưới, v.v. (I703f7)
Thay đổi API
- Các hằng số màu mặc định đã bị xóa khỏi API Tiles Material. (I0ab55)
- Tất cả các thành phần có thể nhấp trong Tài liệu ô đều yêu cầu đối tượng
Clickable
trong hàm dựng của Trình tạo thay vì Hành động. (I2f101)
Sửa lỗi
- Bây giờ, Văn bản sẽ vẽ dấu ba chấm trên tràn trong Thành phần Chip và Văn bản. (I8a2f8)
- Các thành phần được cải tiến sẽ trông khi kích thước phông chữ của người dùng được đặt thành lớn. (Ib63b1)
- Làm rõ tài liệu Java của
setPrimaryChipContent
trong PrimaryLayout. (Ie6296)
Phiên bản 1.1.0-alpha03
Ngày 23 tháng Hai, 2022
androidx.wear.tiles:tiles-*:1.1.0-alpha03
đã phát hành. Phiên bản 1.1.0-alpha03 bao gồm các thay đổi sau.
Thay đổi API
- Thành phần
Text
với các kiểu chữ được đề xuất đã được thêm vào Tài liệu Thẻ thông tin. (Iec0ae)
Phiên bản 1.1.0-alpha02
Ngày 9 tháng Hai, 2022
androidx.wear.tiles:tiles-*:1.1.0-alpha02
đã phát hành. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.
Tính năng mới
- Một thư viện phụ
layouts
mới trong Tài liệu về ô đã được thêm. Những ô này có các bố cục ô xếp cạnh nhau, cùng khoảng đệm và khoảng lề được đề xuất, giúp quá trình phát triển thẻ thông tin trở nên nhanh hơn và dễ dàng hơn. Bố cục ban đầu là:PrimaryLayout
(I7ba91) biểu thị bố cục có một khối chính ở dưới cùng và nội dung ở giữa.MultiSlotLayout
(I32104) đại diện cho một bố cục có nhãn trên hàng 1 và 3, ngăn ngang và giãn cách trên hàng 2 và tất cả theo sau là hàng thứ 4 chứa chip chính.ProgressIndicatorLayout
(I9fec6) biểu thị một bố cục có chỉ báo tiến trình vòng quanh cạnh màn hình và nội dung đã cho.
CircularProgressIndicator
(Ic4b88) đã được thêm vào thành phần Tài liệu Thẻ thông tin.
Thay đổi API
- Đã đổi tên các hằng số còn lại mà
TitleChip
sử dụng để đưa tiêu đề vào tên. (I14f4c) - Đã thêm phương thức
setHorizontalAlignment
vàoChip
. (Ie6e0b)
Phiên bản 1.1.0-alpha01
Ngày 26 tháng Một, 2022
androidx.wear.tiles:tiles-*:1.1.0-alpha01
đã phát hành. Phiên bản 1.1.0-alpha01 bao gồm các thay đổi sau.
Tính năng mới
- Tài liệu Thẻ thông tin mới của thư viện đã được thêm. Thành phần này chứa các thành phần để xây dựng bố cục Thẻ thông tin nhanh hơn và dễ dàng hơn nhờ thiết kế Material. Các thành phần ban đầu là:
Button
Chip
CompactChip
TitleChip
Sửa lỗi
- Khắc phục lỗi trong
TileUiClient
dẫn đến tài nguyên được lưu vào bộ nhớ đệm bị hủy. (I60e0b)
Phiên bản 1.0
Phiên bản 1.0.1
Ngày 26 tháng Một, 2022
androidx.wear.tiles:tiles-*:1.0.1
đã phát hành. Phiên bản 1.0.1 bao gồm các thay đổi sau.
Sửa lỗi
- Khắc phục lỗi trong
TileUiClient
dẫn đến tài nguyên được lưu vào bộ nhớ đệm bị hủy. (I60e0b)
Phiên bản 1.0.0
Ngày 3 tháng Mười một, 2021
androidx.wear.tiles:tiles-*:1.0.0
đã phát hành. Phiên bản 1.0.0 bao gồm các thay đổi sau.
Các tính năng chính của phiên bản 1.0.0
- Thư viện Thẻ thông tin Wear cung cấp chức năng tạo các thẻ thông tin tùy chỉnh cho các thiết bị Wear OS, cùng với các lớp học cho phép hệ thống tìm nạp Thẻ thông tin và hiển thị ô đó ngay bên cạnh mặt đồng hồ.
- Công cụ hiển thị ô cho phép bạn hiển thị Thẻ thông tin thuộc một hoạt động trên Android, giúp bạn kiểm tra nhanh bố cục thẻ thông tin.
Phiên bản 1.0.0-rc01
Ngày 27 tháng 10 năm 2021
Phát hành androidx.wear.tiles:tiles-*:1.0.0-rc01
. Phiên bản 1.0.0-rc01 bao gồm các thay đổi sau.
Phiên bản 1.0.0-beta01
Ngày 13 tháng Mười, 2021
androidx.wear.tiles:tiles-*:1.0.0-beta01
đã phát hành. Phiên bản 1.0.0-beta01 bao gồm các thay đổi sau.
Sửa lỗi
- Đã khắc phục
NullPointerException
trongTileUiClient
khi cung cấp phiên bản tài nguyên trống. (I0586e)
Phiên bản 1.0.0-alpha12
Ngày 29 tháng Chín, 2021
androidx.wear.tiles:tiles-*:1.0.0-alpha12
đã phát hành. Phiên bản 1.0.0-alpha12 bao gồm các thay đổi sau.
Sửa lỗi
UpdateScheduler không còn dùng tệp tham chiếu yếu để khắc phục những vấn đề mà TileUiClient không cập nhật(I1120d, b/199061124)
Khai báo rằng SysUiTileUpdateRequester truy vấn PacakgeManager, sửa một lỗi cập nhật thẻ thông tin không hoạt động trên các thiết bị R+. (I1120d)
Phiên bản 1.0.0-alpha11
Ngày 1 tháng Chín, 2021
androidx.wear.tiles:tiles-*:1.0.0-alpha11
đã phát hành. Phiên bản 1.0.0-alpha11 chứa những cam kết này.
Tính năng mới
- Đã thêm và phát hành thư viện thử nghiệm, androidx.wear.tiles:tiles-testing để cho phép các nhà phát triển thử nghiệm các thẻ thông tin của mình dễ dàng hơn. (Iedb6b)
Thay đổi API
- Đã đổi tên TileProviderService thành TileService. (I1ad2c)
- Trình tạo Thẻ thông tin đã cập nhật; phương thức
.builder()
tĩnh đã ngừng hoạt động thay vào đó là gọinew Foo.Builder()
, và quá tải trong setter chấp nhận thực thểBuilder
đã bị xóa. (Ia9606) - TileRenderer hiện cần sử dụng ngữ cảnh giao diện người dùng, thay vì ngữ cảnh ứng dụng. (I84b61)
Sửa lỗi
- Khắc phục lỗi khiến nhiều dấu gạch chân được áp dụng trong một số tình huống nhất định. (Ib6712)
Phiên bản 1.0.0-alpha10
Ngày 18 tháng Tám, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha10
, androidx.wear.tiles:tiles-proto:1.0.0-alpha10
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha10
. Phiên bản 1.0.0-alpha10 chứa những cam kết này.
Thay đổi API
- Đã xóa trình kiểm tra bố cục khỏi API công khai. Các cảnh báo này sẽ luôn bật mặc dù sẽ chỉ hiển thị cảnh báo nếu kết quả kiểm tra không thành công. (Ie9f29)
- TileRenderer hiện chấp nhận ngữ cảnh giao diện người dùng, thay vì Ngữ cảnh ứng dụng.
Sửa lỗi
- Đã khắc phục lỗi khiến các phần tử không thể nhấp vào trong một nội dung có thể nhấp không được nhấp vào.
Phiên bản 1.0.0-alpha09
Ngày 21 tháng Bảy, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha09
, androidx.wear.tiles:tiles-proto:1.0.0-alpha09
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha09
. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.
Tính năng mới
- Đã thêm trình kiểm tra bố cục vào trình kết xuất của kết xuất Thẻ thông tin Wear. (I3a869)
- Chúng được dùng để xác thực các phương pháp hay nhất trong ô của bạn. Để bắt đầu, các mục này sẽ hiển thị cảnh báo nếu ô của bạn không chứa bất kỳ phần tử nào có giá trị sửa đổi
Semantics
.
- Chúng được dùng để xác thực các phương pháp hay nhất trong ô của bạn. Để bắt đầu, các mục này sẽ hiển thị cảnh báo nếu ô của bạn không chứa bất kỳ phần tử nào có giá trị sửa đổi
- Thêm tài liệu cho
DefaultTileProviderClient
vàTestingTileProviderClient constructors
. (I9f4b9)
Thay đổi API
- Đổi tên trong TileProviderClient (I0ec36):
getApiVersion
->requestApiVersion
tile/resourcesRequest
->requestTile/Resources
onTileFooEvent
->sendOnTileFooEvent
- Đã thêm trình kiểm tra bố cục vào trình kết xuất của kết xuất Thẻ thông tin Wear. (I3a869)
Sửa lỗi
- Hãy đảm bảo rằng mục tiêu LaunchAction không có quyền đặc biệt. (I39136)
Phiên bản 1.0.0-alpha08
Ngày 30 tháng Sáu, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha08
, androidx.wear.tiles:tiles-proto:1.0.0-alpha08
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha08
. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.
Tính năng mới
- Chức năng xoay nhanh hiện hỗ trợ line_height thay vì line_spacing.
Thay đổi API
- Thêm tùy chọn hỗ trợ cho line_height trong Spannables, xóa line_spacing. (Ibeb54)
- Thay vào đó, bạn nên chuyển mã sử dụng line_distance để sử dụng line_height.
Sửa lỗi
- Sửa lỗi khi sử dụng tham số tỷ lệ. (I37ace)
- Khắc phục lỗi ngăn các phần tử Văn bản có nội dung mô tả. (Id2c7d)
Phiên bản 1.0.0-alpha07
Ngày 16 tháng Sáu, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha07
, androidx.wear.tiles:tiles-proto:1.0.0-alpha07
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha07
. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.
Thay đổi API
- Thêm giao diện
TileProviderClient
và hiển thịDefaultTileProviderClient
, cho phép các biện pháp triển khai liên kết với giao diệnTileProviderService
. (I69165)
Phiên bản 1.0.0-alpha06
Ngày 2 tháng Sáu, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha06
, androidx.wear.tiles:tiles-proto:1.0.0-alpha06
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha06
. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.
Thay đổi API
- Bây giờ, tất cả các loại của Trình xây dựng đều có thể chứa phương thức getter cho mọi thuộc tính. Xin lưu ý rằng các định dạng này chỉ dành cho mục đích thử nghiệm (I9d155)
- Thay đổi gói: Các loại trong
androidx.wear.tiles.builders
đã được chuyển đếnandroidx.wear.tiles
. - Thêm tính năng hỗ trợ phủ màu thử nghiệm vào Thẻ thông tin. (I38929)
- Đã đổi tên
LayoutElementBuilders.HALIGN_*
thànhLayoutElementBuilders.HORIZONTAL_ALIGN_*
(I67e58) - Đã đổi tên
LayoutElementBuilders.VALIGN_*
thànhLayoutElementBuilders.VERTICAL_ALIGN_*
(I67e58) - Đã đổi tên
LayoutElementBuilders.SPAN_VALIGN_*
thànhLayoutElementBuilders.SPAN_VERTICAL_ALIGN_*
(I67e58) - Đã thêm các lớp trình tạo cho Yêu cầu và Sự kiện. (Ib5cf4)
- Đã di chuyển
TileProviderService
để sử dụng lớp yêu cầu và sự kiện từRequestBuilders
vàEventBuilders
, thay vìRequestReaders
/EventReaders
(ví dụ:onTileRequest
hiện cung cấp cho bạnRequestBuilders.TileRequest
, thay vìRequestReaders.TileRequest
). (I46ea1)
Sửa lỗi
- Khắc phục lỗi trong quá trình tải hình ảnh không đồng bộ cho trình kết xuất Thẻ thông tin. (Iad9b0)
- Đã khắc phục lỗi bố cục khi đặt hình ảnh có chiều rộng hoặc chiều cao được đặt là
expand()
trongBox
với chiều rộng hoặc chiều cao được đặt thànhwrap()
. (I33770)
Phiên bản 1.0.0-alpha05
Ngày 18 tháng Năm, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha05
, androidx.wear.tiles:tiles-proto:1.0.0-alpha05
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha05
. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.
Thay đổi API
- Đã xóa getTileId khỏi các sự kiện ô đến (
TileAddEvent
,TileRemoveEvent
,TileEnterEvent
,TileLeaveEvent
,TileRequest
). (Ifbba2) - Đã đổi tên
ImageResource#setAndroidResourceByResid
thànhsetAndroidResourceByResId
(I4ba6e) - Đã đổi tên
TimelineManager#deInit
để đóng và triển khaiAutoCloseable
. (I5dff2)
Phiên bản 1.0.0-alpha04
Ngày 5 tháng Năm, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha04
, androidx.wear.tiles:tiles-proto:1.0.0-alpha04
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha04
. Phiên bản 1.0.0-alpha04 chứa những cam kết này.
Thay đổi API
- Các loại TileProviderService bê tông ẩn.
- TileUpdateRequester đã được thực hiện một
Class<? extends TileProviderService>
. (Ib7cca)
- TileUpdateRequester đã được thực hiện một
- Đã thêm khả năng thêm nội dung bổ sung vào AndroidActivity. (I748f4)
Thẻ thông tin phiên bản 1.0.0-alpha03
Ngày 21 tháng Tư, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha03
, androidx.wear.tiles:tiles-proto:1.0.0-alpha03
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha03
. Phiên bản 1.0.0-alpha03 bao gồm các thay đổi sau.
Thay đổi API
- Đổi tên
TileManager
->TileClient
- Đổi tên
TileManager#create
->TileClient#connect
(I91839)
- Đổi tên
Sửa lỗi
- Thêm các quy tắc Proguard để đảm bảo
tiles
vàtiles-renderer
hoạt động đúng cách với Proguard (Ie3d85)
Phiên bản 1.0.0-alpha02
Ngày 7 tháng Bốn, 2021
Đã phát hành androidx.wear.tiles:tiles:1.0.0-alpha02
, androidx.wear.tiles:tiles-proto:1.0.0-alpha02
và androidx.wear.tiles:tiles-renderer:1.0.0-alpha02
. Phiên bản 1.0.0-alpha02 bao gồm các thay đổi sau.
Thay đổi API
androidx.wear:wear-tiles
đã chuyển các nhóm và hiện sẽ được gọi làandroidx.wear.tiles:tiles
androidx.wear:wear-tiles-renderer
đã chuyển các nhóm và hiện sẽ được gọi làandroidx.wear.tiles:tiles-renderer
TileRenderer.LoadActionListener
hiện sử dụng một bản sao củaandroidx.wear.tiles.builders.StateBuilders.State
thay vìandroidx.wear.tiles.proto.StateProto.State
.TileRenderer
hiện chấp nhận tài nguyên Thẻ thông tin củaandroidx.wear.tiles.builders.ResourceBuilders.Resources
, thay vì một bản sao củaandroidx.wear.tiles.renderer.ResourceAccessors
.
Sửa lỗi
- Đã khắc phục trường hợp không sử dụng được
LoadActionListener
vì ứng dụng này hiển thị một lớp nội bộ.
Phiên bản 1.0.0-alpha01
Ngày 10 tháng Ba, 2021
Đã phát hành androidx.wear:wear-tiles:1.0.0-alpha01
, androidx.wear:wear-tiles-proto:1.0.0-alpha01
và androidx.wear:wear-tiles-renderer: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
- Thư viện Trình kết xuất Thẻ thông tin về Wear cung cấp chức năng tạo các ô tùy chỉnh cho các thiết bị Wear OS, cùng với các lớp cho phép hệ thống tìm nạp Thẻ thông tin và hiển thị ô đó ngay bên cạnh mặt đồng hồ.