หน้าปัดของ Wear

หน้าปัดของ Wear

คู่มือผู้ใช้  ตัวอย่างโค้ด

เอกสารอ้างอิง API
androidx.wear.watchface

สร้างแอปพลิเคชันสำหรับสมาร์ทวอทช์ Wear OS by Google

หมายเหตุ: ตั้งแต่วันที่ 10 กรกฎาคม 2024 หน้าปัดต้องใช้ รูปแบบใบหน้าของนาฬิกาเพื่อ ซึ่งติดตั้งในนาฬิกาใหม่ที่เปิดตัวด้วย Wear OS 5 ล่วงหน้า ดูข้อมูลเพิ่มเติม เกี่ยวกับการเปลี่ยนแปลงที่ผู้ใช้เห็นใน ศูนย์ช่วยเหลือ บทความ

นอกจากนี้ ตั้งแต่ต้นปี 2025 เป็นต้นไป (จะประกาศวันที่ที่แน่นอนในช่วง ไตรมาสที่ 4 ปี 2024) หน้าปัดใหม่ทั้งหมดที่เผยแพร่ใน Google Play ต้องใช้หน้าปัด ฟอร์แมต

อัปเดตล่าสุด	รุ่นที่เสถียร	ตัวเลือกถอนการอ้างสิทธิ์	รุ่นเบต้า	รุ่นอัลฟ่า
17 เมษายน 2024	1.2.1	-	-	1.3.0-alpha03

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

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

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

ดึงดูด

dependencies {
    // Use to implement wear watchfaces
    implementation "androidx.wear.watchface:watchface:1.2.1"

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation "androidx.wear.watchface:watchface-editor:1.2.1"

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}

Kotlin

dependencies {
    // Use to implement wear watchfaces
    implementation("androidx.wear.watchface:watchface:1.2.1")

    // Use to implement wear watchface complications
    implementation "androidx.wear.watchface:watchface-complications-data-source:1.2.1"
    // (Kotlin-specific extensions)
    implementation "androidx.wear.watchface:watchface-complications-data-source-ktx:1.2.1"

    // Use to implement a watchface style and complication editor
    implementation("androidx.wear.watchface:watchface-editor:1.2.1")

    // Can use to render complications.
    // This library is optional and watchfaces may have custom implementation for rendering
    // complications.
    implementation "androidx.wear.watchface:watchface-complications-rendering:1.2.1"
}

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

ความคิดเห็น

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

สร้างรายการใหม่

ดูเอกสารประกอบเกี่ยวกับเครื่องมือติดตามปัญหา เพื่อดูข้อมูลเพิ่มเติม

เวอร์ชัน 1.3

เวอร์ชัน 1.3.0-alpha03

17 เมษายน 2024

ปล่อย androidx.wear.watchface:watchface-*:1.3.0-alpha03 แล้ว เวอร์ชัน 1.3.0-alpha03 มีคอมมิตเหล่านี้

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

• เราได้เพิ่ม EditorSession#setOverrideComplications ซึ่งตั้งค่า ComplicationData ของอินสแตนซ์หน้าปัดพื้นฐานชั่วคราวขณะแก้ไข หากข้อมูลแทรกเปลี่ยนแปลงไม่บ่อย วิธีนี้จะมีประสิทธิภาพมากกว่าการส่งการลบล้างผ่าน EditorSession#renderWatchFaceToBitmap (I19384)

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

• ก่อนหน้านี้ selectComplicationDataForInstant ได้เรียกใช้ toApiComplicationData สำหรับทุกช่วงเวลา ซึ่งหมายความว่าการทดสอบ === การอ้างอิงความเท่าเทียมที่ตามมาจะไม่สำเร็จเสมอ ซึ่งหมายความว่ามีการโหลดข้อมูลแทรกซ้ำทุกเฟรมจนทำให้แบตเตอรี่หมดเร็ว (717406)

เวอร์ชัน 1.3.0-alpha02

3 เมษายน 2024

ปล่อย androidx.wear.watchface:watchface-*:1.3.0-alpha02 แล้ว เวอร์ชัน 1.3.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ตอนนี้เราใช้ความเทียบเท่าอ้างอิงเพื่อเปรียบเทียบที่ดีที่สุดและ selectedData เนื่องจากโอเปอเรเตอร์เท่ากับมีราคาแพง (446B00)

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

• เราได้เพิ่ม API แบบไดนามิกที่ไม่มีทางเลือกสำหรับ GoalProgressComplicationData (c33264)

เวอร์ชัน 1.3.0-alpha01

7 กุมภาพันธ์ 2024

ปล่อย androidx.wear.watchface:watchface-*:1.3.0-alpha01 แล้ว เวอร์ชัน 1.3.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

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

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

• ตอนนี้ StatefulWatchFaceService รองรับการลบล้างของ getComplicationSlotInflationFactory ซึ่งมีการส่งส่วนเพิ่มเติมที่กำหนดโดยผู้ใช้ซึ่งสร้างโดย createExtra() (I82d9f)
• หน้าปัดบางแบบต้องแชร์ข้อมูลเสริมที่สร้างขึ้นระหว่าง createUserStyleSchema กับวิธีการเริ่มต้นอื่นๆ เนื่องจากไม่มีทางเลือกอื่นที่ดีกว่า นักพัฒนาแอปจึงมักทำให้ WatchFaceServices เป็นแบบเก็บสถานะ วิธีนี้เป็นอันตรายเนื่องจากระบบอาจสร้างอินสแตนซ์หลายรายการพร้อมกันและอาจทำให้เกิดข้อบกพร่องได้ ในการแก้ปัญหานี้ เราได้แนะนํา StatefulWatchFaceService และ StatefulWatchFaceRuntimeService ซึ่งสร้างประเภทที่กำหนดโดยผู้ใช้โดย createExtra() และส่งไปยังวิธีการสร้างต่างๆ เป็นพารามิเตอร์ (If8a99)
• เราได้เพิ่ม getUserStyleFlavors ไปยัง InteractiveWatchFaceClient ซึ่งเป็นที่สนใจสำหรับ OEM เป็นหลัก (I0f5d8)
• ตอนนี้ GlesRenderer2 มีการโอเวอร์โหลดของเครื่องมือสร้างที่ช่วยให้คุณระบุรายการแอตทริบิวต์ที่จะลองใช้ด้วย eglChooseConfig ตัวอย่างเช่น ตัวอย่างนี้ช่วยให้คุณลองใช้การกำหนดค่าที่มีการลบรอยหยักได้ก่อน และอาจใช้การกำหนดค่าสำรองหากจำเป็น (I1ba74)
• จาก Android U ระบบจะเพิ่มการรองรับ SystemDataSources.DATA_SOURCE_HEART_RATE ใน WearOS รับประกันว่าข้อมูลแทรกนี้จะรองรับข้อมูลแทรก SHORT_TEXT เท่านั้น แต่ขอแนะนำให้ ComplicationSlot ยอมรับ SMALL_IMAGE ด้วย เนื่องจาก OEM อาจเลือกแสดงทางลัดไปยังแอปสุขภาพแทนค่าแบบเรียลไทม์ (I34223)
• เราได้เพิ่ม METADATA_KEY_CONFIG_RESTORE_SUPPORTED ซึ่งตั้งแต่ Android U เป็นต้นไป ซึ่งจะควบคุมสิ่งที่เกิดขึ้นเมื่อระบบกู้คืนระบบจากข้อมูลสำรองสำหรับแหล่งข้อมูลแทรกด้วย METADATA_KEY_DATA_SOURCE_CONFIG_ACTION โดยค่าเริ่มต้น ระบบจะถือว่าบริการแหล่งข้อมูลแทรกรองรับการสำรองข้อมูลการกำหนดค่าต่างๆ แต่หากไม่มี ระบบก็เพิ่มการตั้งค่าข้อมูลเมตา METADATA_KEY_DATA_SOURCE_CONFIG_ACTION เป็น false ได้ ซึ่งจะทำเครื่องหมายช่องข้อมูลแทรกว่าไม่ได้กำหนดค่าไว้ (I6C505)

เวอร์ชัน 1.2

เวอร์ชัน 1.2.1

24 มกราคม 2024

ปล่อย androidx.wear.watchface:watchface-*:1.2.1 แล้ว เวอร์ชัน 1.2.1 มีคอมมิตเหล่านี้

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

• แก้ไขข้อขัดข้องใน Samsung Galaxy Watch 4, 5 และ 6. (43f0b0)

เวอร์ชัน 1.2.0

29 พฤศจิกายน 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0 แล้ว เวอร์ชัน 1.2.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.1.0

• เราได้เพิ่มการรองรับข้อมูลแทรกประเภทใหม่ๆ บางรายการที่พร้อมใช้งานจาก Android T ดังนี้
  • GoalProgressComplicationData ซึ่งคล้ายกับ RangedValueComplicationData ยกเว้นสำหรับความคืบหน้าสู่เป้าหมายที่ค่าต่ำสุดเป็น 0 และค่าได้รับอนุญาตให้มากกว่า targetValue
  • WeightedElementsComplicationData ซึ่งประกอบด้วยอาร์เรย์ขององค์ประกอบ (น้ำหนักและสี) พร้อมกับข้อความ/ชื่อ/รูปภาพที่ไม่บังคับ แผนภูมินี้อาจแสดงเป็นแผนภูมิวงกลมที่สีต้องสื่อความหมายตามบริบท เนื่องจากโดยทั่วไปแล้วจะไม่มีข้อมูลแทรกสำหรับแสดงผลป้ายกำกับ
• เราได้เพิ่มการรองรับ ColorRanges ที่ไม่บังคับไปยัง RangedValueComplicationData แล้ว โดยปกติแล้ว ข้อมูลแทรกจะแสดงเป็นสีตามการเลือกของหน้าปัด แต่บางครั้งก็แสดง ComplicationDataSource เพื่อกำหนดสีที่ดีที่สุด เช่น เมื่อมีความหมายทางอรรถศาสตร์เฉพาะ เช่น สีแดงเป็นสีน้ำเงินสำหรับอุณหภูมิ
• ขณะนี้ ComplicationData เกือบทุกประเภทรองรับ SmallImages แล้ว
• เราได้เพิ่ม ComplicationDisplayPolicy โดยที่ DO_NOT_SHOW_WHEN_DEVICE_LOCKED สั่งให้หน้าปัดที่เข้ากันได้ไม่แสดงข้อมูลแทรกเมื่ออุปกรณ์ล็อกอยู่
• ใน Android T นั้น OEM จะระบุได้ว่าคำขอข้อมูลแทรกมาจากหน้าปัดในรายการที่กำหนดโดยข้อมูลเมตาของ android.support.wearable.complications.SAFE_WATCH_FACES ในไฟล์ Manifest ของผู้ให้บริการโดย ComplicationRequest#isForSafeWatchFace หรือไม่ ผู้ให้บริการจะต้องมีสิทธิ์ com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE เพื่อรับรายการอื่นนอกเหนือจาก TargetWatchFaceSafety.UNKNOWN"
• UserStyleFlavors กลายเป็นฟีเจอร์ที่ไม่ได้อยู่ในการทดสอบ

เวอร์ชัน 1.2.0-rc01

18 ตุลาคม 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-rc01 แล้ว เวอร์ชัน 1.2.0-rc01 มีคอมมิตเหล่านี้

เวอร์ชัน 1.2.0-beta02

6 กันยายน 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-beta02 แล้ว เวอร์ชัน 1.2.0-beta02 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• SuspendingComplicationDataSourceService#onDestroy เปิดอยู่ โปรดทราบว่าเราได้นำการรองรับข้อมูลแทรกเกี่ยวกับสภาพอากาศเริ่มต้นของระบบออกแล้ว

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

• เปลี่ยนกลับ "แสดงแหล่งข้อมูลใหม่สำหรับข้อมูลแทรกสภาพอากาศ" (I6F335)

เวอร์ชัน 1.2.0-beta01

23 สิงหาคม 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-beta01 แล้ว เวอร์ชัน 1.2.0-beta01 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• WearOS รองรับข้อมูลแทรกของระบบสภาพอากาศเริ่มต้นใน Android T แล้ว

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

• เพิ่มข้อมูลสำรองเริ่มต้นของสภาพอากาศสำหรับข้อมูลแทรก (Ia0994)
• แพตช์นี้เพิ่ม WatchFaceRuntimeService และ WatchFaceControlClient.createWatchFaceRuntimeControlClient รวมถึง Wrapper ฝรั่ง ซึ่งจะเพิ่มการสนับสนุนรันไทม์ของหน้าปัด ซึ่งเป็นหน้าปัดแบบพิเศษที่โหลดคำจำกัดความมาจากแพ็กเกจอื่น ปัจจุบัน WearOS รองรับเฉพาะรันไทม์สำหรับ Android Watch Face Format (I2799f)
• แพตช์นี้เป็นการติดตามผลของ aosp/2636578 ซึ่งเราเปลี่ยนชื่อ int defs เพื่อให้โค้ดที่ขึ้นอยู่กับ WatchFaceType, CanvasType, TapType หรือ ComplicationsSlotBoundsType ไม่จำเป็นต้องเปลี่ยนแปลง (I4098B)
• อัปเดตไฟล์ API เพื่อให้มีคำอธิบายประกอบสำหรับการระงับความเข้ากันได้ (I8e87a, b/287516207)
• แพตช์นี้แสดงค่าคงที่ WatchFaceType ใน WatchFaceTypes, ค่าคงที่ CanvasType ใน CanvasTypes, ค่าคงที่ TapType ใน TapTypes และค่าคงที่ ComplicationsSlotBoundsType ใน ComplicationsSlotBoundsType (I3b85a, b/288750666)
• WatchFace.OverlayStyle ใช้งานน้อยมากและไม่ได้รับการรองรับจาก OEM เราจึงจะเสื่อมราคาโดยตั้งใจจะนําราคานี้ออกในภายหลัง (I7344a)

เวอร์ชัน 1.2.0-alpha09

21 มิถุนายน 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha09 แล้ว เวอร์ชัน 1.2.0-alpha09 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ตอนนี้ RangedValueComplicationData.Builder ยอมรับ DynamicFloat แล้ว และ DynamicComplicationText ใหม่พร้อมให้บริการในคลาสย่อย ComplicationText ซึ่งทั้ง 2 รุ่นสามารถใช้นิพจน์แบบไดนามิกและการเชื่อมโยงแพลตฟอร์มที่อัปเดตที่ 1 hz ในอุปกรณ์ Wear 4 ที่รองรับ

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

• เพิ่มประเภทแบบไดนามิกสำหรับระยะทางรายวัน แคลอรี่รายวัน และราคาพื้นรายวัน ตอนนี้คีย์สำหรับแหล่งที่มาของประสิทธิภาพของแพลตฟอร์มอยู่ภายใต้ PlatformHealthSources.Keys (Ib7637)
• ใช้ PlatformDataProvider เพื่อระบุอัตราการเต้นของหัวใจและจํานวนก้าวในแต่ละวัน นำอินเทอร์เฟซ SensorGateway ออกจาก API สาธารณะแล้ว (I55b84)
• เปลี่ยนชื่อ StateEntryValue เป็น DynamicDataValue และอัปเดต API สถานะเพื่อใช้ DynamicDataKey (If1c01)
• เพิ่ม AppDataKey สำหรับการเข้าถึงสถานะที่พุชของแอป เพิ่ม PlatformDataKey สําหรับการเข้าถึงข้อมูลแพลตฟอร์ม เพิ่มการรองรับเนมสเปซใน StateStore (I7985e)
• นำเมธอด enable/disablePlatformSource รายการออกจาก DynamicTypeEvaluator แล้ว ผู้โทรควรเป็นผู้รับผิดชอบการอัปเดต (I78c6d)
• อนุญาตการจำกัดขนาดของประเภทข้อมูลที่ผูกไว้ (Ie2966)

เวอร์ชัน 1.2.0-alpha08

19 เมษายน 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha08 แล้ว เวอร์ชัน 1.2.0-alpha08 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• จาก Android T ผู้ให้บริการข้อมูลแทรกที่มี com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE ที่ได้รับสิทธิ์อาจลงทะเบียนข้อมูลเมตาของ androidx.wear.watchface.complications.datasource.SAFE_WATCH_FACE_SUPPORTED_TYPES ซึ่งจะลบล้าง android.support.wearable.complications.SUPPORTED_TYPES สำหรับหน้าปัดที่ปลอดภัย ซึ่งหมายความว่าผู้ให้บริการข้อมูลแทรกอาจเลือกแสดงหน้าปัดประเภทต่างๆ ที่เชื่อถือได้กับหน้าปัดที่ไม่น่าเชื่อถือ

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

• การเผยแพร่คลาส @Deprecated ไปยังพร็อพเพอร์ตี้ (I882d1, b/271441831)
• เปลี่ยนชื่อพารามิเตอร์ค่าของ Enum.valueOf แล้ว (Ia9b89)
• ข้อยกเว้นเพิ่มเติมจาก enum valueOf (I818fe)
• เรานำ renderWatchFaceToSurface ออกเพื่อสนับสนุน createRemoteWatchFaceView ซึ่งสร้างขึ้นจาก SurfaceControlViewHost และช่วยให้ผู้โทรฝังมุมมองจากหน้าปัดได้ ซึ่งจะแสดงผลเมื่อไคลเอ็นต์โทรหา RemoteWatchFaceViewHost#renderWatchFace (Ib311D)
• เราได้เพิ่ม renderWatchFaceToSurface ลงใน InteractiveWatchFaceClient, HeadlessWatchFaceClient และ EditorSession แล้ว ซึ่งปกติแล้ววิธีนี้จะมีประสิทธิภาพมากกว่าการแสดงผลไปยังบิตแมป (Ieacad)
• เปลี่ยนชื่อ ObservableStateStore เป็น StateStore แล้ว (Ieb0e2)
• เพิ่ม DynamicTypeEvaluator.Builder แทนอาร์กิวเมนต์ตัวสร้างเพื่ออนุญาตให้มีอาร์กิวเมนต์ที่ไม่บังคับมากขึ้น ซึ่งรวมถึง ObservableStateStore ซึ่งตอนนี้มีค่าเริ่มต้นเป็นที่เก็บที่ว่างเปล่า (I6F832)
• เปลี่ยนลำดับของพารามิเตอร์ใน DynamicTypeEvaluator แล้ว (Ic1ba4)
• เพิ่มผู้ดำเนินการไปยังเมธอด DynamicTypeEvaluator.bind แล้ว (I346ab)
• เราได้เพิ่มเมธอด startEvaluation ลงใน BoundDynamicType เพื่อทริกเกอร์การประเมินหลังจากเชื่อมโยงประเภทแบบไดนามิกแล้ว (I19908)
• ผู้ให้บริการข้อมูลแทรกที่มี com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE ที่ได้รับสิทธิ์อาจลงทะเบียนข้อมูลเมตาของ androidx.wear.watchface.complications.datasource.SAFE_WATCH_FACE_SUPPORTED_TYPES ซึ่งจะลบล้าง android.support.wearable.complications.SUPPORTED_TYPES สำหรับหน้าปัดที่ปลอดภัย (Id1c73)
• เราได้เปลี่ยนชื่อ CustomValueUserStyleSettings2 เป็น LargeCustomValueUserStyleSettings แล้ว (Ic17ac)

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

• นำ DynamicTypeValueReceiver#onPreUpdate ออกแล้ว (I2dc35)

เวอร์ชัน 1.2.0-alpha07

22 กุมภาพันธ์ 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha07 แล้ว เวอร์ชัน 1.2.0-alpha07 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ใน Android T นั้น OEM จะระบุได้ว่าคำขอข้อมูลแทรกมาจากหน้าปัดในรายการที่กำหนดโดยข้อมูลเมตาของ android.support.wearable.complications.SAFE_WATCH_FACES ในไฟล์ Manifest ของผู้ให้บริการโดย ComplicationRequest#isForSafeWatchFace หรือไม่ ผู้ให้บริการจะต้องมีสิทธิ์ com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE เพื่อรับสิ่งอื่นๆ นอกเหนือจาก TargetWatchFaceSafety.UNKNOWN

• Android T CustomValueUserStyleSetting2 ยังมีให้ใช้ได้ด้วย ซึ่งรองรับได้สูงสุด 12.5 KB ขีดจำกัดก่อนหน้านี้สำหรับ CustomValueUserStyleSetting คือ 1 KB แม้จะมีขนาดจำกัดเพิ่มขึ้น แต่ขอแนะนำให้นักพัฒนาหน้าปัดเก็บข้อมูลให้มีขนาดเล็ก เนื่องจากการตั้งค่าจะส่งผ่านบลูทูธในระหว่างการแก้ไข และแบนด์วิดท์ของบลูทูธมีจำกัด

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

• เราได้เพิ่มพารามิเตอร์ที่ไม่บังคับ eglContextAttribList ลงใน GlesRenderer และ GlesRenderer2 ซึ่งอนุญาตให้คุณตั้งค่า EGL14.EGL_CONTEXT_CLIENT_VERSION ที่ส่งไปยัง EGL14.eglCreateContext (I2a83e)
• เราได้ย้ายข้อมูลคลังหน้าปัดไปที่ androidx.core.util.Consumer แทน java.util.function.Consumer แล้ว (I273f5)
• ข้อยกเว้นเพิ่มเติมจากผู้เข้าถึงพร็อพเพอร์ตี้ KT (Iff9d9)
• เราได้เพิ่ม InteractiveWatchFaceClient.isComplicationDisplayPolicySupported เพื่อให้ลูกค้าระบุได้ว่าต้องจำลองการรองรับหรือไม่ในนามของหน้าปัดเก่า (I24c89)
• เราตัดสินใจว่า isForSafeWatchFace ควรเป็น IntDef แบบ 3 สถานะ (Ief2f7)
• สำหรับ Android T เราได้เปิดตัว ComplicationRequest.isForSafeWatchFace ซึ่งมีไว้สำหรับการใช้งานของ OEM และต้องใช้ com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE สำหรับแหล่งข้อมูลในอิมเมจระบบ ค่านี้จะแสดงเป็น "จริง" หากหน้าปัดที่ขออยู่ในรายการหน้าปัดที่ปลอดภัยซึ่งแหล่งข้อมูลในไฟล์ Manifest ระบุไว้ (I0cbb6)
• สำหรับ Android T เราเพิ่ม CustomValueUserStyleSetting2 ซึ่งมีขนาดไม่เกิน 12.5 KB ขีดจำกัดก่อนหน้านี้สำหรับ CustomValueUserStyleSetting คือ 1 KB (I0B100)

เวอร์ชัน 1.2.0-alpha06

25 มกราคม 2023

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha06 แล้ว เวอร์ชัน 1.2.0-alpha06 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เรากำลังดำเนินการอย่างต่อเนื่องเพื่อเพิ่มการรองรับการเชื่อมโยงแพลตฟอร์มข้อมูลแทรก ฟีเจอร์นี้ยังไม่พร้อมใช้งาน แต่โปรดอดใจรอ
• เราได้เพิ่มการรองรับ XML ComplicationSlot สำหรับประเภทข้อมูลแทรกใหม่ GOAL_PROGRESS และ WEIGHTED_ELEMENTS

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

• แก้ไขการรั่วไหลที่เครื่องมือแก้ไขหน้าปัดไม่ได้เผยแพร่อย่างถูกต้องในอุปกรณ์ Samsung (3b5987)
• แก้ไขข้อบกพร่องที่บางครั้งข้อมูลแทรกแสดงไม่ถูกต้องเมื่อสลับระหว่างหน้าปัดที่มีรายการโปรดหลายรายการ (b38ece)
• แก้ไขข้อบกพร่องของการทำให้เป็นอนุกรมด้วย perOptionScreenReaderNames ที่ทำให้หน้าปัดขัดข้อง (e9f466)

เวอร์ชัน 1.2.0-alpha05

7 ธันวาคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha05 แล้ว เวอร์ชัน 1.2.0-alpha05 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ก่อนหน้านี้เราได้เพิ่มการรองรับ UserStyleSettings ตามลําดับชั้น และในตอนนี้สามารถมี ComplicationSlotsUserStyleSetting มากกว่า 1 รายการในลําดับชั้นได้แล้วตั้งแต่ Android T มีเพียง ComplicationSlotsUserStyleSetting เดียวที่ใช้งานได้ ขึ้นอยู่กับการเลือกสไตล์ของผู้ใช้

• เรากำลังปรับปรุงการรองรับโปรแกรมอ่านหน้าจอสำหรับ ListOption และ ComplicationSlotsOption ด้วยการเพิ่มช่อง screenReaderName โปรดทราบว่าเครื่องมือแก้ไขที่ใช้ร่วมกันจะไม่สนใจช่องนี้ก่อนที่จะใช้ Android T

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

• เราได้เพิ่มช่อง screenReaderName ซึ่งเป็นช่องใหม่ที่ไม่บังคับลงใน ListOption และ ComplicationSlotsOption เพื่อให้เอดิเตอร์ใช้งานได้ โดยเครื่องมือแก้ไขที่ใช้ร่วมกันในอุปกรณ์ก่อน Android T จะไม่สนใจ (I75326)
• ตั้งแต่ Android T หลาย ComplicationSlotsUserStyleSettings ได้รับการรองรับในลำดับชั้นของสไตล์แล้ว แต่อนุญาตให้ใช้งานเพียงครั้งละ 1 รายการเท่านั้น เราได้เพิ่มฟังก์ชันยูทิลิตี findComplicationSlotsOptionForUserStyle ลงใน UserStyleSchema เพื่อช่วยค้นหา ComplicationSlotsOption ที่ใช้งานอยู่ (หากมี) (Ic2b06)
• ระบบดึง RangedValuesTypes เข้าไปในออบเจ็กต์ร่วมของ RangedValueComplicationData และเปลี่ยนชื่อเป็น TYPE_UNDEFINED, TYPE_RATING และเพิ่ม TYPE_PERCENTAGE ใหม่ (I55d02)
• เราได้เปลี่ยนชื่อ DynamicFloat แบบทดลองเป็น FloatExpression และทำเครื่องหมายว่าเป็น @hide (Idf4f1)
• กำลังเพิ่มคำอธิบายประกอบ @JvmDefaultWithCompatibility (I8f206)

เวอร์ชัน 1.2.0-alpha04

9 พฤศจิกายน 2022

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha04 แล้ว เวอร์ชัน 1.2.0-alpha04 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• สำหรับ Android T เราได้เพิ่มการรองรับข้อมูลแทรกใหม่ 2 ประเภท ได้แก่ GoalProgressComplicationData และ WeightedElementsComplicationData
• GoalProgressComplicationData คล้ายกับ RangedValueComplicationData แต่ค่าได้รับอนุญาตให้ผ่านเป้าหมาย (สำหรับ RangedValueComplicationData ค่าจะถูกจํากัดไว้ที่ช่วง [min .. max]) ซึ่งมีผลกระทบต่อการออกแบบภาพที่อาจไม่เหมาะกับหน้าปัดทั้งหมด
• GoalProgressComplicationData เพิ่มการรองรับแผนภูมิวงกลมและรายละเอียดที่คล้ายกันของข้อมูลทั่วไป
• เราได้เพิ่มการสนับสนุนเสริมสำหรับ ColorRamps ใน RangedValueComplicationData
• สำหรับ Android T เราได้เพิ่ม ComplicationPersistencePolicy และ setCachePolicy ลงใน ComplicationData ซึ่งปัจจุบันอนุญาตให้ผู้ให้บริการควบคุมได้ว่าจะมีข้อมูลแทรกหรือไม่ (เช่น แคชข้อมูลไว้หลังจากรีบูตหรือไม่) ข้อมูลแทรกส่วนใหญ่ไม่จำเป็นต้องตั้งค่าการควบคุมแคช แต่การทำเช่นนี้สามารถแก้ปัญหามุมต่างๆ ที่มีข้อมูลเก่าสำหรับข้อมูลแทรกบางอย่างที่มีการอัปเดตบ่อยครั้ง (เช่น ข้อมูลแทรกซ้อนของข้อมูลสุขภาพ) นอกจากนี้ เราได้เพิ่ม ComplicationDisplayPolicy โดยที่ DO_NOT_SHOW_WHEN_DEVICE_LOCKED จะสั่งหน้าปัดที่เข้ากันได้ไม่ให้แสดงข้อมูลแทรกเมื่ออุปกรณ์ล็อกอยู่ (Ic9574)

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

• GoalProgressComplicationData, WeightedElementsComplicationData และ ColorRamp ไม่อยู่ในการทดสอบแล้ว (Ica9e2)
• ทำเครื่องหมาย ComplicationPersistencePolicy และ ComplicationDisplayPolicy อย่างถูกต้องว่าเป็น T API แล้ว (I31d88)
• ขณะนี้ตัวสร้าง ComplicationSlotOverlay ที่เลิกใช้งานแล้วมี DeprecationLevel.WARNING ซึ่งทำให้สามารถเรียกใช้จาก Java ได้อีกครั้ง (Ib308C)
• เราแก้ไขปัญหาความเข้ากันได้ของ Java กับ ComplicationRequestListener, CanvasComplication, ComplicationTapFilter และ InteractiveWatchFaceClient แล้วด้วยการใส่คำอธิบายประกอบด้วย @JvmDefaultWithCompatibility (Id94fc)
• เราได้นำ ProtoLayoutComplicationData และ ListComplicationData เวอร์ชันทดลองออกแล้ว เรื่องราวของนักพัฒนาซอฟต์แวร์เกี่ยวกับเรื่องนี้ไม่ชัดเจน เราหวังว่าจะกลับมาตรวจสอบอีกในอนาคต (I9df05)
• เราได้เพิ่ม ValueType กลับไปที่ RangedValueComplicationData WeightedElementsComplicationData รองรับสีพื้นหลังแล้ว เราได้นำ DiscreteRangedValueComplicationData ออกเนื่องจากฟังก์ชันการทำงานนี้เป็นส่วนหนึ่งของ WeightedElementsComplicationData (I6446C)

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

• รวม isForScreenShot ในโค้ดเท่ากับและแฮช ตรวจสอบว่า onRenderParametersChanged ได้รับค่า isForScreenshot ที่ถูกต้อง (I04a41)
• แก้ไขการรั่วไหลของ WatchFaceControlService จากไคลเอ็นต์แบบไม่มีส่วนหัว (e90e00)

เวอร์ชัน 1.2.0-alpha03

5 ตุลาคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha03 แล้ว เวอร์ชัน 1.2.0-alpha03 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ไม่มีฟีเจอร์ใหม่ แต่เราได้แก้ไขข้อบกพร่องของเครื่องมือแก้ไขหน้าปัดอยู่ 2 รายการ

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

• เลิกใช้งาน UserStyleSchema.userStyleSettings เนื่องจาก rootUserStyleSettings กลายเป็นแบบไม่ทดสอบ (Ie96e3)
• ย้าย rootUserStyleSettings ออกจากการทดลอง (I8d6b3)
• เราทำเครื่องหมาย WatchFaceColors ว่าเป็นเวอร์ชันทดลองเนื่องจากบางระบบไม่รองรับ (I6d75d)
• แสดง DisconnectReasons ใน API สาธารณะเพื่อให้ใช้งานกับ IntDef (I791f8)

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

• ปิดเมื่อเปิดในเครื่องมือแก้ไขนาฬิกาหาก SysUI เสียชีวิต หาก SysUI ไม่ทำงานและเครื่องมือแก้ไขหน้าปัดไม่ปิด หน้าปัดอาจอยู่ในสถานะไม่สอดคล้องกันเนื่องจากระบบใช้ SysUI เพื่อคงการเปลี่ยนแปลงรูปแบบของผู้ใช้ไว้ (ba762a
• แก้ไขการรั่วไหลของหน่วยความจำใน ComplicationDataSourceInfoRetriever โดยที่ความต่อเนื่องของ Kotlin coroutine ทำหน้าที่เป็นรูท gc และเก็บกิจกรรมของเครื่องมือแก้ไขไว้ (33ee06)

เวอร์ชัน 1.2.0-alpha02

21 กันยายน 2022

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha02 แล้ว เวอร์ชัน 1.2.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• หน้าปัดบางแบบมีการกำหนดค่านอก UserStyle ซึ่งส่งผลต่อการมองเห็น (เช่น การเลือกภาพพื้นหลัง) เราได้เพิ่ม Renderer.sendPreviewImageNeedsUpdateRequest ซึ่งอนุญาตให้หน้าปัดขอรูปภาพตัวอย่างที่อัปเดตได้ โปรดทราบว่าการอัปเดตนี้จำเป็นต้องมีการอัปเดตระบบที่เกี่ยวข้องจึงจะทำงานได้

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

• ขณะนี้ ComplicationData เกือบทุกประเภทรองรับ SmallImages แล้ว

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

• บางครั้งตัวจัดการวอลเปเปอร์สามารถตัดการทำงานจากเครื่องยนต์และสร้างอีกรายการหนึ่งได้ เราได้เพิ่ม DisconnectReason Int def และขยาย ClientDisconnectListener ด้วยเมธอดใหม่ที่มี DisconnectReason ซึ่งทำให้ผู้ฟังสังเกตเห็นการถอดกลไกได้ (I45cce)
• เพิ่มพารามิเตอร์ที่ไม่บังคับ 2 รายการ nameResourceId และ screenReaderResourceId ลงในตัวสร้าง ComplicationSlotOverlay (I157e8)
• เราได้เพิ่ม Wrapper ฝรั่งสำหรับ getOrCreateInteractiveWatchFaceClient ที่เกินมาใหม่ด้วย PreviewImageUpdateRequestedListener (Ic31f0)
• เราได้เพิ่ม Renderer.sendPreviewImageNeedsUpdateRequest ซึ่งเป็นประโยชน์สำหรับหน้าปัดที่มีสถานะอยู่นอก UserStyleSchema ซึ่งจะส่งผลต่อรูปลักษณ์ของหน้าปัด (เช่น หน้าปัดที่มีภาพพื้นหลังที่เลือกได้) ในฝั่งไคลเอ็นต์ เราได้เพิ่ม PreviewImageUpdateRequestedListener เป็นพารามิเตอร์ที่ไม่บังคับลงใน getOrCreateInteractiveWatchFaceClient เพื่อสังเกตคำขอเหล่านี้ (Iff44a)
• เราลดความซับซ้อนของ API สำหรับการแสดง WatchFaceColors ตอนนี้มีพร็อพเพอร์ตี้พื้นฐานชื่อ watchFaceColors ในตัวแสดงผลซึ่งตั้งค่าหน้าปัดได้ ซึ่งควรอัปเดตตามที่จำเป็นเพื่อตอบสนองต่อการเปลี่ยนแปลงรูปแบบใดๆ เราได้เพิ่ม OnWatchFaceColorsListener ลงใน InteractiveWatchFaceClient แทนที่จะใช้ WallpaperManager เพื่อดูการเปลี่ยนสี (I490bc)
• เราได้เพิ่มคลาส WatchFaceColors ซึ่งมีสีหน้าปัด 3 สีที่โดดเด่นที่สุด รวมถึงเพิ่มวิธีการเปิด watchfaceColors และ notifyWatchFaceColorsChanged ไปยังโหมดแสดงภาพจะทำให้ระบบสามารถรับสีของหน้าปัดผ่าน WallpaperManager.getWallpaperColors (I3d611)
• ขณะนี้ ShortTextComplicationData, RangedValueComplicationData, NoPermissionComplicationData (และ DiscreteRangedValueComplicationData, GoalProgressComplicationData และ WeightedElementsComplicationData เวอร์ชันทดลอง) รองรับ SmallImages ทั้งหมดแล้ว หากหน้าปัดเลือกแสดงข้อมูลแทรกที่มีหลายสี ตอนนี้หน้าปัดมีตัวเลือกให้ใช้ SmallImage หลายสี ซึ่งก่อนหน้านี้จะต้องใช้รูปภาพสีเดียว (I257df)
• เปลี่ยนโครงสร้างภายใน PreviewImageUpdateRequestedListener เป็น Consumer<> แทน (Ia875d)
• แทนที่ประเภท Java SAM ที่กำหนดเอง (SAM) OnWatchfaceColorsListener ที่กำหนดเองด้วยประเภท Java SAM (ผู้บริโภค) ทั่วไป (I0c489)
• เราเลิกใช้งานเมธอด getOrCreateInteractiveWatchFaceClient และ listenableGetOrCreateInteractiveWatchFaceClient แบบเก่าที่ไม่ได้ระบุ PreviewImageUpdateRequestedListener แล้ว (Iec502)

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

• เปลี่ยนชื่อ DisconnectReason.BINDER_DIED เป็น DisconnectReason.ENGINE_DIED แล้ว (I4eb0e)

เวอร์ชัน 1.2.0-alpha01

10 สิงหาคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.2.0-alpha01 แล้ว เวอร์ชัน 1.2.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

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

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

• คลาส BoundingArc แบบทดลองจะเปลี่ยนแปลงไม่ได้ในตอนนี้ (If624a)
• ข้อมูลแทรกเล็กๆ อาจแตะได้ยาก เพื่อช่วยลดปัญหานี้ เราได้เพิ่มการรองรับขอบ ซึ่งจะเพิ่มพื้นที่ที่แตะได้โดยไม่ส่งผลต่อการแสดงผล หากไม่ได้ระบุ (ในโค้ดหรือผ่าน XML) ComplciationSlots มีระยะขอบที่มีขนาดเป็น 0 (I14089)
• เปลี่ยนลายเซ็น getComplicationSlotInflationFactory(CurrentUserStyleRepository) เพื่อแสดงผลอินสแตนซ์เริ่มต้นที่ไม่เป็นค่าว่างแล้ว มีข้อผิดพลาดที่จะแสดงผลเป็น Null ก่อนหน้านี้ นี่จึงเป็นเพียงการทำให้สัญญา API มีความชัดเจนขึ้น (I0fcc0)
• เราได้เพิ่มอาร์กิวเมนต์ currentUserStyleRepository ลงในเมธอด WatchFaceService.getComplicationSlotInflationFactory เพื่อให้สอดคล้องกับ createComplicationSlotsManager แล้ว (I2ddd2)
• UserStyleFlavors กลายเป็นฟีเจอร์ที่ไม่ได้อยู่ในการทดสอบ (I69cdc)
• เราได้นำ ValueType แบบทดลองออกจาก RangedValueComplicationData และแนะนำ DiscreteRangedValueComplicationData แบบทดลองแทน ซึ่งเหมือนกับ RangedValueComplicationData ยกเว้นช่วงจำนวนเต็ม & นอกจากนี้ เรายังได้แนะนำ GoalProgressComplicationData เวอร์ชันทดลองซึ่งคล้ายกับ RangedValueComplicationData ยกเว้นในส่วนของความคืบหน้าสู่เป้าหมายที่ค่าต่ำสุดเป็น 0 และได้รับอนุญาตให้มีค่ามากกว่า targetValue หมายเหตุสำหรับตัวแปร RangedValue ทั้งหมด ต้องระบุ monochromeImage ข้อความ หรือชื่ออย่างน้อย 1 รายการ (I9590C)
• เรานำ boundsWithMargins ออกจาก ComplicationSlotState แล้วเนื่องจากซอฟต์แวร์ระบบไม่มีกรณีการใช้งาน (I42e26)
• เราได้เพิ่มการรองรับเวอร์ชันทดลองสำหรับ WeightedElementsComplicationData ซึ่งประกอบด้วยอาร์เรย์ขององค์ประกอบ (น้ำหนักและสี) พร้อมกับข้อความ/ชื่อ/รูปภาพที่ไม่บังคับ แผนภูมินี้อาจแสดงเป็นแผนภูมิวงกลมที่สีต้องสื่อความหมายตามบริบท เนื่องจากโดยทั่วไปแล้วจะไม่มีข้อมูลแทรกสำหรับแสดงผลป้ายกำกับ (I87eea)
• ColorRamps เวอร์ชันทดลองที่เลือกจะใช้โดย RangedValueComplicationData และ GoalProgressComplicationData ตอนนี้คุณสามารถระบุลำดับสีได้สูงสุด 7 สี และธงที่ระบุว่าสีควรแบ่งเป็น 2 สีอย่างเรียบหรือควรแสดงขั้นตอนของสีที่มีขนาดเท่าๆ กัน (I9f5bf)
• มีการเปลี่ยน RangedValueComplicationData.drawSegmented เป็น valueType ซึ่งเป็น int ที่มี ValueType IntDef ที่สอดคล้องกันซึ่งให้ความหมายทางความหมายกับค่าที่เป็นช่วง และอาจมีการนำข้อมูลแทรกไปใช้เพื่อให้มีผลกับการจัดรูปแบบ (I0616B)
• เราได้เพิ่มการรองรับการทดสอบสำหรับ ColorRanges ที่ไม่บังคับไปยัง RangedValueComplicationData แล้ว โดยปกติแล้ว ข้อมูลแทรกจะแสดงเป็นสีตามการเลือกของหน้าปัด แต่บางครั้งก็แสดง ComplicationDataSource เพื่อกำหนดสีที่ดีที่สุด เช่น เมื่อมีความหมายทางอรรถศาสตร์เฉพาะ เช่น สีแดงเป็นสีน้ำเงินสำหรับอุณหภูมิ (I5153a)
• เราได้เพิ่มคำแนะนำ drawSegmented แบบทดลองลงใน RangedValueComplicationData การแสดงภาพนี้จะส่งสัญญาณให้วาดตัวบ่งชี้ค่าตามช่วงด้วยกลุ่มต่างๆ โดยที่ 1 กลุ่ม = 1 หน่วย (I7d7c1)

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

• เราได้เพิ่มความสามารถในการกำหนด ComplicationSlotBounds ตามระบบพิกัดหน้าจอที่กำหนดไว้ล่วงหน้า (I0985d)

เวอร์ชัน 1.1

เวอร์ชัน 1.1.1

10 สิงหาคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.1 แล้ว เวอร์ชัน 1.1.1 มีคอมมิตเหล่านี้

• นี่เป็นรุ่นที่มีการแก้ไขข้อบกพร่อง และขอแนะนำให้ผู้ใช้เวอร์ชัน 1.1.0 อัปเกรด

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

• การเริ่มต้นหน้าปัดไม่พร้อมกันและหากได้รับข้อมูลแทรกก่อนที่หน้าปัดจะพร้อมใช้งาน หน้าปัดจะเข้าไปอยู่ในรายการ pendingInitialComplications และจะนำไปใช้ภายหลัง ขออภัย มีการนำ pendingInitialComplications ไปใช้เร็วเกินไป ซึ่งหมายความว่าจะมีกรอบเวลาในระหว่างการเริ่มต้นหน้าปัดที่จะยังคงใช้งาน pendingInitialComplications ได้และระบบจะเพิกเฉยต่อข้อมูลแทรก ซึ่งตอนนี้ปัญหาได้รับการแก้ไขแล้ว นอกจากนี้ แพตช์นี้จะแก้ไขข้อบกพร่องที่ ComplicationRenderer พยายามโหลดตัวยึดตำแหน่งแบบไม่พร้อมกันอย่างไม่ถูกต้อง ซึ่งทำให้กราฟิกการคอมไพล์ไม่อัปเดตไม่สำเร็จ สุดท้าย แพตช์นี้ได้แก้ไขข้อบกพร่องทางทฤษฎีซึ่งหวังว่าจะต้องรวม pendingInitialComplications หลายรายการ (0d03ba3)

• แก้ไขการติดตายที่อาจเกิดขึ้นใน InteractiveInstanceManager เมื่อ getExistingInstanceOrSetPendingWallpaperInteractiveWatchFaceInstance ถือล็อกไว้นานกว่าที่จำเป็น โดยปกติเราคาดว่า engine.setUserStyle จะรวดเร็ว แต่หากไม่เป็นเช่นนั้น เราก็อาจได้รับการติดตาย/ANR แพตช์นี้จะย้ายการทำงานที่ไม่จำเป็นออกจากล็อก ทำให้อุปกรณ์หยุดทำงาน (5a2adca)

• แก้ไขปัญหาต่างๆ ที่คงWatchFaceServiceไว้ ในบางครั้ง WakeLock อาจเก็บ WatchFaceService ไว้ การเพิ่มการเรียกใช้ release() จะแก้ปัญหานี้ได้ นอกจากนี้ StateFlows ยังสามารถคง WatchFaceService ไว้ ซึ่งการยกเลิกการแก้ไข CoroutineScopes ที่สำคัญนั้น (fd48138)

• เพิ่มระยะหมดเวลาใน awaitDeferredWatchFace* และแก้ไข watchfaceOverlayStyle NullPointerException ในกรณีปกติ คุณไม่ควรหมดเวลารวมถึงหลังจากติดตั้งใหม่ และ DirectBoot ในสถานการณ์ที่ CPU มีภาระงานสูง นอกจากนี้เรายังแก้ไข NPE ด้วยหากมีการเรียก getWatchfaceOverlayStyle หลังจาก close() (a4c3a5a)

เวอร์ชัน 1.1.0

15 มิถุนายน 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0 แล้ว เวอร์ชัน 1.1.0 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 1.0.0

การแก้ไขที่ปรับปรุงใหม่:

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

ข้อมูลแทรกที่ได้รับการปรับปรุง:

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

การเปลี่ยนแปลงอื่นๆ

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

เวอร์ชัน 1.1.0-rc01

18 พฤษภาคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-rc01 แล้ว เวอร์ชัน 1.1.0-rc01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

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

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

• เราได้เพิ่ม drawHighlight ในการทดสอบมากเกินไปซึ่งยอมรับพารามิเตอร์ BoundingArc (I705f8)
• ขณะนี้ XML ของหน้าปัดสนับสนุนการอ้างอิงทรัพยากรแล้ว ซึ่งจะช่วยให้คุณใช้ค่าคงที่เดียวกันได้ทั้งใน XML และโค้ด (I3ef61)
• เราได้เพิ่มความสามารถในการกำหนด ComplicationSlotBounds ในแบบฟอร์ม center_x, center_y, size_x, size_y ตอนนี้คุณยังสามารถใช้หน่วยอื่นๆ (เช่น dp) โดยใช้การอ้างอิงทรัพยากร (Iace98)

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

• แก้ไข runBlockingWithTracing ที่กำลังทำงานในบริบทที่ไม่ถูกต้อง (4f595fe)
• ทำให้ BaseEditorSession.close พร้อมกัน ปัญหาที่ BaseEditorSession.close ทำงานไม่พร้อมกันคือการที่เราปล่อย ComplicationDataSourceInfoRetriever ช้าเกินไปซึ่งจะทำให้เกิดคำเตือนสแปมใน Logcat กรณีนี้อาจไม่เป็นอันตราย แต่สแปมตัวบันทึกดังกล่าวทำให้รบกวนสมาธิและควรหลีกเลี่ยง (35a5308)

เวอร์ชัน 1.1.0-beta02

11 พฤษภาคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-beta02 แล้ว เวอร์ชัน 1.1.0-beta02 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เราได้เพิ่มการรองรับการทดสอบสำหรับ ComplicationData ประเภทใหม่ ซึ่งยังไม่พร้อมสำหรับการใช้งาน แต่โปรดติดตามดูพื้นที่ทำงานนี้

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

• เราได้เพิ่ม BoundingArc ซึ่งเป็นคลาสทดลองที่อธิบายเรขาคณิตของช่องข้อมูลแทรกขอบ เราได้เพิ่มรายการนี้ไปยัง ComplicationSlot รวมถึงนำไปยัง ComplicationSlotState และ WatchFaceMetadataClient แล้ว (I61a40)
• เราได้เพิ่มความสามารถในการรับช่วงการตั้งค่าใน XML ของ UserStyleSetting แล้ว ซึ่งจะช่วยให้คุณลดการพูดรายละเอียดและแชร์การตั้งค่าระหว่างหน้าปัดได้ (Ief841)
• เราได้เพิ่ม ComplicationData ประเภทการทดสอบใหม่ 2 ประเภท ได้แก่ ListComplicationData และ ProtoLayoutComplicationData ขณะนี้ระบบยังไม่รองรับการแสดงผลสำหรับประเภทเหล่านี้ และปัจจุบัน WearOS ไม่รู้จักประเภทเหล่านี้หากเพิ่มลงในไฟล์ Manifest ของ ComplicationDataSource's (I1811C)

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

• แก้ไขการทำให้เป็นอนุกรมประเภท TimeLineEntry เราไม่ได้เรียงลำดับประเภท TimeLineEntry ซึ่งหมายความว่าแคช TimeLineEntries ของประเภท NoData จะได้รับการตีความอย่างไม่ถูกต้องว่ามีประเภทข้อมูลแทรกระดับบนสุดที่นำไปสู่ NPE เมื่อมีการเข้าถึงช่องที่ต้องกรอกที่ไม่มีอยู่ (55ffdf5)
• แก้ไขข้อบกพร่องที่ setComplicationData ช่องไทม์ไลน์ถูกตัด(fb392f5)
• แก้ไขข้อบกพร่องที่ในบางครั้ง runBlockingWithTracing อาจทำให้เกิด NPE(12ca62e)
• แก้ไขข้อบกพร่องที่บางครั้งเราได้รับ ClassNotFoundException: android.support.wearable.complications.ComplicationText เมื่อได้รับข้อมูลแทรก (217942d9)
• แก้ไขข้อบกพร่องใน GlesRenderer.backgroundThreadInitInternal ที่เรียกเฉพาะ onBackgroundThreadGlContextCreated ถ้ามีการเรียก EGL14.eglCreateContext แก้ไขข้อบกพร่องอื่นที่มีข้อบกพร่องของภาพในภาพหน้าจอซึ่งเกิดจาก verticalFlip (c674ad2)
• แก้ไขการตรวจสอบเวอร์ชัน XML WatchFaceService เนื่องจากโหลดจากแพ็กเกจที่ไม่ถูกต้อง (dfa06f3)
• ตอนนี้รูปแบบสายไฟของตัวยึดตำแหน่งใช้ Bundle ด้านใน เราไม่ต้องการให้ตัวยึดตำแหน่งทำลายหน้าปัดที่มีอยู่ ซึ่งอาจใช้ a.s.w.c.ComplicationData ภายใน ก่อนหน้านี้รูปแบบสายไฟของข้อมูล NoDataComplication จะจัดเก็บตัวยึดตำแหน่งในช่องปกติ (มีปัญหาเนื่องจากหน้าปัดเก่าจะแสดงผลสตริงตัวยึดตำแหน่งโดยไม่ได้ตั้งใจ) ตอนนี้เราจึงใช้กลุ่มภายในเพื่อแยกส่วนนี้ทั้งหมด (d5e7bd2)

เวอร์ชัน 1.1.0-beta01

20 เมษายน 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-beta01 แล้ว เวอร์ชัน 1.1.0-beta01 มีการคอมมิตเหล่านี้

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

• ตอนนี้ WatchFaceMetadataClient เมธอด (getUserStyleSchema, getComplicationSlotMetadataMap, getUserStyleFlavors) และ HeadlessWatchFaceClient.getUserStyleFlavors ส่ง RuntimeException ที่ไม่ได้เลือกไว้แทน WatchFaceException แล้ว (I0718A)
• ย้าย WatchFaceMetadataClient.WatchFaceException ออกจากชั้นเรียนเพื่อใช้ซ้ำแล้ว (I4e869)

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

• WatchFaceMetadataClient จะไม่ขัดข้องอีกต่อไปเมื่อส่ง ComplicationSlotBounds บางส่วน (Iaafd)

เวอร์ชัน 1.1.0-alpha05

6 เมษายน 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-alpha05 แล้ว เวอร์ชัน 1.1.0-alpha05 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• ตอนนี้คุณจะบอกแหล่งข้อมูลที่ส่ง ComplicationData ได้ด้วยการตรวจสอบ ComplicationData.dataSource โดยหน้าปัดบางแบบอาจใช้ข้อมูลนี้เพื่อปรับแต่งการแสดงผลข้อมูลแทรก (I44a73)

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

• Renderer.CanvasRenderer และ Renderer.GlesRenderer เลิกใช้งานแล้วเพื่อเปลี่ยนไปใช้ Renderer.CanvasRenderer2 และ Renderer.GlesRenderer2 ซึ่งรองรับ SharedAssets ซึ่งส่งผ่านไปยังเมธอดการแสดงผล สำหรับการทำงานร่วมกันของ Java เราได้แนะนำ ListenableCanvasRenderer2 และ ListenableGlesRenderer2 (I31ffa)
• เพิ่มความสามารถของ @WatchFaceFlavorsExperimental ในการกำหนดรสชาติ - รายการหน้าปัดสไตล์ที่กำหนดค่าไว้ล่วงหน้า (I04dd0)
• ตอนนี้ Renderer.sharedAssets ได้เปลี่ยนเป็น StateFlow แล้ว และได้นำ Renderer.SharedAssetsFactory ที่ไม่ได้ใช้ (I12ac5) ออกไปแล้ว
• UserStyleSchema.userStyleSettings เลิกใช้งานแล้ว (Iba7e3)
• เราได้เพิ่ม HeadlessWatchFaceClient.getUserStyleSchemaDigestHash ซึ่งช่วยให้ HeadlessWatchFaceClient หลีกเลี่ยงค่าใช้จ่ายในการดำเนินการที่ค่อนข้างต่ำในการส่งสคีมาผ่าน AIDL ก่อนที่จะคำนวณแฮชสำหรับไดเจสต์ (I33597)
• เราได้เพิ่ม isUserStyleSchemaStatic ลงใน WatchFaceMetadataClient ซึ่งจะเป็นจริงหากสามารถพึ่งพา UserStyleSchema ได้หากไม่อัปเดต APK ของหน้าปัด (I45a3f)
• เราได้เพิ่ม getDigestHash ไปยัง UserStyleSchema ซึ่งจะคำนวณแฮชไดเจสต์ของสคีมา ข้อมูลนี้ใช้ได้อย่างมีประสิทธิภาพเพื่อพิจารณาว่า UserStyleSchema มีการเปลี่ยนแปลงหรือไม่ (I2063D)
• METADATA_KEY_DATA_SOURCE_DEFAULT_CONFIGURATION_SUPPORTED เปลี่ยนชื่อเป็น METADATA_KEY_DATA_SOURCE_DEFAULT_CONFIG_SUPPORTED (I9ba5d)
• UserStyleSetting.OnWatchEditorData ได้เปลี่ยนชื่อเป็น UserStyleSetting.WatchFaceEditorData ซึ่งมีข้อมูลที่เครื่องมือแก้ไขหน้าปัดใช้เท่านั้น (If3afb)

เวอร์ชัน 1.1.0-alpha04

9 มีนาคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-alpha04 แล้ว เวอร์ชัน 1.1.0-alpha04 มีคอมมิตเหล่านี้

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

• ComplicationData อาจไม่พร้อมใช้งานเสมอไป (เช่น ข้อมูลแทรกที่แคชไว้ซึ่งหมดอายุแล้ว) เราจึงได้ขยาย NoDataComplication ซึ่งมีตัวยึดตำแหน่งข้อมูลแทรกที่ไม่บังคับ และเพิ่ม ComplicationText.PLACEHOLDER, MonochromaticImage.PLACEHOLDER, SmallImage.PLACEHOLDER, PhotoImage.PLACEHOLDER ซึ่งได้รับอนุญาตให้ใช้ได้ในบริบทของตัวยึดตำแหน่ง NoDataComplicationData เท่านั้น หากเลือกตัวยึดตำแหน่งเหล่านี้ให้แสดงด้วยกล่อง/โค้งสีเทา (I6285D)
• เราได้เพิ่ม ComplicationData.getNextChangeInstant ซึ่งจะบอกให้คุณทราบถึง Instant ถัดไปหลังจากการอ้างอิง Instant ซึ่งฟิลด์ข้อมูลแทรกอาจมีการเปลี่ยนแปลง ซึ่งจะใช้เป็นการภายในเพื่อกำหนดเวลาเฟรมสำหรับการอัปเดตข้อมูลแทรก เช่น หากหน้าปัดมักอัปเดต 1 ครั้งต่อนาที การตั้งค่าข้อมูลแทรกของนาฬิกาจับเวลาจะทำให้หน้าปัดอัปเดต 1 ครั้งต่อวินาที (I7ceb2)
• EditorSession.watchFaceId สามารถใช้ได้ใน API ทุกระดับแล้ว นอกจากนี้ ค่าในขณะนี้จะสอดคล้องกับ WatchState.watchFaceInstanceId เสมอ (I323b9)
• คุณไม่จำเป็นต้องใช้ getPendingIntentForTouchEvent API อีกต่อไป เนื่องจากปัญหาพื้นฐานได้รับการแก้ไขในเฟรมเวิร์กแล้ว ดังนั้น API ที่เกี่ยวข้องทั้งหมดจึงถูกนำออก หน้าปัดไม่จำเป็นต้องดำเนินการใดๆ เป็นพิเศษเพื่อให้ PendingIntents เริ่มทำงาน แม้ว่าจะได้กดปุ่มหน้าแรกเมื่อเร็วๆ นี้ก็ตาม (I1f2e8)
• เราได้เพิ่ม RendererParameters.isForScreenShot ซึ่งจะเป็นจริงหากการแสดงภาพเป็นภาพหน้าจอ หน้าปัดบางแบบที่มีภาพเคลื่อนไหวจําเป็นต้องทราบข้อมูลนี้จึงจะทำการปรับเปลี่ยนเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด (I96D99)
• เราได้เพิ่ม WatchFaceExceptionReason ลงใน WatchFaceException เพื่อให้บริบทเกี่ยวกับข้อผิดพลาด (I01d15)
• ระบบนำ ComplicationDataSourceService.onImmediateComplicationRequest ออกแล้ว แต่เพิ่ม ComplicationRequest.immediateResponseRequired แทน เพื่อบ่งบอกว่าผู้ให้บริการต้องตอบกลับอย่างรวดเร็ว (ควรตอบกลับภายใน 100 มิลลิวินาที) โปรดทราบว่าฟังก์ชันนี้ได้รับการปกป้องหลังสิทธิ์ com.google.android.wearable.permission.USE_IMMEDIATE_COMPLICATION_UPDATE ที่เป็นสิทธิ์เฉพาะบุคคล (Ie6b23)
• อัปเดตค่า Nulling ในบริการหลักและ Appcompat ให้ตรงกับ Tiramisu DP2 (I0cbb7)

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

• ตอนนี้แอปหน้าปัดขัดข้องโดยมีข้อยกเว้นหากตรวจสอบสคีมาไม่สำเร็จ (Ia400f)

เวอร์ชัน 1.1.0-alpha03

9 กุมภาพันธ์ 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-alpha03 แล้ว เวอร์ชัน 1.1.0-alpha03 มีคอมมิตเหล่านี้

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

• เราได้เพิ่มการรองรับการทดสอบสำหรับสคีมาสไตล์ลำดับชั้น เราได้เพิ่มพร็อพเพอร์ตี้ใหม่ใน androidx.wear.watchface.style.UserStyleSetting.Option ซึ่งเป็นการตั้งค่าย่อย ซึ่งในช่วงแรกจะใช้โดย ListOption เท่านั้น ซึ่งทำให้สามารถอธิบายลำดับชั้นของรูปแบบเพื่อนำไปใช้โดย UI ของ Editor โดย UserStyle ที่สำคัญไม่มีการเปลี่ยนแปลงและยังคงเป็น Map<String, ByteArray> (Iaf6f4)
• เราได้เพิ่ม WatchFace.OverlayStyle ซึ่งช่วยให้หน้าปัดกำหนดค่าการแสดงผลของการวางซ้อนสถานะระบบได้ (I8520D)
• เราได้เปิดตัว clearWithBackgroundTintBeforeRenderingHighlightLayer พารามิเตอร์ตัวสร้างที่ไม่บังคับใหม่สำหรับ CanvasRenderer (ค่าเริ่มต้นคือ false) หากตั้งค่าเป็น "จริง" ระบบจะล้างแคนวาสด้วยสีแต้มพื้นหลัง (Ie01e5)
• เพิ่มคีย์ข้อมูลเมตา androidx.watchface.complications.datasource.DEFAULT_CONFIGURATION_SUPPORTED ซึ่งอนุญาตให้แหล่งข้อมูลแทรกระบุว่าสามารถระบุค่าเริ่มต้นโดยไม่ต้องมีการกำหนดค่าใดๆ (Icc0d4)
• การแก้ไขหน้าปัดนั้นเป็นเรื่องปกติ จึงจะมีอินสแตนซ์แบบอินเทอร์แอกทีฟและแบบไม่มีส่วนหัว เพื่อประหยัดหน่วยความจำ เราจึงเปิดตัว Renderer.SharedAssets ซึ่งให้ตัวแสดงผลหน้าปัดแชร์ข้อมูลที่เปลี่ยนแปลงไม่ได้ (เช่น พื้นผิวและเครื่องมือให้เฉดสี) ระหว่างอินสแตนซ์ได้ เราเลิกใช้งาน GlesRenderer.setEglConfig และ GlesRenderer.setEglDisplay แล้ว จึงไม่ตั้งใจให้การตั้งค่าเหล่านี้ตั้งค่าได้ ดังนั้น การทำเช่นนั้นจะนำไปสู่ลักษณะการทำงานที่ไม่ได้กำหนดไว้ (I0d9e7)
• เราเพิ่ม setNameResourceId และ setScreenReaderNameResourceId (ซึ่งเป็นทรัพยากรสตริงอ้างอิง) ไปยัง ComplicationSlot.Builder และ Getter ที่เกี่ยวข้องใน androidx.wear.watchface.client.ComplicationSlotState วิธีนี้จะช่วยให้ระบบดึงข้อมูลชื่อ ComplicationSlots เพื่อใช้ในเครื่องมือแก้ไขและโปรแกรมอ่านหน้าจอได้ (If6c6a)
• ตอนนี้ WatchfaceMetadataClient.getUserStyleSchema และ getComplicationSlotMetadataMap โยน WatchFaceException แทน RemoteException แล้ว (I86f11)
• onSynchronousComplicationRequest และฟังก์ชันที่เกี่ยวข้องใน ComplicationDataSourceService ได้เปลี่ยนชื่อเป็น onImmediateComplicationRequest เป็นต้น (I87ba0)
• เครื่องมือแก้ไขหน้าปัดมีพื้นที่บนหน้าจอน้อยกว่าเครื่องมือแก้ไขที่ใช้ร่วมกัน ดังนั้นจึงควรรองรับไอคอนที่แตกต่างกันสำหรับเครื่องมือแก้ไขหน้าปัด แพตช์นี้เพิ่ม OnWatchEditorData (ขณะนี้มีแค่ไอคอน) ไปยัง UserStyleSettings ทั้งหมดและคลาส Option ที่เหมาะสม (If1886)
• เราได้เพิ่ม @JvmOverloads ลงในเครื่องมือสร้างของ ListenableGlesRenderer เพื่อการทำงานร่วมกันของ Java ที่ดียิ่งขึ้น (I2974a)

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

• ตัวสร้างของ ListenableGlesRenderer ได้รับการทำเครื่องหมายเป็น @Throws(GlesException::class) อย่างถูกต้องและตอนนี้คุณสามารถขยายคลาสนี้ใน Java (Iac6d0)
• แก้ไขข้อบกพร่องกับการดำเนินการแตะ PhotoImageComplicationData ครั้งไม่ ได้รับการจัดการอย่างถูกต้อง (I1cc30)

เวอร์ชัน 1.1.0-alpha02

12 มกราคม 2022

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-alpha02 แล้ว เวอร์ชัน 1.1.0-alpha02 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

• เพื่อช่วยในการแก้ไขข้อบกพร่องและการทดสอบ ตอนนี้ ComplicationData และคลาสย่อยที่เกี่ยวข้องได้ลบล้างแฮชโค้ดเท่ากับและเมธอด toString ซึ่งช่วยให้ใช้งานได้ง่ายขึ้น

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

• WatchfaceMetadataClient จะส่ง RemoteExceptions ในกรณีที่เหมาะสมอีกครั้ง ซึ่งทำให้รหัสไคลเอ็นต์สามารถตรวจจับข้อผิดพลาดจากหน้าปัดได้ง่ายขึ้น (I78785)
• ตอนนี้ ComplicationData และคลาสย่อยมีแฮชโค้ด เท่ากับ และ toString แล้ว (I24bc6)

เวอร์ชัน 1.1.0-alpha01

15 ธันวาคม 2021

ปล่อย androidx.wear.watchface:watchface-*:1.1.0-alpha01 แล้ว เวอร์ชัน 1.1.0-alpha01 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

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

      <meta-data
          android:name="androidx.wear.watchface.MULTIPLE_INSTANCES_ALLOWED"
          android:value="true" />
  

• หน้าปัดบางแบบมีสถานะที่ไม่ได้บันทึกไว้ใน UserStyle เพื่อรองรับนี้และอินสแตนซ์หลายรายการ ตอนนี้รหัสอินสแตนซ์ของหน้าปัดจะพร้อมให้ใช้งานผ่าน WatchState.watchFaceInstanceId

• ระบบกำลังแคช ComplicationData อยู่เพื่อให้แสดงข้อมูลแทรกได้ทันทีขณะโหลด บางครั้งระบบแคช ComplicationData ไว้ในหน่วยความจำและบางครั้งก็ทำให้เป็นอนุกรมโดยไลบรารีหน้าปัด เมื่ออนุกรม " TapAction ที่เกี่ยวข้องจะหายไป หากเกิดเหตุการณ์นี้ขึ้น ComplicationData.tapActionLostDueToSerialization จะแสดงผลเป็น true และหน้าปัดควรแสดงผลข้อมูลแทรกแตกต่างออกไป (เช่น เป็นสีเทาหรือกึ่งโปร่งใส) เพื่อบ่งบอกว่าไม่สามารถแตะได้ ระบบจะส่ง ComplicationData ที่อัปเดตแล้วพร้อมกับ tapAction โดยเร็วที่สุด

• คุณไม่ควรแคช ComplicationData บางรายการเป็นเวลานาน ซึ่งเราได้เพิ่มฟีเจอร์ ComplicationDataTimeline ที่เป็นแบบทั่วไปมากขึ้นเพื่อรองรับการใช้งานนี้ ซึ่งอาจใช้เพื่อระบุลำดับของ ComplicationData ที่มีการกำหนดช่วงเวลาในการนำส่งไปยังหน้าปัด ซึ่งสามารถแคชและอัปเดตได้โดยอัตโนมัติ เช่น พยากรณ์อากาศของวันนี้ในช่วงเวลาต่างๆ หรือกิจกรรมในปฏิทินที่กำลังจะมาถึงหลายรายการ ขยาย ComplicationRequestListener ด้วยเมธอด onComplicationDataTimeline ใหม่ ซึ่งคุณสามารถใช้เพื่อส่งคืนข้อมูลนี้

• ขยาย DefaultComplicationDataSourcePolicy แล้วเพื่อให้คุณระบุ ComplicationType ของแหล่งข้อมูลหลักและรองได้

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

• การเปลี่ยนแปลงของ PendingIntentTapListener มีแนวโน้มที่จะถูกเปลี่ยนกลับ เนื่องจากเราแก้ปัญหาพื้นฐานแล้ว (หน้าปัดจะเปิดกิจกรรมไม่ได้เป็นเวลา 5 วินาทีหลังจากกดปุ่มหน้าแรก) ในเฟรมเวิร์กแทน

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

• เปลี่ยน ComplicationData.isCached เป็น tapActionLostDueToSerialization แล้ว ซึ่งมีประโยชน์มากขึ้นในการกำหนดว่าควรแสดงผลช่องข้อมูลแทรกต่างจากเดิมหรือไม่เพื่อส่งสัญญาณว่าแตะช่องข้อมูลแทรกไม่ได้ (I6de2f)
• เพิ่ม ComplicationDataTimeline ไปที่ wear-complication-data-source แล้ว ซึ่งอาจใช้เพื่อระบุลำดับของ ComplicationData ที่มีการกำหนดช่วงเวลาในการนำส่งไปยังหน้าปัด ซึ่งสามารถแคชและอัปเดตได้โดยอัตโนมัติ เช่น พยากรณ์อากาศของวันนี้ในช่วงเวลาต่างๆ หรือกิจกรรมในปฏิทินที่กำลังจะมาถึงหลายรายการ ขยาย ComplicationRequestListener ด้วยเมธอด onComplicationDataTimeline ใหม่ ซึ่งคุณสามารถใช้เพื่อส่งคืนข้อมูลนี้ มี Wrapper ของ Kotlin ใหม่ SuspendingTimelineComplicationDataSourceService สำหรับการระงับบริการแหล่งข้อมูล (Idecdc)
• เพิ่ม PendingIntentTapListener และ WatchFaceControlClient.getPendingIntentForTouchEvent แล้ว สิ่งนี้จะช่วยให้หน้าปัดที่ต้องเปิด Intent เพื่อตอบสนองต่อการแตะเพื่อแก้ปัญหาที่เฟรมเวิร์กบล็อกการเปิดกิจกรรมใหม่เป็นเวลา 5 วินาทีหลังจากที่กดปุ่มหน้าแรก (I98074)
• แนะนำแคช ComplicationData ต่อหน้าปัด จุดประสงค์ของฟีเจอร์นี้คือเพื่อให้หน้าปัดแสดงค่าข้อมูลแทรกที่ทราบล่าสุดเมื่อมีการโหลดจนกว่าระบบจะอัปเดตค่าเหล่านั้นได้ มีเมธอด API ใหม่ WatchFaceControlClient.hasComplicationCache สำหรับ OEM การดำเนินการนี้อาจส่งผลต่อกลยุทธ์ของระบบในการส่งข้อมูลแทรกไปยังหน้าปัด นอกจากนี้ ComplicationData มีพร็อพเพอร์ตี้ isCached และเราขอแนะนําว่าข้อมูลแทรกที่แคชจะแสดงผลต่างออกไป เนื่องจาก tapAction แคชไม่ได้และจะเป็น null ในข้อมูลแทรกที่แคช (I404B0)
• สามารถดูรหัสอินสแตนซ์ของหน้าปัดผ่านทาง WatchState.watchFaceInstanceId ได้แล้ว หน้าปัดส่วนใหญ่ไม่จำเป็นต้องใช้ฟีเจอร์นี้ แต่หากมีสถานะต่อนาฬิกาที่ไม่ได้จัดเก็บไว้ในสคีมา นี่จะเป็นกุญแจสำคัญที่ใช้ระบุอินสแตนซ์ของหน้าปัด คุณสามารถระบุบัตรประจำตัวเมื่อโทรหา WatchFaceControlClient.createHeadlessWatchFaceClient เพื่อช่วยสนับสนุนการดำเนินการนี้ได้แล้ว (I1ff98)
• ขยาย DefaultComplicationDataSourcePolicy ด้วยความสามารถในการตั้งค่า ComplicationTypes เริ่มต้นสำหรับผู้ให้บริการหลัก รอง และผู้ให้บริการระบบสำรอง ComplicationSlot.defaultDataSourceType เลิกใช้งานแล้ว (If0ce3)
• ComplicationSlot.configExtras เปลี่ยนแปลงไม่ได้แล้วและอัปเดตก่อนโทรหา EditorSession.openComplicationDataSourceChooser() ได้ (I6F852)
• เพิ่ม WatchFace.setComplicationDeniedDialogIntent และ setComplicationRationaleDialogIntent แล้ว Intent เหล่านี้เปิดขึ้นเพื่อแสดงกล่องโต้ตอบเหตุผลก่อนขอสิทธิ์ข้อมูลแทรก และกล่องโต้ตอบอีกรายการหนึ่งที่อธิบายว่าจำเป็นต้องใช้สิทธิ์ข้อมูลแทรกเมื่อพยายามแก้ไขข้อมูลแทรกเมื่อสิทธิ์ถูกปฏิเสธ (ตัวเลือกผู้ให้บริการจะเปิดไม่ได้ จึงต้องใช้กล่องโต้ตอบ) (I3a29c)
• คุณสามารถกำหนด UserStyleSchema และ ComplicationSlots ใน XML ได้แล้ว วิธีนี้จะช่วยลดความซับซ้อนในการสร้างหน้าปัดและทำให้การค้นหา WatchFaceMetadataClient รวดเร็วขึ้นเนื่องจากไม่จำเป็นต้องเชื่อมโยงกับบริการเพื่อรับข้อมูลเมตา (I85bfa)
• เพิ่ม InteractiveWatchFaceClient.supportsPendingIntentForTouchEvent แล้วเพื่อให้ไคลเอ็นต์ระบุได้ว่าหน้าปัดรองรับ getPendingIntentForTouchEvent หรือไม่ (I0b917)
• WatchFaceMetadataClient และ ListenableWatchFaceMetadataClient ไม่ใช่เวอร์ชันทดลองอีกต่อไป สามารถใช้เพื่อดูข้อมูลเมตาของหน้าปัดได้อย่างมีประสิทธิภาพ โดยไม่ต้องเปิดแฟ้มบนหน้าปัด (Ibb827)
• เพิ่มการรองรับผู้ให้บริการข้อมูลแทรกแบบพร้อมกันซึ่งมีการอัปเดตข้อมูลแทรกด้วยความถี่สูงกว่าปกติ สูงสุด 1 ครั้งต่อวินาทีเมื่อหน้าปัดปรากฏขึ้นและไม่มีการเคลื่อนไหว หากต้องการใช้ผู้ให้บริการรายนี้ ต้องใส่แท็กข้อมูลเมตา androidx.wear.watchface.complications.data.source.SYNCHRONOUS_UPDATE_PERIOD_SECONDS ใหม่ในไฟล์ Manifest และลบล้าง onSynchronousComplicationRequest นอกจากนี้ ยังอาจต้องลบล้าง onStartSynchronousComplicationRequests และ onStopInteractiveComplicationRequests เพื่อรับการแจ้งเตือนเมื่อข้อมูลแทรกเข้าและออกจากโหมดอินเทอร์แอกทีฟ ทั้งนี้ขึ้นอยู่กับลักษณะของแหล่งข้อมูล (I8fe9d)

รุ่น 1.0

เวอร์ชัน 1.0.1

9 กุมภาพันธ์ 2022

ปล่อย androidx.wear.watchface:watchface-*:1.0.1 แล้ว เวอร์ชัน 1.0.1 มีคอมมิตเหล่านี้

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

• แก้ไขข้อบกพร่องกับการดำเนินการแตะ PhotoImageComplicationData ครั้งไม่ ได้รับการจัดการอย่างถูกต้อง (I1cc30)

เวอร์ชัน 1.0.0

1 ธันวาคม 2021

ปล่อย androidx.wear.watchface:watchface-*:1.0.0 แล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้

ฟีเจอร์หลักของ 1.0.0

แพ็กเกจ androidx.wear.watchface เป็นคลังใหม่ที่แนะนำสำหรับการพัฒนาหน้าปัดนาฬิกา WearOS โดยมีฟีเจอร์ใหม่ๆ มากมายในไลบรารีการสนับสนุนอุปกรณ์ที่สวมใส่ได้เวอร์ชันเดิม

• การจัดรูปแบบของผู้ใช้ (เช่น ในการเปลี่ยนชุดสี รูปแบบของเข็มนาฬิกา ลักษณะของเครื่องหมายชั่วโมง ฯลฯ) ได้รับการรองรับจากไลบรารีโดยตรง (ดู androidx.wear.watchface.style) ตอนนี้คุณสามารถพัฒนาเครื่องมือแก้ไขหน้าปัดด้วย androidx.wear.watchface.editor ได้ง่ายขึ้น ทั้งยังแก้ไขหน้าปัดจากแอปที่ใช้ร่วมกันของระบบได้โดยไม่ต้องเขียนโค้ดเพิ่มเติมด้วย
• มีแนวทางปฏิบัติแนะนำรวมอยู่ด้วย ไลบรารีจะสร้างป้ายกำกับเนื้อหาโปรแกรมอ่านหน้าจอโดยอัตโนมัติสำหรับข้อมูลแทรก (คุณสามารถเพิ่มป้ายกำกับของคุณเองได้ด้วย) และอัตราเฟรมจะลดลงโดยอัตโนมัติเมื่อแบตเตอรี่เหลือน้อยและไม่ชาร์จเพื่อเพิ่มอายุการใช้งานแบตเตอรี่
• จำเป็นต้องใช้โค้ดน้อยลงในการพัฒนาหน้าปัด โดยเฉพาะสำหรับข้อมูลแทรกที่เทมเพลตต้นแบบจำนวนมากย้ายไปอยู่ในไลบรารี

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

• แก้ไข EditorSession.userStyle.compareAndSet (I6f676)
• แก้ไขความล่าช้าของหน้าปัดที่สั้นมาก (Iffb97)
• ส่ง InteractiveWatchFaceImpl.onDestroy ในชุดข้อความ UI (I83340)
• แก้ไขปัญหาต่างๆ เกี่ยวกับ Broadcast Receiver (I7d25f)

เวอร์ชัน 1.0.0-rc01

3 พฤศจิกายน 2021

ปล่อย androidx.wear.watchface:watchface-*:1.0.0-rc01 แล้ว เวอร์ชัน 1.0.0-rc01 มีคอมมิตเหล่านี้

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

• แก้ไข dump() (เรียกโดย adb shell dumpsys) ที่เสียหายจากการย้ายข้อมูลโฟลว์ (087cf9e)

• ตรวจสอบว่า WriteDirectBootPrefs เรียงลำดับอย่างถูกต้อง เราต้องการให้ WriteDirectBootPrefs ทำงานหลังจาก initStyleAndComplications เสมอ มิฉะนั้นเราอาจเสี่ยงที่จะทำให้ชุดข้อความ UI init (37650ac) ทำงานล่าช้า

• ตรวจสอบว่าได้เรียก Renderer.onDestroy แล้ว ในกรณีที่มีการสร้างตัวแสดงผลแล้ว แต่ WF init ยังไม่เสร็จสมบูรณ์และมีการเรียก Engine.onDestroy เราจะต้องเรียก Renderer.onDestroy (f9952dc)

• การเพิ่มประสิทธิภาพ/แก้ไข isBatteryLowAndNotCharging แพตช์นี้ย้ายการตั้งค่าเริ่มต้นของ isBatteryLowAndNotCharging ก่อนหน้านี้ ซึ่งหมายความว่าสามารถดำเนินการพร้อมกันได้กับ createWatchFace นอกจากนี้ เรายังฟัง ACTION_POWER_DISCONNECTED ด้วย (ddffd80

• InteractiveWatchFaceClientImpl.isConnectionAlive เป็นเท็จหลังจากปิด (ab9774e)

เวอร์ชัน 1.0.0-beta01

27 ตุลาคม 2021

ปล่อย androidx.wear.watchface:watchface-*:1.0.0-beta01 แล้ว เวอร์ชัน 1.0.0-beta01 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha24

13 ตุลาคม 2021

ปล่อย androidx.wear.watchface:watchface-*:1.0.0-alpha24 แล้ว เวอร์ชัน 1.0.0-alpha24 มีคอมมิตเหล่านี้

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

• ย้ายชั้นเรียนในแพ็กเกจ androidx.wear.watchface.complications ไปยังโปรเจ็กต์ wear:watchface:watchface-complications ใหม่แล้ว โปรดทราบว่าการดำเนินการนี้หมายความว่าคุณไม่สามารถรวมไลบรารีนี้ รวมทั้งเวอร์ชันอัลฟ่าของ wear:watchface:watchface-complications-data เวอร์ชันก่อนหน้า เนื่องจากจะได้รับข้อผิดพลาดเกี่ยวกับชั้นเรียนที่ซ้ำกัน (I97195)
• Renderer.dump ได้เปลี่ยนชื่อเป็น Renderer.onDump แล้ว และมีการใส่คำอธิบายประกอบเป็น @UiThread (I44845)
• InteractiveWatchFaceClient.addWatchFaceReadyListener ถูกเปลี่ยนชื่อเป็น addOnWatchFaceReadyListener และ removeWatchFaceReadyListener ถูกเปลี่ยนชื่อเป็น removeOnWatchFaceReadyListener (I48fea)
• EditorSession getComplicationsPreviewData และ getComplicationsDataSourceInfo จะไม่ระงับฟังก์ชันอีกต่อไป แต่เป็นพร็อพเพอร์ตี้ StateFlow<> ที่มีค่าเป็น Null ในตอนแรก ใน ListenableEditorSession getListenableComplicationPreviewData และ getListenableComplicationsProviderInfo ถูกนำออกเพื่อแทนที่ออบเจ็กต์ StateFlow<> ใหม่จากคลาสพื้นฐาน หากคุณอยากฟังการเปลี่ยนแปลงในโค้ด Java ลองใช้ androidx.lifecycle.FlowLiveDataConversions.asLiveData เพื่อแปลงเป็น LiveData<> (Ic5483)

เวอร์ชัน 1.0.0-alpha23

29 กันยายน 2021

ปล่อย androidx.wear.watchface:watchface-*:1.0.0-alpha23 แล้ว เวอร์ชัน 1.0.0-alpha23 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

ตอนนี้ไลบรารีหน้าปัดรวมเป็นกลุ่มไลบรารีเดียวแล้ว ด้วยเหตุนี้ ไลบรารีจึงย้ายไปแล้ว และคุณจะต้องอัปเดตการนำเข้า Gradle ดังนี้

เครื่องเก่า	ใหม่
androidx.wear:wear-complications-data	androidx.wear.watchface:watchface-complications-data
androidx.wear:wear-complications-data-source	androidx.wear.watchface:watchface-complications-data-source
androidx.wear:wear-watchface	androidx.wear.watchface:watchface
androidx.wear:wear-watchface-complications-rendering	androidx.wear.watchface:watchface-complications-rendering
androidx.wear:wear-watchface-client	androidx.wear.watchface:watchface-client
androidx.wear:wear-watchface-client-guava	androidx.wear.watchface:watchface-client-guava
androidx.wear:wear-watchface-data	androidx.wear.watchface:watchface-data
androidx.wear:wear-watchface-editor	androidx.wear.watchface:watchface-editor
androidx.wear:wear-watchface-editor-guava	androidx.wear.watchface:watchface-editor-guava
androidx.wear:wear-watchface-guava	androidx.wear.watchface:watchface-guava
androidx.wear:wear-watchface-style	androidx.wear.watchface:watchface-style

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

• ย้ายข้อมูลคลังหน้าปัด androidx.wear และข้อมูลแทรกที่แยกต่างหากไปยังกลุ่มคลัง androidx.wear.watchface (b25f3c0)
• เพิ่ม EditorRequest.canWatchFaceSupportHeadlessEditing เพื่อแจ้งให้ไคลเอ็นต์ทราบว่าเครื่องมือแก้ไขหน้าปัดรองรับการแก้ไขแบบไม่มีส่วนหัวหรือไม่ โปรดทราบว่าจะมีความผิดพลาดเท็จบางอย่างในลักษณะนี้ เนื่องจากมีการเพิ่มการรองรับใน asop/1756809 อย่างไรก็ตาม จะมีการแสดงค่าที่ถูกต้องสำหรับหน้าปัดในอนาคตทั้งหมด (ca55590)
• ตอนนี้ตัวแสดงผลมีเมธอด dump() ซึ่งสามารถลบล้างเพื่อเพิ่มข้อมูลที่กำหนดเองลงในข้อมูลที่สร้างโดยบริการกิจกรรม WatchFaceService ของ ABD shell dumpsys (95235f9)
• ตอนนี้ InteractiveWatchFaceClient.addWatchFace ReadyListener จะระบุผู้ดำเนินการก่อนแล้ว (563ac2f)
• นำ StateFlowCompatHelper ออกแล้ว ควรใช้ asLiveData (androidx.lifecycle.asLiveData) แทน (bd35d3)
• CurrentUserStyleRepository.userStyle เปลี่ยนแปลงไม่ได้แล้ว (I44889)
• WatchFace ReadyListener เปลี่ยนชื่อเป็น OnWatchFace ReadyListener แล้ว ) แล้ว (Ic12a9)

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

• InteractiveInstanceManager.deleteInstance เพื่อเรียก onDestroy ซึ่งจำเป็นต้องดำเนินการดังกล่าวเพื่อให้แน่ใจว่า InteractiveWatchFaceImpl จะได้รับข้อมูลขยะ (fce4af8, b/199485839)