Glance Wear

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

Để thêm một phần phụ thuộc trên glance-wear, bạn phải thêm kho lưu trữ Google Maven vào dự án của mình. Đọ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:

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha13"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha13"
}

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha13")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha13")
}

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

Glance Wear Phiên bản 1.0

Phiên bản 1.0.0-alpha17

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17. Phiên bản 1.0.0-alpha17 bao gồm các thay đổi sau.

Tính năng mới

• Đã thêm các lượt kiểm tra lint trong Glance Wear để thực thi rằng mỗi <container> trong một <wearwidget-provider> XML cho Siêu dữ liệu của tiện ích đều chỉ định rõ ràng một thuộc tính loại được hỗ trợ và không xác định các loại trùng lặp. (I52c9a, b/464458215)

Phiên bản 1.0.0-alpha16

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16. Phiên bản 1.0.0-alpha16 bao gồm các thay đổi sau.

Tính năng mới

• Đã thêm quy trình xác thực Lint cho siêu dữ liệu XML <wearwidget-provider> để đảm bảo có các phần tử cấu hình bắt buộc (chẳng hạn như container và previewImage). (Ia9983, b/464458215)
• Thêm cảnh báo lỗi Lint khi đặt nền đen hoặc nền trong suốt cho Tiện ích Wear (Idedb0, b/529269573)
• Bật thao tác CORE_TEXT Remote Compose cho hồ sơ Tiện ích Wear. Điều này cho phép RemoteText sử dụng các tính năng phông chữ đa dạng (chẳng hạn như trục phông chữ, chiều cao dòng, v.v.) trên các trình kết xuất Máy chủ được hỗ trợ, với chế độ dự phòng tự động khi không được hỗ trợ.

Bản sửa lỗi

• Đã cập nhật KDoc cho chú thích AssociateWithGlanceWearWidget theo ý kiến phản hồi của nhà phát triển

Phiên bản 1.0.0-alpha15

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15. Phiên bản 1.0.0-alpha15 bao gồm các thay đổi sau.

Tính năng mới

• Thêm cảnh báo Lint (tìm lỗi mã nguồn) khi đặt nền trống cho tài liệu Tiện ích Wear. (Ic6475, b/529269573)

Phiên bản 1.0.0-alpha14

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14. Phiên bản 1.0.0-alpha14 bao gồm các thay đổi sau.

Thay đổi về API

• Chúng tôi đã thêm các trình cung cấp tham số xem trước RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams và RoundLargeWidgetPreviewParams cho các tiện ích Glance Wear bo tròn hoàn toàn. (If5336, b/512405233)

Tính năng mới

• Chúng tôi đã thiết lập và thêm thư viện Linter cho các tiện ích Glance Wear.(If4218, b/527402079)
  • Thêm một quy tắc kiểm tra tìm lỗi mã nguồn để đảm bảo rằng các lớp con của GlanceWearWidgetService khai báo rõ ràng lớp tiện ích được liên kết bằng chú thích @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
• Chúng tôi đã cải thiện khả năng tương thích ngược cho các tiện ích chạy trên các Máy chủ cũ bằng cách truyền các thao tác được hỗ trợ thông qua WearWidgetParams và thêm tính năng lọc hồ sơ của các thao tác được phép cho những thao tác đó. (Ib0a1b, I83cb1, [b/526716195])

Phiên bản 1.0.0-alpha13

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13. Phiên bản 1.0.0-alpha13 bao gồm các thay đổi sau.

Thay đổi về API

• Xoá bước kiểm tra quyền khỏi heartRateAccuracy (I14269, b/522444636)

Sửa lỗi

• Chúng tôi đã điều chỉnh các tham số của tiện ích Wear có hình vuông tròn để xem trước theo ý kiến phản hồi về trải nghiệm người dùng

Phiên bản 1.0.0-alpha12

Ngày 17 tháng 6 năm 2026

Phát hành androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12. Phiên bản 1.0.0-alpha12 bao gồm các thay đổi sau.

Tính năng mới

• Đã thêm AssociateWithGlanceWearWidget mà bạn phải sử dụng trên GlanceWearWidgetService để cung cấp phương thức triển khai GlanceWearWidget mà phương thức này được liên kết. (Ifcabb, b/514679763)

  • Ví dụ:

   @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
   class MyGlanceWearWidgetService : GlanceWearWidgetService() {
     override val widget = MyGlanceWearWidget()
   }
   ```
  

• Chúng tôi đã thêm cọ image vào WearWidgetBrush để hỗ trợ hình nền bitmap trong Tiện ích Wear. (I9a228, b/513481558)

• Chúng tôi đã giới thiệu hàm trợ giúp @Composable, WearWidgetPreview, để đơn giản hoá quá trình phát triển các tiện ích Glance Wear bằng cách loại bỏ mã lặp lại cần thiết cho bản xem trước IDE.

Thay đổi về API

• Đổi tên androidx.glance.wear.health.DataType thành androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
• isHeartRateBpmAvailable được hiển thị để xác định xem heartRateBpm có trên máy chủ lưu trữ hay không. (I5999d, b/514641567)
• Hiển thị toán tử so sánh RemoteInt. (I5fe3d, b/513228889)
• Cấp quyền truy cập vào captureRemoteDocument Flow API và một phương thức nạp chồng captureSingleRemoteDocument mới (lấy RemoteCreationDisplayInfo) làm API công khai. (I87b0e, b/513228889)
• Chúng tôi đã thêm @CallSuper vào các phương thức trong vòng đời GlanceWearWidgetService

Phiên bản 1.0.0-alpha11

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11. Phiên bản 1.0.0-alpha11 bao gồm các thay đổi sau.

Thay đổi về API

• Chúng ta đã thêm WearWidgetPreview để xem trước Tiện ích Wear trong Android Studio. (I36504, b/485147770)
• Hiển thị các biến is*Available (isDailyStepsAvailable, v.v.) để xác minh xem loại dữ liệu sức khoẻ có liên quan có sẵn và hợp lệ hay không. (Ib98a7, b/498179656)
• Đã thêm API triggerUpdateAll vào GlanceWearWidget để kích hoạt quá trình cập nhật trên tất cả các tiện ích của ứng dụng đã cho. (I6ab20, b/510896410)

Sửa lỗi

• Đưa thông tin về phiên bản Trình kết xuất vào WearWidgetParams dưới dạng trường nội bộ để ngăn tình trạng gián đoạn trong tài liệu được tạo bằng phiên bản alpha10. (Idcf8e, b/511263591, b/512830184)
• Kích hoạt quy trình cập nhật kéo bắt buộc ở chế độ gỡ lỗi hoặc trình mô phỏng cho Tiện ích Wear.

Phiên bản 1.0.0-alpha10

Ngày 19 tháng 5 năm 2026

Phát hành androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 và androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10. Phiên bản 1.0.0-alpha10 bao gồm các thay đổi sau.

Thay đổi về API

• Hiển thị các API glance.wear.health.DataType trong Tiện ích Wear. Nhà phát triển có thể dùng các API này để truy cập vào dữ liệu về tình trạng hệ thống.

Sửa lỗi

• Khắc phục vòng lặp sự cố xảy ra trong phiên bản alpha09 trên trình mô phỏng Wear 7 hoặc các thiết bị chạy trình kết xuất 1.6 bằng cách không cho phép gửi trục phông chữ trống đến Trình phát cho Tiện ích Wear Glance.

Phiên bản 1.0.0-alpha09

Ngày 6 tháng 5 năm 2026

Phát hành androidx.glance.wear:wear:1.0.0-alpha09 và androidx.glance.wear:wear-core:1.0.0-alpha09. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.

Thay đổi về API

• Chúng tôi đã thêm ExperimentalGlanceWearApi. Tham số này sẽ được dùng cho các tính năng Glance Wear thử nghiệm. (Id2f76, b/498179813)

Sửa lỗi

• Đã cập nhật trình phân tích cú pháp cho siêu dữ liệu XML của Tiện ích Wear để nhận biết các tiện ích trong quá trình khởi động.

Phiên bản 1.0.0-alpha08

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha08 và androidx.glance.wear:wear-core:1.0.0-alpha08. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.

Sửa lỗi

• Đã thêm thẻ <queries> vào tệp kê khai của thư viện glance:wear:wear để đảm bảo PackageManager truy vấn đúng các dịch vụ để nhận thông báo đẩy. (I192787)

Khác

• Đã hoàn nguyên "Updates Compose compileSdk to 37" (I6007) (Cập nhật Compose compileSdk lên 37) cũng áp dụng cho glance-wear, nên yêu cầu compileSdk không còn là 37 trong bản phát hành này.

Phiên bản 1.0.0-alpha07

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

Phát hành androidx.glance.wear:wear:1.0.0-alpha07 và androidx.glance.wear:wear-core:1.0.0-alpha07. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.

Tính năng mới

• Thêm nền mặc định cho Tiện ích Wear khi WearWidgetBrush trống hoặc không được chỉ định. (I8300b)
• Cập nhật API getActiveWidgets để trả về Loại vùng chứa của Tiện ích. (2772eb1)

Thay đổi về API

• Thay đổi API cập nhật Tiện ích để lấy WidgetInstanceId và thêm trình trợ giúp để tìm nạp mã nhận dạng cho một tiện ích nhất định. API mới sẽ gửi IllegalArgumentException nếu mã nhận dạng được cung cấp không hợp lệ hoặc không thuộc quyền sở hữu của phương thức gọi. (I6f3c5, b/446828899)
• Thêm dải chuyển màu dọc và ngang trong WearWidgetBrush. (If70ae, b/470080675)

Phiên bản 1.0.0-alpha06

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

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

Tính năng mới

• Xác định các thao tác cho hồ sơ Tiện ích Wear theo dòng.

Thay đổi về API

• Chúng tôi đã đổi tên CONTAINER_TYPE_FULLSCREEN thành CONTAINER_TYPE_TILE_COMPAT để phân biệt rõ hơn tiện ích tương thích ở chế độ toàn màn hình. Trong đó có việc chuyển đổi ngược kiểu FULLSCREEN trước đó thành LARGE trong các tham số của Tiện ích.

Phiên bản 1.0.0-alpha05

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

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

Thay đổi về API

• Chúng tôi đã thêm WearWidgetBrushAPI bằng phương thức color để dùng cho nền của Tiện ích Wear. (I66f54, b/464273091)
• Phương thức fetchActiveWidgetsForProvider đã bị xoá vì đã có fetchActiveWidgets. (I85e4e, b/486197890)

Phiên bản 1.0.0-alpha04

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

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

Thay đổi về API

• Thêm API GlanceWearWidgetManager để cho phép Các ứng dụng truy vấn các tiện ích và ô đang hoạt động của chúng. (I5be95)
• Chúng tôi đã di chuyển các API từ thư viện glance:wear:wear-core vào gói androidx.glance.wear.core. (I429cf)

Sửa lỗi

• Hiển thị các loại Thành phần kết hợp từ xa và Đối tượng sửa đổi phổ biến (Id1d40)

Phiên bản 1.0.0-alpha03

Ngày 11 tháng 2 năm 2026

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

Thay đổi về API

• Thêm tính năng hỗ trợ cho Sự kiện tương tác vào GlanceWearWidget. (Ia4e28, b/469808447)

Phiên bản 1.0.0-alpha02

Ngày 28 tháng 1 năm 2026

Phát hành androidx.glance.wear:wear:1.0.0-alpha02 và androidx.glance.wear:wear-core: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

• Ánh xạ lại FULLSCREEN thành LARGE trong các tham số Tiện ích (ad78d95)

Sửa lỗi

• Đã khắc phục việc sử dụng DataStore khiến nhiều phiên bản tiện ích không hiển thị được (474f3e4)

Phiên bản 1.0.0-alpha01

Ngày 14 tháng 1 năm 2026

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

• Glance Wear là một thư viện để tạo Tiện ích cho Wear OS bằng RemoteCompose.