Glance Wear

  
Glance Wear เป็นไลบรารีสำหรับสร้างวิดเจ็ตสำหรับ Wear OS
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
26 สิงหาคม 2026 - - - 1.0.0-alpha17

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ใน glance-wear คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle ของแอปหรือโมดูล

ดึงดูด

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

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

Kotlin

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากร Dependency ได้ที่หัวข้อเพิ่มทรัพยากร Dependency ในการสร้าง

ความคิดเห็น

ความคิดเห็นของคุณช่วยให้ Jetpack ดีขึ้น โปรดแจ้งให้เราทราบหากพบปัญหาใหม่ๆ หรือมีไอเดียในการปรับปรุงไลบรารีนี้ โปรดดู ปัญหาที่มีอยู่แล้ว ในไลบรารีนี้ก่อนสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่แล้วได้โดยคลิกปุ่มรูปดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของIssue Tracker

Glance Wear เวอร์ชัน 1.0

เวอร์ชัน 1.0.0-alpha17

26 สิงหาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17 แล้ว เวอร์ชัน 1.0.0-alpha17 มี คอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มการตรวจสอบ Lint ใน Glance Wear เพื่อบังคับใช้ว่า <container> แต่ละรายการใน XML <wearwidget-provider> สำหรับข้อมูลเมตาของวิดเจ็ตต้องระบุแอตทริบิวต์ `type` ที่รองรับอย่างชัดเจนและไม่กำหนดประเภทที่ซ้ำกัน (I52c9a, b/464458215)

เวอร์ชัน 1.0.0-alpha16

12 สิงหาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16 แล้ว เวอร์ชัน 1.0.0-alpha16 มี คอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มการตรวจสอบ Lint สำหรับข้อมูลเมตา XML ของ <wearwidget-provider> เพื่อให้แน่ใจว่ามีองค์ประกอบการกำหนดค่าที่จำเป็น (เช่น container และ previewImage) (Ia9983, b/464458215)
  • เพิ่มคำเตือนข้อผิดพลาด Lint สำหรับการตั้งค่าพื้นหลังสีดำหรือโปร่งใสให้กับวิดเจ็ต Wear (Idedb0, b/529269573)
  • เปิดใช้การดำเนินการ Remote Compose ของ CORE_TEXT สำหรับโปรไฟล์วิดเจ็ต Wear ซึ่งจะช่วยให้ RemoteText ใช้ฟีเจอร์ของฟอนต์แบบแปรผัน เช่น แกนฟอนต์ ความสูงของบรรทัด เป็นต้น ในโปรแกรมแสดงผลโฮสต์ที่รองรับ โดยจะมีการเปลี่ยนไปใช้ฟอนต์สำรองโดยอัตโนมัติเมื่อไม่รองรับ

การแก้ไข

  • อัปเดต KDoc สำหรับคำอธิบายประกอบ AssociateWithGlanceWearWidget ตามความคิดเห็นของนักพัฒนาแอป

เวอร์ชัน 1.0.0-alpha15

29 กรกฎาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15 แล้ว เวอร์ชัน 1.0.0-alpha15 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มคำเตือน Lint เมื่อตั้งค่าพื้นหลังว่างเปล่าให้กับเอกสารวิดเจ็ต Wear (Ic6475, b/529269573)

เวอร์ชัน 1.0.0-alpha14

15 กรกฎาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14 แล้ว เวอร์ชัน 1.0.0-alpha14 มี คอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เราได้เพิ่มผู้ให้บริการพารามิเตอร์การแสดงตัวอย่าง RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams และ RoundLargeWidgetPreviewParams สำหรับวิดเจ็ต Glance Wear ที่โค้งมนทั้งหมด (If5336, b/512405233)

ฟีเจอร์ใหม่

  • เราได้ตั้งค่าและเพิ่มไลบรารี Linter สำหรับวิดเจ็ต Glance Wear (If4218, b/527402079)
    • เพิ่มการตรวจสอบ Lint เพื่อให้แน่ใจว่าคลาสย่อยของ GlanceWearWidgetService จะประกาศคลาสวิดเจ็ตที่เชื่อมโยงอย่างชัดเจนโดยใช้คำอธิบายประกอบ @AssociateWithGlanceWearWidget (Idc575, b/477024153)
  • เราได้ปรับปรุงความเข้ากันได้แบบย้อนกลับสำหรับวิดเจ็ตที่ทำงานบนโฮสต์เวอร์ชันเก่าโดยการเผยแพร่การดำเนินการที่รองรับผ่าน WearWidgetParams และเพิ่มการกรองโปรไฟล์ของการดำเนินการที่อนุญาต (Ib0a1b, I83cb1, [b/526716195])

เวอร์ชัน 1.0.0-alpha13

1 กรกฎาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13 แล้ว เวอร์ชัน 1.0.0-alpha13 มี คอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • นำการตรวจสอบสิทธิ์ออกจาก heartRateAccuracy (I14269, b/522444636)

การแก้ไขข้อบกพร่อง

  • เราได้ปรับพารามิเตอร์ของวิดเจ็ต Wear ที่มีรูปร่างสี่เหลี่ยมจัตุรัสขอบมนสำหรับการแสดงตัวอย่างตามความคิดเห็นเกี่ยวกับ UX

เวอร์ชัน 1.0.0-alpha12

17 มิถุนายน 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12 แล้ว เวอร์ชัน 1.0.0-alpha12 มี คอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่ม AssociateWithGlanceWearWidget ซึ่ง ต้อง ใช้ใน GlanceWearWidgetService เพื่อระบุการใช้งาน GlanceWearWidget ที่เชื่อมโยง (Ifcabb, b/514679763)

    • เช่น
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • เราได้เพิ่ม image brush ลงใน WearWidgetBrush เพื่อรองรับพื้นหลังบิตแมปในวิดเจ็ต Wear (I9a228, b/513481558)

  • เราได้เปิดตัวฟังก์ชันตัวช่วย @Composable ชื่อ WearWidgetPreview เพื่อลดความซับซ้อนในการพัฒนาวิดเจ็ต Glance Wear โดยนำโค้ดเริ่มต้นที่จำเป็นสำหรับการแสดงตัวอย่างใน IDE ออก

การเปลี่ยนแปลง API

  • เปลี่ยนชื่อ androidx.glance.wear.health.DataType เป็น androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
  • เปิดเผย isHeartRateBpmAvailable เพื่อกำหนดว่า heartRateBpm พร้อมใช้งานในโฮสต์หรือไม่ (I5999d, b/514641567)
  • เปิดเผยโอเปอเรเตอร์เปรียบเทียบ RemoteInt (I5fe3d, b/513228889)
  • เปิดเผย Flow API captureRemoteDocument และการโอเวอร์โหลด captureSingleRemoteDocument ใหม่ (ซึ่งใช้ RemoteCreationDisplayInfo) เป็น API สาธารณะ (I87b0e, b/513228889)
  • เราได้เพิ่ม @CallSuper ลงในเมธอดวงจรการทำงานของ GlanceWearWidgetService

เวอร์ชัน 1.0.0-alpha11

3 มิถุนายน 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11 แล้ว เวอร์ชัน 1.0.0-alpha11 มี คอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เราได้เพิ่ม WearWidgetPreview สำหรับแสดงตัวอย่างวิดเจ็ต Wear ใน Android Studio (I36504, b/485147770)
  • เปิดเผยตัวแปร is*Available (isDailyStepsAvailable เป็นต้น) เพื่อยืนยันว่าประเภทข้อมูลสุขภาพที่เกี่ยวข้องพร้อมใช้งานและถูกต้องหรือไม่ (Ib98a7, b/498179656)
  • เพิ่ม triggerUpdateAll API ลงใน GlanceWearWidget เพื่อทริกเกอร์การอัปเดตในวิดเจ็ตทั้งหมดของแอปที่กำหนด (I6ab20, b/510896410)

การแก้ไขข้อบกพร่อง

  • รวมข้อมูลเวอร์ชันของ Renderer ใน WearWidgetParams เป็นฟิลด์ภายในเพื่อป้องกันไม่ให้เอกสารที่สร้างด้วยเวอร์ชัน alpha10 เสียหาย (Idcf8e, b/511263591, b/512830184)
  • ทริกเกอร์โฟลว์การอัปเดตแบบบังคับดึงในโหมดแก้ไขข้อบกพร่องหรือโปรแกรมจำลองสำหรับวิดเจ็ต Wear

เวอร์ชัน 1.0.0-alpha10

19 พฤษภาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10 แล้ว เวอร์ชัน 1.0.0-alpha10 มี คอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เปิดเผย API glance.wear.health.DataType ในวิดเจ็ต Wear นักพัฒนาแอปสามารถใช้ API เหล่านี้เพื่อเข้าถึงข้อมูลสุขภาพของระบบ

การแก้ไขข้อบกพร่อง

  • แก้ไขการวนซ้ำของการขัดข้องที่เกิดขึ้นในเวอร์ชัน alpha09 ในโปรแกรมจำลอง Wear 7 หรืออุปกรณ์ที่ใช้ Renderer 1.6 โดยไม่อนุญาตให้ส่งแกนฟอนต์ว่างเปล่าไปยัง Player สำหรับวิดเจ็ต Glance Wear

เวอร์ชัน 1.0.0-alpha09

6 พฤษภาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha09 และ androidx.glance.wear:wear-core:1.0.0-alpha09 แล้ว เวอร์ชัน 1.0.0-alpha09 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เราได้เพิ่ม ExperimentalGlanceWearApi ซึ่งจะใช้สำหรับฟีเจอร์ Glance Wear เวอร์ชันทดลอง (Id2f76, b/498179813)

การแก้ไขข้อบกพร่อง

  • อัปเดตตัวแยกวิเคราะห์สำหรับข้อมูลเมตา XML ของวิดเจ็ต Wear เพื่อให้รู้จักวิดเจ็ตระหว่างการบูต

เวอร์ชัน 1.0.0-alpha08

22 เมษายน 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha08 และ androidx.glance.wear:wear-core:1.0.0-alpha08 แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตเหล่านี้

การแก้ไขข้อบกพร่อง

  • เพิ่มแท็ก <queries> ลงในไฟล์ Manifest ของไลบรารี glance:wear:wear เพื่อให้แน่ใจว่า PackageManager จะค้นหาบริการที่ถูกต้องสำหรับการอัปเดตแบบพุช (I192787)

อื่นๆ

  • เปลี่ยนกลับ "อัปเดต Compose compileSdk เป็น 37" (I6007) ซึ่งใช้กับ glance-wear ด้วย ดังนั้นข้อกำหนด compileSdk จึงไม่ใช่ 37 อีกต่อไปในรุ่นนี้

เวอร์ชัน 1.0.0-alpha07

8 เมษายน 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha07 และ androidx.glance.wear:wear-core:1.0.0-alpha07 แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่มพื้นหลังเริ่มต้นของวิดเจ็ต Wear เมื่อ WearWidgetBrush ว่างเปล่าหรือไม่ได้ระบุ (I8300b)
  • อัปเดต API getActiveWidgets เพื่อแสดงผลประเภทคอนเทนเนอร์ของวิดเจ็ต (2772eb1)

การเปลี่ยนแปลง API

  • เปลี่ยน API การอัปเดตวิดเจ็ตให้ใช้ WidgetInstanceId และเพิ่มตัวช่วยสำหรับการดึงข้อมูลรหัสของวิดเจ็ตที่กำหนด API ใหม่จะแสดง IllegalArgumentException หากรหัสที่ระบุไม่ถูกต้องหรือไม่ได้เป็นของผู้เรียก (I6f3c5, b/446828899)
  • เพิ่มการไล่ระดับสีแนวตั้งและแนวนอนใน WearWidgetBrush (If70ae, b/470080675)

เวอร์ชัน 1.0.0-alpha06

25 มีนาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha06 และ androidx.glance.wear:wear-core:1.0.0-alpha06 แล้ว เวอร์ชัน 1.0.0-alpha06 มี คอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • กำหนดการดำเนินการสำหรับโปรไฟล์วิดเจ็ต Wear แบบอินไลน์

การเปลี่ยนแปลง API

  • เราได้เปลี่ยนชื่อ CONTAINER_TYPE_FULLSCREEN เป็น CONTAINER_TYPE_TILE_COMPAT เพื่อแยกความแตกต่างของวิดเจ็ตที่เข้ากันได้กับแบบเต็มหน้าจอได้ดียิ่งขึ้น ซึ่งรวมถึงการเปลี่ยนกลับการแมปประเภท FULLSCREEN ก่อนหน้านี้เป็น LARGE ในพารามิเตอร์ของวิดเจ็ต

เวอร์ชัน 1.0.0-alpha05

11 มีนาคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha05 และ androidx.glance.wear:wear-core:1.0.0-alpha05 แล้ว เวอร์ชัน 1.0.0-alpha05 มี คอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เราได้เพิ่ม API WearWidgetBrush พร้อมเมธอด color เพื่อใช้สำหรับพื้นหลังของวิดเจ็ต Wear (I66f54, b/464273091)
  • นำเมธอด fetchActiveWidgetsForProvider ออกแล้วเนื่องจากมี fetchActiveWidgets อยู่แล้ว (I85e4e, b/486197890)

เวอร์ชัน 1.0.0-alpha04

25 กุมภาพันธ์ 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha04 และ androidx.glance.wear:wear-core:1.0.0-alpha04 แล้ว เวอร์ชัน 1.0.0-alpha04 มีคอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่ม API GlanceWearWidgetManager เพื่อให้แอปค้นหาวิดเจ็ตและการ์ดที่ใช้งานอยู่ได้ (I5be95)
  • เราได้ย้าย API จากไลบรารี glance:wear:wear-core ไปยังแพ็กเกจ androidx.glance.wear.core (I429cf)

การแก้ไขข้อบกพร่อง

  • เปิดเผยประเภท Remote Composable และ Modifier ทั่วไป (Id1d40)

เวอร์ชัน 1.0.0-alpha03

11 กุมภาพันธ์ 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha03 และ androidx.glance.wear:wear-core:1.0.0-alpha03 แล้ว เวอร์ชัน 1.0.0-alpha03 มี คอมมิตเหล่านี้

การเปลี่ยนแปลง API

  • เพิ่มการรองรับเหตุการณ์การโต้ตอบลงใน GlanceWearWidget (Ia4e28, b/469808447)

เวอร์ชัน 1.0.0-alpha02

28 มกราคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha02 และ androidx.glance.wear:wear-core:1.0.0-alpha02 แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เปลี่ยนการแมป FULLSCREEN เป็น LARGE ในพารามิเตอร์ของวิดเจ็ต (ad78d95)

การแก้ไขข้อบกพร่อง

  • แก้ไขการใช้งาน DataStore ที่จะป้องกันไม่ให้แสดงอินสแตนซ์วิดเจ็ตหลายรายการ (474f3e4)

เวอร์ชัน 1.0.0-alpha01

14 มกราคม 2026

เผยแพร่ androidx.glance.wear:wear:1.0.0-alpha01 และ androidx.glance.wear:wear-core:1.0.0-alpha01 แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้

  • Glance Wear เป็นไลบรารีสำหรับสร้างวิดเจ็ตสำหรับ Wear OS โดยใช้ RemoteCompose