Glance Wear

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

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

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

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

ดึงดูด

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

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

Kotlin

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพาบิลด์

ความคิดเห็น

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

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

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

Glance Wear เวอร์ชัน 1.0

เวอร์ชัน 1.0.0-alpha19

23 กันยายน 2026

androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19 จะเปิดตัว เวอร์ชัน 1.0.0-alpha19 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลงการทดสอบภายในเท่านั้น

เวอร์ชัน 1.0.0-alpha18

9 กันยายน 2026

androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 และ androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18 จะเปิดตัว เวอร์ชัน 1.0.0-alpha18 มีการคอมมิตเหล่านี้

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

  • เพิ่มพารามิเตอร์ useSafeFallbackRendererVersion ลงใน WearWidgetPreview เพื่ออนุญาตให้แสดงตัวอย่างวิดเจ็ตด้วยชุดการดำเนินการสำรองที่ปลอดภัยซึ่งรองรับโฮสต์รุ่นเก่า (I9c324)

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

  • compileSdk สำหรับไลบรารี Compose ที่อัปเดตเป็น 37.1 ซึ่งจะต้องอัปเดต compileSdk สำหรับแอปและไลบรารีทั้งหมดที่ใช้ Compose (I05b0f)
  • เพิ่มการตรวจสอบ Lint เพื่อเตือนการใช้พารามิเตอร์ fontFamily ที่ซ้ำซ้อนในวิดเจ็ต Wear (I7730c)

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

การแก้ไข

  • อัปเดต KDocs สำหรับ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แปรง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)
  • เปิดตัว captureRemoteDocument Flow API และ 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)

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

  • ใส่ข้อมูลเวอร์ชันของโปรแกรมแสดงผลใน 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 หรืออุปกรณ์ที่ใช้ตัวแสดงผล 1.6 โดยไม่อนุญาตให้ส่งแกนแบบอักษรที่ว่างเปล่าไปยังเพลเยอร์สำหรับวิดเจ็ต 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)

อื่นๆ

  • เปลี่ยนกลับ "อัปเดต compileSdk ของ Compose เป็น 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)
  • อัปเดต getActiveWidgets API เพื่อแสดงผลประเภทคอนเทนเนอร์ของวิดเจ็ต (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

  • เราได้เพิ่ม WearWidgetBrushAPI ที่มีเมธอด 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

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

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

  • เปิดเผยประเภท Composable และ Modifier ทั่วไปของ Remote (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