Glance Wear

  
Glance Wear là một thư viện để tạo Tiện ích cho Wear OS
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 17 tháng 6 năm 2026 - - - 1.0.0-alpha12

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:

Groovy

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

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

Kotlin

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

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

Để 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-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à phải được dùng trên GlanceWearWidgetService để cung cấp phương thức triển khai GlanceWearWidget mà nó đượ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 đã ra mắt hàm trợ giúp @Composable, WearWidgetPreview, để đơn giản hoá quá trình phát triển tiện ích Glance Wear bằng cách loại bỏ mã soạn sẵn 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ủ hay không. (I5999d, b/514641567)
  • Hiển thị các toán tử so sánh RemoteInt. (I5fe3d, b/513228889)
  • Hiển thị API Luồng captureRemoteDocument 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 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 tôi đã 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ẻ liên quan có hợp lệ và có sẵn 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ả 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 lỗi 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 sức khoẻ 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 Glance Wear.

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 sẽ được dùng cho các tính năng thử nghiệm của Glance Wear. (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 các dịch vụ chính xác cho bản cập nhật đẩy. (I192787)

Khác

  • Đã hoàn nguyên "Cập nhật Compose compileSdk thành 37" (I6007) cũng áp dụng cho glance-wear, vì vậy, 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 hình 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 sở hữu của trình gọi. (I6f3c5, b/446828899)
  • Thêm độ dốc 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 nội tuyến.

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 với toàn màn hình. Điều này bao gồm việc hoàn nguyên quá trình ánh xạ loại FULLSCREEN trước đó thành LARGE trong các tham số 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 API WearWidgetBrush bằng phương thức color để dùng cho hình nền 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 Ứng dụng truy vấn các tiện ích và thẻ thông tin đang hoạt độ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 Trình sửa đổi và Thành phần kết hợp từ xa 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 có thể ngăn hiển thị nhiều thực thể tiện ích (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.