บันทึกประจำรุ่นของ Wear OS

หน้านี้มีข้อมูลเกี่ยวกับรุ่นของ Wear OS เช่น SDK ที่สวมใส่ได้ และไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้

SDK ที่สวมใส่ได้เวอร์ชัน 18.1.0 2023-31 สิงหาคม 2023

SDK ที่สวมใส่ได้เวอร์ชัน 18.1.0 มีการอัปเดต API เล็กน้อยเพื่อรองรับ รุ่นไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ การอัปเดตมีดังนี้

  • การสนับสนุนการเปลี่ยนโทรศัพท์ โปรดดู NodeClient.OnNodeMigratedListener เพื่อดูรายละเอียดเพิ่มเติม
  • เอกสารเพิ่มเติมสำหรับ MessageClient ส่งและตอบข้อความ
  • ลิงก์ที่อัปเดตในคำอธิบาย API

SDK ที่สวมใส่ได้เวอร์ชัน 18.0.0 ปี 2022 - กันยายน 2020

SDK ที่สวมใส่ได้เวอร์ชัน 18.0.0 มีการอัปเดต API เล็กน้อยเพื่อรองรับ รุ่นไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ การอัปเดตมีดังนี้

  • รองรับ WearableListenerService สำหรับแอปที่กำหนดเป้าหมายเป็น Android 13 - ปัญหา 235538840
  • เมธอด MessageClient.sendRequest() ใหม่

16 กุมภาพันธ์ 2022 ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.9.0

เวอร์ชัน 2.9.0 ของไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้จะเลิกใช้งานชั้นเรียนที่เหลืออยู่ทั้งหมด ใช้ไลบรารี Wear OS Jetpack แทน

ไลบรารี Wear OS Jetpack 2021-29 ตุลาคม

ไลบรารี Wear OS Jetpack ทดแทนสำหรับไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ และไม่ได้ออกแบบมาเพื่อใช้งาน ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ใช้กับ Wear OS 3 ไม่ได้

SDK ที่สวมใส่ได้เวอร์ชัน 17.1.0 เม.ย. 2021 - 27 เมษายน

SDK ที่สวมใส่ได้เวอร์ชัน 17.1.0 มีการอัปเดต API เล็กน้อยเพื่อรองรับ รุ่นไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.8.1 วันที่ 28 กันยายน 2020

เวอร์ชัน 2.8.1 ของไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้มีการเปลี่ยนแปลงดังต่อไปนี้

อนุญาตให้ปิดใช้ Jetifier เมื่อใช้เทมเพลตหน้าปัด

ตอนนี้เทมเพลตหน้าปัดของ Android Studio จะใช้ทรัพยากร Dependency ของ AndroidX เพื่ออนุญาต ปิดใช้ Jetifier แล้ว การแก้ไขเหล่านี้จะมีผลเมื่อใช้เทมเพลตหน้าปัด พร้อม Android Studio 4.2 ขึ้นไป

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.8.0 ปี 2020 - กันยายน 2024

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.8.0 มีการเปลี่ยนแปลงต่อไปนี้

ความสามารถในการสำรองสำหรับการระบุผู้ให้บริการข้อมูลแทรกเริ่มต้นที่ไม่ใช่ระบบ

ตอนนี้หน้าปัดสามารถใช้ setDefaultComplicationProviderWithFallbacks เพื่อระบุได้แล้ว ผู้ให้บริการข้อมูลแทรกที่ไม่ใช่ระบบอย่างน้อย 1 รายที่จะใช้โดยค่าเริ่มต้น หากไม่มี ได้ติดตั้งผู้ให้บริการที่ไม่ใช่ระบบที่ระบุแล้ว ระบบจะกลับไปใช้ โดยใช้ผู้ให้บริการระบบเริ่มต้น

เลิกใช้งาน WearableActivity แล้ว

WearableActivity เลิกใช้งานแล้ว ใช้ AmbientModeSupport แทน

เลิกใช้งาน SKIP_CONFIRMATION_UI แล้ว

ActionConfirmationActivity.SKIP_CONFIRMATION_UI เลิกใช้งานแล้ว ส่วนเพิ่มเติมนี้ไม่มีการใช้งานตั้งแต่เปิดตัว Wear 2.0

15 พฤษภาคม 2020 ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.7.0

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.7.0 ประกอบด้วยรายการต่อไปนี้

การยอมรับฮาร์ดแวร์สำหรับหน้าปัด

ขณะนี้คุณสามารถขอ Canvas ที่เร่งการแสดงผลด้วยฮาร์ดแวร์ได้เมื่อใช้ CanvasWatchFaceService ชั้นเรียน ใช้ประโยชน์จากการเร่งฮาร์ดแวร์ ปรับปรุงประสิทธิภาพของหน้าปัดและเข้าถึงประสิทธิภาพ UI เพิ่มเติม

ดูข้อมูลเพิ่มเติมได้ที่ปรับปรุงประสิทธิภาพของหน้าปัดด้วยฮาร์ดแวร์ การเร่งความเร็ว

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.6.0 2020-เมษายน 2020

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.6.0 ประกอบด้วยรายการต่อไปนี้ ของคุณ

การย้ายข้อมูลไปยัง Android Jetpack

เราได้ย้ายข้อมูลไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ไปยัง Android Jetpack แล้ว ขณะนี้ไลบรารีที่มีอยู่ได้รับการแมปและเข้าถึงได้ใน AndroidX ใช้เนมสเปซ androidx และการขึ้นต่อกันทั้งหมดในการสนับสนุนที่เลิกใช้งานแล้ว คลังมี ถูกนำออกแล้ว

การเปลี่ยนแปลงนี้ยังทำให้คุณสามารถใช้ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ใน Android ด้วย Studio 4.0 ขึ้นไป ซึ่งแก้ไขปัญหาต่างๆ เช่น ปัญหา #147972079

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.5.0 2019-28 สิงหาคม 2019

ไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชัน 2.5.0 ประกอบด้วยรายการต่อไปนี้ ของคุณ

แก้ไข ComplicationDrawable เมื่อมีการเรียกใช้ startActivity() ด้วยประเภทข้อมูลแทรก TYPE_NO_PERMISSION

ComplicationDrawable ตอนนี้มีแฟล็ก NEW_TASK ซึ่งช่วยให้แน่ใจว่า startActivity() จะเรียก มาจาก WatchFaceService รวม FLAG_ACTIVITY_NEW_TASK เพื่อหลีกเลี่ยง android.util.AndroidRuntimeException

การเปลี่ยนแปลงนี้จะทำให้ TYPE_NO_PERMISSION ประเภทข้อมูลแทรกเปิดใช้งานกิจกรรมคำขอสิทธิ์อย่างถูกต้อง หน้าปัดขัดข้อง

SDK ที่สวมใส่ได้เวอร์ชัน 16.0.0 ปี 2018 - กันยายน 2020

SDK ที่สวมใส่ได้เวอร์ชัน 16.0.0 ได้ลดเวอร์ชันที่จำเป็นของบริการ Google Play จากเวอร์ชัน 12.4 เป็นเวอร์ชัน 8.6 การเปลี่ยนแปลงนี้จะทำให้แอปที่มีอยู่อัปเดตเป็นอุปกรณ์ที่สวมใส่ได้เวอร์ชันล่าสุด SDK โดยไม่ต้องอัปเดต APK บริการ Google Play

การอัปเดตวันที่ 11 มิถุนายน 2018 สำหรับ Wear OS เวอร์ชันตัวอย่าง 2 สำหรับนักพัฒนาซอฟต์แวร์

ผ่านอากาศ (OTA) ล่าสุด การอัปเดตเป็น Wear OS Developer Preview 2 มี เปิดใช้การปลุกและงานอีกครั้งสำหรับแอปที่ทำงานอยู่เบื้องหลัง

แม้ว่าการเปลี่ยนแปลงนโยบายนี้จะสนับสนุนความยืดหยุ่นที่เพิ่มขึ้นในการพัฒนาแอป การปลุกเมื่ออยู่เบื้องหลัง และ งานจะยังคงอยู่ภายใต้ข้อจำกัดอื่นๆ ของ Android P รวมถึงงานที่เกี่ยวข้องกับ ที่เก็บข้อมูลสแตนด์บายแอป ทำตาม แนวทางปฏิบัติแนะนำเพื่อดูแลให้แอปทำงานได้อย่างดี ไม่ว่าแอปจะอยู่ในสถานะใด

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

ตัวอย่าง 2 สำหรับนักพัฒนาซอฟต์แวร์ Wear OS - 8 พฤษภาคม 2018

Wear OS Developer Preview 2 มีฟีเจอร์ต่างๆ เช่น ประสบการณ์การใช้งาน Google Assistant ที่ปรับปรุงใหม่

ส่งข้อบกพร่องหรือความคิดเห็นโดยใช้ เครื่องมือติดตามปัญหา Wear OS by Google ยิ่งคุณส่งฟอร์มเร็วเท่าไร แนวโน้มที่การแก้ไขจะรวมอยู่ในรุ่นสุดท้าย

ปัญหาที่ทราบ

ส่วนนี้ประกอบด้วยปัญหาที่ทราบสำหรับเวอร์ชันตัวอย่าง 2

ปัญหาเกี่ยวกับรูปภาพ Wear OS

  • เมื่อคุณอยู่ในแอปใดก็ตามและกดปุ่ม ปุ่มเปิด/ปิดที่ด้านข้างของนาฬิกา ระบบอาจนำคุณกลับไปยัง แทนที่จะเป็นหน้าปัด

ปัญหาสำหรับรูปภาพ Wear OS สำหรับประเทศจีน

  • เมื่อคุณอยู่ในแอปใดก็ตามและกดปุ่ม ปุ่มเปิด/ปิดที่ด้านข้างของนาฬิกา ระบบอาจนำคุณกลับไปยัง แทนที่จะเป็นหน้าปัด
  • การตั้งค่าเสียงที่เกี่ยวข้องกับระดับเสียงไม่ได้ อยู่ ตัวอย่างเช่น เมื่อมีสายเรียกเข้าจะส่งเสียงเตือนบนนาฬิกา หากเสียงในนาฬิกาตั้งค่าเป็นปิด และถ้าคุณปรับระดับเสียงปลุก การเปลี่ยนแปลงนั้นจะไม่มีผลใดๆ
  • การแจ้งเตือนต่อเนื่องหลายรายการอาจแสดงไม่ถูกต้อง ตัวอย่างเช่น หากตั้งค่าตัวตั้งเวลาและนาฬิกาจับเวลาไว้ ไม่แสดง เราขอแนะนำให้คุณทดสอบ แอปที่มีการแจ้งเตือนต่อเนื่อง 1 รายการ แทนที่จะเป็นมากกว่า 1 รายการ
  • App Store ของ Wear ในเวอร์ชันจีน ไม่ได้ นักพัฒนาแอปจะอัปเดตหรือติดตั้งแอปใหม่โดยใช้แอปดังกล่าวไม่ได้ เราขอแนะนำให้ใช้ "adb" เป็นวิธีแก้ปัญหาชั่วคราวสำหรับการโหลดแอปพลิเคชันจากแหล่งที่ไม่รู้จัก เพื่อการทดสอบ

ปัญหาเกี่ยวกับโปรแกรมจำลอง Wear

  • สายเรียกเข้าไปยังโทรศัพท์ที่ใช้ร่วมกัน ไม่แสดงหรือ _mirrored_ เป็นสายเรียกเข้าในโปรแกรมจำลองที่จับคู่
  • เมื่อคุณใช้เครื่องมือจัดการ SDK เพื่อติดตั้งหรือยืนยันว่าคุณมี สำหรับการติดตั้ง Android P หรือเวอร์ชันจีน แล้วเลือกช่องทำเครื่องหมายข้างการติดตั้ง การเลือกอาจยกเลิกการเลือกหลังจากที่คุณเลือกไว้ หาก ยกเลิกการเลือกแล้ว ให้เลือกเป็นครั้งที่สอง
  • เมื่อโปรแกรมจำลองดำเนินการ Cold Boot ระบบอาจแสดงข้อผิดพลาดต่อไปนี้ "เกิดปัญหาภายใน อุปกรณ์ โปรดสอบถามรายละเอียดจากผู้ผลิต" การดำเนินการนี้ไม่ส่งผลต่อ เลื่อนลงแล้วคลิกตกลงเพื่อเริ่มทดสอบแอป
  • การตอบกลับด้วยเสียงอาจไม่ทำงานในโปรแกรมจําลอง ตัวอย่างเช่น หากได้รับ การแจ้งเตือนสำหรับข้อความ Google Hangouts ในโปรแกรมจำลอง Wear และคุณพยายาม เพื่อตอบกลับข้อความด้วยเสียง จะมีข้อความ "Google หยุดอยู่ตลอดเวลา" ข้อความแสดงข้อผิดพลาด เกิดขึ้น และคุณไม่สามารถตอบกลับด้วยเสียงได้
  • การเรียกใช้ทันทีอาจไม่สามารถทำงานร่วมกับ โปรแกรมจำลอง Wear
  • การจับภาพหน้าจอแบบเป็นโปรแกรม เช่น การใช้ "adb" หรือการรายงานข้อบกพร่อง อาจไม่ทำงาน ในการแก้ปัญหาเฉพาะหน้า ให้คลิกปุ่มกล้องบนโปรแกรมจำลอง เพื่อจับภาพหน้าจอ

ปัญหาเกี่ยวกับโปรแกรมจำลอง Wear เวอร์ชันจีน

  • สายเรียกเข้าไปยังโทรศัพท์ที่ใช้ร่วมกันอาจไม่แสดง หรือ _mirrored_ เป็นสายเรียกเข้าในโปรแกรมจำลองที่จับคู่ไว้ การแจ้งเตือนสายที่ไม่ได้รับอาจ ไม่แสดงในโปรแกรมจำลอง นอกจากนี้ คุณอาจจะไม่สามารถตอบคำถาม จากโปรแกรมจำลอง ซึ่งในกรณีนี้การโทรจะยังคงส่งเสียงต่อไป
  • เมื่อคุณใช้เครื่องมือจัดการ SDK เพื่อติดตั้งหรือยืนยันว่าคุณมี สำหรับการติดตั้ง Android P หรือเวอร์ชันจีน แล้วเลือกช่องทำเครื่องหมายข้างการติดตั้ง การเลือกอาจยกเลิกการเลือกหลังจากที่คุณเลือกไว้ หาก ยกเลิกการเลือกแล้ว ให้เลือกเป็นครั้งที่สอง
  • เมื่อโปรแกรมจำลองดำเนินการ Cold Boot ระบบอาจแสดงข้อความว่า "เกิดปัญหาภายในกับ อุปกรณ์ โปรดสอบถามรายละเอียดจากผู้ผลิต" การดำเนินการนี้ไม่ส่งผลต่อ เลื่อนลงแล้วคลิกตกลงเพื่อเริ่มทดสอบแอป
  • การเรียกใช้ทันทีอาจไม่สามารถทำงานร่วมกับ โปรแกรมจำลอง Wear
  • การจับภาพหน้าจอแบบเป็นโปรแกรม เช่น การใช้ "adb" หรือโดยการถ่ายภาพ รายงานข้อบกพร่องอาจใช้ไม่ได้ ในการแก้ปัญหาเฉพาะหน้า ให้คลิกปุ่มกล้องบนโปรแกรมจำลอง เพื่อจับภาพหน้าจอ

Google Assistant ใน Wear

การสนับสนุนที่เพิ่มประสิทธิภาพสำหรับ Assistant ใน Wear OS ช่วยให้คุณสร้าง ประสบการณ์ที่สวมใส่ได้โดยไม่จำเป็นต้องเขียนโค้ด Android กล่าวอย่างเจาะจงก็คือ คุณสามารถ สร้างขึ้นสำหรับแพลตฟอร์ม Actions on Google และช่วยผู้ใช้ทำสิ่งต่างๆ ให้เสร็จ กับผลิตภัณฑ์และบริการของคุณ

นอกจากนี้ Wear OS ยังรองรับการโต้ตอบด้วยเสียงและการสัมผัสที่เร็วขึ้นอีกด้วย นอกจากนี้ ระบบยังรองรับชิปคำแนะนำด้วย โดยสามารถดำเนินการต่อไปนี้

  • ช่วยให้ผู้ใช้โต้ตอบเสร็จสมบูรณ์ได้อย่างรวดเร็ว
  • ให้คำแนะนำแก่ผู้ใช้เกี่ยวกับความสามารถของการดำเนินการของคุณ

นอกจากนี้ ตอนนี้ Wear OS ยังรองรับการ์ดภาพมากขึ้น รวมถึงรายการและ ภาพสไลด์

ดังนั้นคุณจึงใช้ DialogFlow ได้ templates หรือ Actions SDK เพื่อ สร้าง Actions on Google สำหรับ Wear OS นอกจากนี้ คุณยังใช้ประโยชน์จาก เทมเพลตการตอบกลับ สำหรับนาฬิกาโดยเฉพาะ แนวทางปฏิบัติแนะนำสำหรับการดำเนินการบน สิ่งที่ Google มีให้

  • กล่องโต้ตอบที่สั้นกระชับ
  • เปิดใช้การตอบสนองทั้งภาพและเสียง

การเพิ่มประสิทธิภาพเหล่านี้สำหรับ Assistant ใน Wear OS ไม่ได้ขึ้นอยู่กับ Android P และกำลังเปิดตัวแก่ผู้ใช้ Wear 2.0 ทุกคน สำหรับข้อมูลเบื้องต้นเกี่ยวกับการสร้าง Actions on Google โปรดดู ผสานรวมกับ Google Assistant

โหมดประหยัดแบตเตอรี่สำหรับนักพัฒนาซอฟต์แวร์ ตัวอย่าง 2

ฟีเจอร์ที่เกี่ยวข้องกับพลังงานจะพร้อมใช้งานเพื่อเพิ่มแบตเตอรี่ตามที่อธิบายไว้ในส่วนต่อไปนี้ ชีวิต ข้อมูลในส่วนการแสดงตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ 2 นี้ มีผลแทนข้อมูลเกี่ยวกับพลังงานสำหรับเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ 1.

โหมดใหม่: โหมดประหยัดแบตเตอรี่ที่ดียิ่งขึ้น

ขณะที่นาฬิกาอยู่ในโหมดประหยัดแบตเตอรี่ที่ปรับปรุงแล้ว ค่าเริ่มต้น การแสดงหน้าปัดที่มีการเพิ่มประสิทธิภาพ ทุกข้อต่อไปนี้เปิดอยู่ ปิด:

  • วิทยุ
  • หน้าจอสัมผัส
  • ฟีเจอร์เอียงเพื่อปลุกระบบ

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

จำกัดกิจกรรมในเบื้องหลัง

เพื่อปรับปรุงการจัดการพลังงาน แอปในเบื้องหลังจะเริ่มทํางานไม่ได้อีกต่อไป การปลุกและงาน เว้นแต่นาฬิกาจะอยู่บนที่ชาร์จ ข้อยกเว้นรวมถึงนาฬิกา ใบหน้าและภาวะแทรกซ้อนที่ทำงานอยู่

หมายเหตุ: หากแอปต้องทำงานเสมอ เช่น ในเบื้องหลัง เราขอแนะนำให้คุณใช้บริการที่ทำงานอยู่เบื้องหน้าโดยใช้ startForegroundService() วิธี ดูพื้นหลัง ข้อจำกัดของบริการ การใช้บริการที่ทำงานอยู่เบื้องหน้า เหมาะสำหรับ Use Case พิเศษ เช่น การเฝ้าระวังด้านสุขภาพ

ความเข้ากันได้ของแอปที่ปรับปรุงให้ดีขึ้น

Android P ได้เริ่มติดตั้งใช้งานแล้วเพื่อปรับปรุงความเข้ากันได้ของแอป ข้อจำกัดบางอย่าง เกี่ยวกับการใช้อินเทอร์เฟซที่ไม่ใช่ SDK วางแผนย้ายข้อมูลออก จากเมธอดและช่องที่ไม่ใช่ SDK หากไม่มีเนื้อหาที่เทียบเท่าแบบสาธารณะสำหรับ กรณีการใช้งาน โปรดแจ้งให้เราทราบ

ธีมระบบ UI สีเข้ม

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

Codelab ที่อัปเดตแล้วพร้อมให้บริการ

เรามี Codelab ที่อัปเดตแล้วเพื่อช่วยคุณหาวิธีสำคัญในการพัฒนาด้วย Wear OS สำหรับ ลองใช้ Codelab ของหน้าปัดใหม่ที่ใช้ Kotlin เพื่อ ด้วยภาษาเฉพาะโดเมน Kotlin หรือ DSL

ตัวอย่าง 1 สำหรับนักพัฒนาซอฟต์แวร์ Wear OS 2018-มีนาคม-27

ส่วนนี้ประกอบด้วยข้อมูลเกี่ยวกับ Wear OS by Google เวอร์ชันตัวอย่าง 1 สำหรับนักพัฒนาซอฟต์แวร์ การอัปเดตหลายอย่างสำหรับตัวอย่างนี้ ก่อนที่จะเปิดตัวเวอร์ชันที่ใช้งานจริง ส่งข้อบกพร่องที่คุณพบโดยใช้ เครื่องมือติดตามปัญหา Wear OS by Google ยิ่งคุณส่งฟอร์มเร็วเท่าไร ก็ยิ่งมีโอกาสมากขึ้นเท่านั้น เพื่อให้เรารวมการแก้ไขไว้ในรุ่นสุดท้ายได้

ปัญหาที่ทราบ

  • ในแอปที่ใช้ร่วมกับ Wear OS การแตะรายงานข้อบกพร่องของอุปกรณ์ที่สวมใส่ได้ดูเหมือนว่าจะใช้งานได้ แต่จะไม่มีการสร้างรายงานข้อบกพร่องขึ้นจริงๆ ให้ใช้ adb bugreport เป็นวิธีแก้ปัญหาเบื้องต้น
  • การรับโทรศัพท์โดยใช้นาฬิกาอาจไม่สำเร็จเสมอไป หากไม่สำเร็จ ผู้ใช้จะต้องรับสายจากโทรศัพท์โดยตรง
  • "ปัญหาที่ตรวจพบเกี่ยวกับความเข้ากันได้ของ API" ข้อผิดพลาด บางครั้งจะปรากฏขึ้นหลังจากจับคู่หรือเปิดแอปที่โหลดไว้ล่วงหน้า ข้อความแสดงข้อผิดพลาดดังกล่าวจะหายไปหลังจากผ่านไปไม่นานและจะไม่ส่งผลต่อความสามารถในการใช้งาน
  • ในเมนู "การตั้งค่า" บนนาฬิกาและในโปรแกรมจำลอง ตัวเลือกใช้รายงานข้อบกพร่องจะปรากฏขึ้น 2 ครั้ง ในการรับรายงานข้อบกพร่อง ให้ลองใช้ทั้ง 2 ตัวเลือก เพราะมีเพียงตัวเลือกเดียวที่ใช้ได้ เมื่อคุณแตะตัวเลือกฟังก์ชันการทำงาน ข้อความโทสต์จะปรากฏขึ้น ที่มีการสร้างรายงานข้อบกพร่อง
  • ในประเทศจีน การป้อนข้อมูลด้วยเสียงจะทำให้แอปขัดข้อง ตัวอย่างเช่น กรณีนี้จะเกิดขึ้น ด้วยการค้นหาด้วยเสียงหรือเมื่อคุณใช้ เสียงเพื่อเพิ่มการแจ้งเตือนเนื่องจากฟังก์ชันการทำงานนี้ ใช้ API การป้อนข้อมูลด้วยเสียง สำหรับการทดสอบ ให้ใช้แป้นพิมพ์หรือการป้อนข้อมูลด้วยลายมือแทนการป้อนข้อมูลด้วยเสียง
  • App Store ของ Wear ในจีนใช้งานไม่ได้ นักพัฒนาซอฟต์แวร์ ไม่สามารถอัปเดตหรือติดตั้งแอปใหม่โดยใช้ช่องทางดังกล่าว เราขอแนะนำให้ใช้ "adb" เป็นวิธีแก้ปัญหาชั่วคราวสำหรับการโหลดแอปพลิเคชันของคุณเพื่อทดสอบ

ไฮไลต์ในการแสดงตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์นี้

เวอร์ชันตัวอย่าง 1 สำหรับนักพัฒนาซอฟต์แวร์มีฟีเจอร์ต่อไปนี้สำหรับการทดสอบแอป

  • จำกัดกิจกรรมในเบื้องหลัง: เพื่อปรับปรุงการจัดการพลังงาน แอปใน จะใช้การปลุกและงานไม่ได้อีกต่อไป ข้อยกเว้นรวมถึงนาฬิกา ใบหน้าและข้อมูลแทรกที่ผู้ใช้เลือก เราจะเปิดตัวฟีเจอร์นี้ ในการแสดงตัวอย่างของนักพัฒนาซอฟต์แวร์ คุณจึงอาจไม่เห็นทันทีบน ดู

    หมายเหตุ หากแอปต้องทำงานตลอดเวลา ให้แก้ไขแอปให้เป็นเบื้องหน้า โดยใช้ startForegroundService() โปรดดู ข้อจำกัดของบริการที่ทำงานอยู่เบื้องหลัง เพื่อดูรายละเอียดเพิ่มเติม

  • ข้อจำกัดเกี่ยวกับแอป การใช้อินเทอร์เฟซที่ไม่ใช่ SDK: เพื่อปรับปรุงแอป Android P ได้เริ่มใช้ ข้อจำกัดในการใช้อินเทอร์เฟซที่ไม่ใช่ SDK วางแผนย้ายข้อมูลออกจากเมธอดและช่องที่ไม่ใช่ SDK หากไม่มีฟีเจอร์ที่เทียบเท่าแบบสาธารณะสำหรับ Use Case ของคุณ โปรดแจ้งให้เราทราบ
  • ธีมระบบ UI สีเข้ม: นับตั้งแต่ต้นปี 2018 Wear OS เปลี่ยนเป็นธีม UI เริ่มต้นที่มีพื้นหลังสีเข้มกว่าสำหรับการแจ้งเตือน สตรีมและ Launcher ระบบ การเปลี่ยนแปลงนี้มีวัตถุประสงค์เพื่อเพิ่มความสะดวกในการอ่าน แอป ให้ตรวจสอบการช่วยเหลือพิเศษของแอปด้วยธีม UI ใหม่นี้
  • วิทยุจะปิดเมื่อนาฬิกาปิดอยู่: เพื่อปรับปรุงการจัดการพลังงาน วิทยุบลูทูธ, วิทยุ Wi-Fi และวิทยุเครือข่ายมือถือจะปิดเมื่อตรวจพบว่านาฬิกาเป็น ออกจากร่างกายเป็นระยะเวลานาน เราจะทยอยเปิดตัวฟีเจอร์นี้ใน จากนักพัฒนาซอฟต์แวร์ ดังนั้นคุณอาจไม่เห็นภาพตัวอย่างบนนาฬิกาตั้งแต่แรก หากฟีเจอร์นี้ ก่อให้เกิดปัญหาในกระบวนการพัฒนา คุณปิดใช้ฟีเจอร์ได้โดยใช้ "adb" โดยใช้คำสั่งต่อไปนี้
    วันที่ adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • Wi-Fi จะปิดเมื่อไม่ได้เชื่อมต่อบลูทูธ: นาฬิกาเพื่อปรับปรุงการจัดการพลังงาน นาฬิกา ไม่เชื่อมต่อ Wi-Fi โดยอัตโนมัติอีกต่อไปเมื่อนาฬิกายกเลิกการเชื่อมต่อกับบลูทูธ ข้อยกเว้นรวมถึงกรณีที่แอปขอเครือข่ายแบนด์วิดท์สูงและกรณี ของนาฬิกาที่ต่ออยู่กับที่ชาร์จ เราจะทยอยเปิดตัวฟีเจอร์นี้ใน จากนักพัฒนาซอฟต์แวร์ ดังนั้นคุณอาจไม่เห็นภาพตัวอย่างบนนาฬิกาตั้งแต่แรก

การอัปเดตไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ เวอร์ชัน 2.3.0

การอัปเดตเอกสารประกอบเวอร์ชัน 2.3.0 สำหรับไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ประกอบด้วย ข้อมูลอัปเดตเกี่ยวกับการรีแบรนด์

นอกจากนี้ ไลบรารี v2.3.0 ยังมีการอัปเดตเกี่ยวกับ ComplicationDrawable และ TextRenderer สำหรับข้อความที่มีออบเจ็กต์มาร์กอัปแนบอยู่กับช่วงข้อความ ชั้นเรียนเหล่านี้มีการจัดการที่ดีขึ้น เปรียบเทียบ แสดงผลได้เฉพาะบางช่วงเท่านั้น โปรดดูเมธอด setText ของประเภทสแปนที่วาดได้ เพื่อให้ระยะเวลาไม่แสดงผล ดูไม่เรียบร้อยเมื่อแสดงผลในหน้าปัด

2018 - มีนาคม 2015 การรีแบรนด์ Wear

ส่วนนี้ประกอบด้วยข้อมูลเกี่ยวกับฟีเจอร์ของ Wear OS

ชื่อใหม่สำหรับ Android Wear

Android Wear เปลี่ยนชื่อเป็น Wear OS by Google แล้ว

การอัปเดตโหมดแอมเบียนท์ปี 2018 - 27 กุมภาพันธ์

ส่วนนี้ประกอบด้วยข้อมูลเกี่ยวกับฟีเจอร์ใหม่ของ Android Wear

คลาสใหม่เพื่อรองรับโหมดแอมเบียนท์

เวอร์ชัน 27.1.0 ของ Android Support Library มีเวอร์ชันใหม่ ชั้นเรียน AmbientModeSupport ซึ่งแทนที่รายการที่เลิกใช้งานแล้ว AmbientMode ชั้นเรียน การอัปเดตตัวอย่างเพลงกำลังวางแผนไว้เร็วๆ นี้ สัปดาห์

โปรแกรมจำลอง Final 2018 ม.ค. 2018 และอื่นๆ

ส่วนนี้ประกอบด้วยข้อมูลเกี่ยวกับฟีเจอร์ใหม่ของ Android Wear

โปรแกรมจำลอง Android: การอัปเดตสำหรับ Wear

การอัปเดตครั้งสุดท้ายที่เกี่ยวข้องกับ Wear ใน Android โปรแกรมจำลองมีไว้สำหรับการทดสอบแอปตาม API เวอร์ชัน 26

การเพิ่มประสิทธิภาพในไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้ เวอร์ชัน 2.2.0

เวอร์ชัน 2.2.0 ของไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้จะมีการอัปเดต ดังที่อธิบายไว้ด้านล่าง

สัญญาณบอกสถานะการแจ้งเตือนว่ายังไม่อ่าน

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

ปรับแต่งสีวงแหวนด้านนอกของการแจ้งเตือนที่ยังไม่อ่าน โดยใช้เมธอด setAccentColor

หมายเหตุ: สัญญาณบอกสถานะการแจ้งเตือนที่ยังไม่ได้อ่าน ในเวอร์ชันที่ใช้งานจริงของ Wear 2.8.0 ทดสอบ การใช้งานของคุณโดยใช้โปรแกรมจำลอง Wear ล่าสุดแทน เริ่มตั้งแต่รุ่นถัดไปสำหรับผู้บริโภคที่ใช้ Wear (เวอร์ชัน 2.9.0) สัญญาณบอกสถานะการแจ้งเตือนที่ยังไม่ได้อ่านจะแสดงโดยค่าเริ่มต้น

การเพิ่มประสิทธิภาพคลาส ComplicationDrawable

ชั้นเรียน ComplicationDrawable เริ่มคำขอสิทธิ์สำหรับ หน้าปัดที่จะถูกแตะเมื่อระบบระบุค่า TYPE_NO_PERMISSION ซึ่งแสดงว่าหน้าปัดไม่มี สิทธิ์ในการดูข้อมูลแทรก

นอกจากนี้ คลาส ComplicationDrawable จะเป็นโมฆะเมื่อเสร็จสิ้น กำลังโหลดรูปภาพหรือเมื่อไฮไลต์การแตะหมดอายุ เพื่อตอบกลับ การทำให้ใช้งานไม่ได้ เช่น วาดหน้าปัดซ้ำ ให้เพิ่ม Drawable.Callback

ปัญหาที่ทราบ

  • ถ้าคุณเปิดใช้งานโหมดโรงภาพยนตร์ในโปรแกรมจำลอง ตามที่อธิบายไว้ใน เปลี่ยนหน้าจอและ การตั้งค่าความสว่าง โปรแกรมจำลองจะยัง ค้างอยู่ที่โหมดโรงภาพยนตร์ การแก้ไขปัญหานี้คือการล้างข้อมูล ข้อมูลโปรแกรมจำลอง ดู เรียกใช้และหยุดโปรแกรมจำลอง รวมถึงล้างข้อมูล
  • ภายในหน้าต่างโปรแกรมจำลองสำหรับ API ระดับ 25 หรือ 26 ปุ่มเปิด/ปิดไม่ทำงาน ใช้ปุ่มอื่นที่ไม่ใช่ปุ่มเปิด/ปิดแทน โดยเฉพาะ เพื่อเปลี่ยนเป็นโหมดแอมเบียนท์ เช่น ราวกับว่าผู้ใช้ปิด ใช้ฝ่ามือของหน้าจอ ให้ใช้ปุ่มเปิด/ปิดบน แถบเครื่องมือโปรแกรมจำลองทางด้านขวาของจอแสดงผล วิธีเริ่มตัวเรียกใช้งานแอปพลิเคชันในโหมดอินเทอร์แอกทีฟ ใช้ปุ่มหน้าแรกบนแถบเครื่องมือโปรแกรมจำลอง
  • ในโปรแกรมจำลองเวอร์ชันจีน หากคุณใช้การเขียนด้วยลายมือ หน้าจอจะเริ่มกะพริบได้ จากนั้นเมื่อคุณคลิก ปุ่มสำหรับแป้นพิมพ์บนหน้าจอ แป้นพิมพ์จะบล็อกครึ่งหน้าจอ

2017 - ธันวาคม 18 การเข้าถึงบริการ Google Play ใหม่

ส่วนนี้ประกอบด้วยข้อมูลเกี่ยวกับฟีเจอร์ใหม่ของ Android Wear

ย้ายข้อมูลออกจากคลาส GoogleApiClient

เริ่มต้นด้วย version 11.8.0 ของบริการ Google Play ให้ย้ายข้อมูลแอป Wear ออกจาก GoogleApiClient และใช้ออบเจ็กต์ไคลเอ็นต์ API ที่ขึ้นอยู่กับ คลาส GoogleApi และ Tasks API

หมายเหตุ: การปรับปรุงนี้ไม่มีผลกับ แอป Android Wear สำหรับจีน ซึ่งโดยทั่วไปแล้วจะใช้เวอร์ชัน 10.2.0 ของ บริการ Google Play

โปรดดูข้อมูลต่อไปนี้สำหรับข้อมูลเพิ่มเติม

New components for connecting with Google Play services

When you use classes that extend the GoogleApi class, such as DataClient and MessageClient, the Google Play services SDK manages connections to Google Play services for you. Apps that use these classes no longer need to create and manage GoogleApiClient objects. See the blog post Moving Past GoogleApiClient for more information.

For the replacements of Wear-related components for connecting to Google Play services, see Replacements for deprecated components. For releases and known issues related to Google Play services, see the Release Notes for Google Play services.

Note: If you compile your app with the latest version of Google Play services, users are prompted to update their devices to that latest version. However, a known issue for apps that target API version 26 might prevent users from being prompted to update their devices. This issue is described in the Release Notes for Google Play services.

2017-Oct-25 Ambient mode and more

This section contains information about new Android Wear features.

Android Support Library, v27.0.0: Features and bugfixes

The 27.0.0 version of the Android Support Library contains new features for Wear. Review the following section.

New, preferred way to support ambient mode

Ambient mode lets a Wear app remain visible to a user when the device goes idle. The Android Support Library has a new, preferred way for your apps to use ambient mode. The Wear team seeks developer feedback about this significant change.

Specifically, using the AmbientMode class offers the following benefits:

Manifest metadata constants in the Android Support Library

Constants for Android Wear apps, used in the meta-data tag in the Android Manifest file, are now available in the Android Support Library. To use the constants—for standalone apps, notification bridging mode, and watch face preview images—add a reference to the following in the dependencies section of the app module's build.gradle file, which requires the latest version of the Google Repository:

Groovy

implementation 'com.android.support:wear:27.0.0'

Kotlin

implementation("com.android.support:wear:27.0.0")

Action drawer updates

Updates are available to the WearableActionDrawerView class, which is used for creating a wearable action drawer. In the latest version:

  • When menu items are modified, the action drawer properly updates.
  • If set for an action drawer, the title displays correctly.

Inflation of the RoundedDrawable class

Assuming an API level of at least 24, the RoundedDrawable class can now be inflated from a drawable XML file; see Custom drawables.

Wearable Support Library, v2.1.0: Enhancements and more

The 2.1.0 version of the Wearable Support Library includes the updates described in the following section, and requires Android Support Library version 26.0.2 or higher.

Supply burn-in-safe images for ambient mode

The ComplicationDrawable class lets you supply burn-in-safe images for ambient mode. Specifically, a ComplicationData object's burn-in protection small image field lets a watch face display a small image in the SMALL_IMAGE complication type, in ambient mode, when burn-in protection is enabled.

Tap event updates for complications

The ComplicationDrawable class has a new onTap method that lets your watch face pass tap events to complications. The new method builds on the existing functionality in which a tap on the watch face triggers the WatchFaceService.Engine.onTapCommand method.

You can pass the coordinates to a ComplicationDrawable with an onTap call to launch the action associated with the ComplicationDrawable that contains the tap coordinates. When the new onTap method is called, you can use a return value of true to see whether a ComplicationDrawable launched the action associated with it.

Additionally, the setHighlightDuration method sets the duration for a complication to remain highlighted after the onTap method is called.

Progress bar for ranged value complications

If you prefer to draw your own progress bar for ranged value complications in your watch face, use the setRangedValueProgressHidden method of the ComplicationDrawable class to hide the ranged value progress that's drawn by the ComplicationDrawable.

2017-Oct-02 Android Wear beta

Date: 2017-Oct-02
Build: OWP4.170828.008
Supported device: LG Watch Sport

This section contains known issues for an Android Wear beta release. For information about the beta program or to enroll, see the Android beta page.

Known issues

  • Google Pay and its cards do not function with this Android Wear beta release.
  • Even if cellular connectivity is on, it is turned off after the beta is installed. As a workaround, turn on cellular connectivity after the beta is installed by navigating to Settings > Connectivity > Cellular.
  • If notifications are erratic or missing after a beta update, or contacts were not synced, factory-reset your watch.
  • In the Wear tutorial, which starts after a watch is set up, some cards behave erratically, but they can be dismissed normally with a swipe.
  • On Android 6.0 phones, phone call notifications are not received on the watch.
  • Heart rate monitoring sometimes fails after an update. As a workaround, reboot the watch.
  • The OTA card in the stream sometimes fails to enable an installation. As a workaround, navigate to Settings > System > About > System Updates.