Wear स्मार्टवॉच की होम स्क्रीन

डिपेंडेंसी तय करना

Wear पर डिपेंडेंसी जोड़ने के लिए, आपको अपने प्रोजेक्ट. Google की Maven रिपॉज़िटरी पढ़ें हमारा वीडियो देखें.

उन आर्टफ़ैक्ट की डिपेंडेंसी जोड़ें जिनकी आपको 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"
}

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"
}

डिपेंडेंसी के बारे में ज़्यादा जानकारी के लिए, बिल्ड डिपेंडेंसी जोड़ना लेख पढ़ें.

सुझाव

आपके सुझाव, शिकायत या राय से Jetpack को बेहतर बनाने में मदद मिलती है. अगर आपको नई समस्याओं का पता चलता है या आपको इस लाइब्रेरी को बेहतर बनाने के लिए आइडिया मिल सकते हैं. कृपया, इस मौजूदा समस्याएं इस लाइब्रेरी में जोड़ें. किसी मौजूदा समस्या के लिए अपना वोट दें. इसके लिए ये तरीके अपनाएं: स्टार बटन पर क्लिक करके ऐसा किया जा सकता है.

नई समस्या जोड़ें

समस्या को ट्रैक करने वाले टूल से जुड़ा दस्तावेज़ देखें हमारा वीडियो देखें.

वर्शन 1.3

वर्शन 1.3.0-alpha03

17 अप्रैल, 2024

androidx.wear.watchface:watchface-*:1.3.0-alpha03 रिलीज़ हो गया है. वर्शन 1.3.0-alpha03 में ये कमिट मौजूद हैं.

एपीआई में किए गए बदलाव

• हमने EditorSession#setOverrideComplications को जोड़ा है. इससे बदलाव करते समय, कुछ समय के लिए स्मार्टवॉच की होम स्क्रीन के इंस्टेंस के ComplicationData को सेट किया जाता है. अगर Android घड़ी के विजेट में बार-बार बदलाव नहीं होता है, तो यह 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)

एपीआई में किए गए बदलाव

• हमने 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 के साथ आज़माना है.

एपीआई में किए गए बदलाव

• StatefulWatchFaceService अब getComplicationSlotInflationFactory को ओवरराइड करने की सुविधा देता है, जिसमें createExtra() का बनाया गया अतिरिक्त नियम पास किया जाता है. (I82d9f)
• स्मार्टवॉच की कुछ होम स्क्रीन को, createUserStyleSchema के दौरान बनाए गए सहायक डेटा को शुरू करने के दूसरे तरीकों के साथ शेयर करना होगा. इससे बेहतर कोई विकल्प नहीं था. इसलिए, डेवलपर ने आम तौर पर अपने WatchFaceServices को स्टेटफ़ुल बना दिया. यह खतरनाक है, क्योंकि एक साथ कई इंस्टेंस बनाए जा सकते हैं, जिनकी वजह से गड़बड़ियां पैदा हो सकती हैं. इस समस्या को हल करने के लिए, हमने StatefulWatchFaceService और StatefulWatchFaceRuntimeService पेश किए हैं. इनके तहत, createExtra() ने उपयोगकर्ता की ओर से तय किया गया टाइप बनाया है और उसे पैरामीटर के तौर पर, बनाने के अलग-अलग तरीकों में पास किया है. (If8a99)
• हमने InteractiveWatchFaceClient में getUserStyleFlavors जोड़ा है. यह मुख्य तौर पर OEM को पसंद है. (I0f5d8)
• GlesRenderer2 में अब एक कंस्ट्रक्टर ओवरलोड है. इसकी मदद से, ऐसे एट्रिब्यूट की सूची बनाई जा सकती है जिन्हें eglChooseConfig के साथ आज़माना है. उदाहरण के लिए, इसकी मदद से पहले एंटी-एलियासिंग कॉन्फ़िगरेशन वाले कॉन्फ़िगरेशन को आज़माया जा सकता है. साथ ही, ज़रूरत पड़ने पर किसी कॉन्फ़िगरेशन पर फ़ॉलबैक भी किया जा सकता है. (I1ba74)
• Android U से, SystemDataSources.DATA_SOURCE_HEART_RATE के लिए सहायता WearOS में जोड़ दी जाएगी. इस विजेट से, सिर्फ़ SHORT_TEXT Android घड़ी के विजेट पर काम करने की गारंटी है. हालांकि, ComplicationSlot को भी SMALL_IMAGE को स्वीकार करने का सुझाव दिया जाता है. ऐसा इसलिए, क्योंकि OEM, लाइव वैल्यू के बजाय सेहत से जुड़े ऐप्लिकेशन का शॉर्टकट इस्तेमाल कर सकते हैं. (I34223)
• हमने METADATA_KEY_CONFIG_RESTORE_SUPPORTED को जोड़ा है. Android U के बाद से ही यह सुविधा काम करती है. इससे यह कंट्रोल किया जाता है कि Android U के METADATA_KEY_DATA_SOURCE_CONFIG_ACTION वाले चरण में, Android घड़ी के विजेट के बैकअप से सिस्टम को वापस लाने पर क्या होगा. डिफ़ॉल्ट रूप से, सिस्टम यह मान लेता है कि Android घड़ी के विजेट के लिए, किसी भी कॉन्फ़िगरेशन डेटा का बैकअप लेने की सुविधा काम करती है. अगर ऐसा नहीं होता है, तो यह मेटाडेटा सेटिंग METADATA_KEY_DATA_SOURCE_CONFIG_ACTION को 'गलत' पर जोड़ देगा. इससे, Android घड़ी के विजेट की सेटिंग को 'कॉन्फ़िगर नहीं किया गया' के तौर पर मार्क कर दिया जाएगा. (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 के विजेट के लिए, कुछ नए Android विजेट उपलब्ध कराए हैं:
  • GoalProgressComplicationData जो RangedValueComplicationData से मिलता-जुलता है. हालांकि, यह उस लक्ष्य की प्रोग्रेस के लिए है जिसमें कम से कम वैल्यू शून्य है और वैल्यू targetValue से ज़्यादा हो सकती है.
  • WeightedElementsComplicationData में एलिमेंट (वज़न और रंग के जोड़े) के कलेक्शन के साथ-साथ टेक्स्ट/टाइटल/इमेज का कलेक्शन होता है. इन्हें पाई चार्ट के तौर पर दिखाया जा सकता है, जहां कॉन्टेक्स्ट के हिसाब से कलर का सही तरह से होना ज़रूरी है. इसकी वजह यह है कि लेबल को रेंडर करने के लिए, विजेट में आम तौर पर जगह नहीं होती है.
• हमने RangedValueComplicationData में ColorRanges के लिए सहायता जोड़ दी है. हालांकि, इसका इस्तेमाल करना ज़रूरी नहीं है. आम तौर पर, विजेट को स्मार्टवॉच की होम स्क्रीन के हिसाब से कलर सेट किया जाता है.हालांकि, कभी-कभी कलर सेट करने के लिए ComplicationDataSource को सबसे सही तरीके से सेट किया जाता है. उदाहरण के लिए, जब उनका कोई खास मतलब होता है. उदाहरण के लिए, तापमान मापने के लिए लाल से नीला.
• अब करीब-करीब हर तरह का ComplicationData, SmallImages के साथ काम करता है.
• हमने ComplicationDisplayPolicy को जोड़ा है. इसके तहत DO_NOT_SHOW_WHEN_DEVICE_LOCKED ने स्मार्टवॉच की ऐसी होम स्क्रीन को निर्देश दिया है जो इस सुविधा के साथ काम करती है. साथ ही, डिवाइस लॉक होने पर Android स्मार्टवॉच के विजेट को नहीं दिखाने का निर्देश दिया गया है.
• Android T के बाद, OEM यह पता लगा पाएंगे कि Android घड़ी के विजेट का अनुरोध, स्मार्टवॉच की किसी होम स्क्रीन से किया गया है या नहीं. यह सूची, उस सूची में मौजूद होती है जिसे ऐप्लिकेशन उपलब्ध कराने वाली कंपनी के मेनिफ़ेस्ट में ComplicationRequest#isForSafeWatchFace ने android.support.wearable.complications.SAFE_WATCH_FACES के मेटाडेटा के तहत तय किया है. TargetWatchFaceSafety.UNKNOWN` के अलावा कोई भी अन्य जानकारी पाने के लिए, सेवा देने वाली कंपनी को com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE की अनुमति की ज़रूरत होगी.
• 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 अब खुल गया है. कृपया ध्यान दें कि सिस्टम की डिफ़ॉल्ट मौसम विजेट की सुविधा हटा दी गई है.

एपीआई में किए गए बदलाव

• "मौसम से जुड़े विजेट के लिए नया डेटा सोर्स दिखाएं" को पहले जैसा करें. (I6f335)

वर्शन 1.2.0-beta01

23 अगस्त, 2023

androidx.wear.watchface:watchface-*:1.2.0-beta01 रिलीज़ हो गया है. वर्शन 1.2.0-beta01 में ये कमिट मौजूद हैं.

नई सुविधाएं

• Android T के बाद, WearOS का इस्तेमाल अब डिफ़ॉल्ट मौसम सिस्टम Android घड़ी के विजेट के साथ किया जा सकेगा.

एपीआई में किए गए बदलाव

• Android घड़ी के विजेट के लिए, मौसम की जानकारी के लिए डिफ़ॉल्ट सिस्टम फ़ॉलबैक जोड़ें. (Ia0994)
• इस पैच में अमरूद के रैपर के साथ WatchFaceRuntimeService और WatchFaceControlClient.createWatchFaceRuntimeControlClient जोड़े जाते हैं. इन सुविधाओं की मदद से, स्मार्टवॉच की होम स्क्रीन के रनटाइम पर आसानी से काम किया जा सकता है. स्मार्टवॉच की होम स्क्रीन एक खास तरह की होती है, जो इसे किसी दूसरे पैकेज में लोड करती है. फ़िलहाल, WearOS रनटाइम के साथ सिर्फ़ Android Watch Face Format का रनटाइम काम करता है. (I2799f)
• यह पैच aosp/2636578 का फ़ॉलो अप है, जहां हम int डिफ़ेंस का नाम बदलते हैं, ताकि WatchFaceType, CanvasType, TapType या ComplicationsSlotBoundsType के आधार पर किसी भी कोड को बदलने की ज़रूरत न पड़े. (I4098b)
• एपीआई फ़ाइलों को अपडेट किया गया, ताकि वे एपीआई के साथ काम करने की सुविधा बंद करने की जानकारी दे सकें. (I8e87a, b/287516207)
• इस पैच में WatchFaceTypes में WatchFaceType कॉन्सटेंट, CanvasTypes में CanvasType कॉन्सटेंट, TapTypes में TapType और 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 की सब-क्लास के तौर पर उपलब्ध है. ये दोनों, डाइनैमिक एक्सप्रेशन के साथ-साथ प्लैटफ़ॉर्म बाइंडिंग का इस्तेमाल कर सकते हैं. इसे Wear 4 के साथ काम करने वाले डिवाइसों पर, 1hz पर अपडेट किया जाता है.

एपीआई में किए गए बदलाव

• हर दिन की दूरी, हर दिन की कैलोरी, और हर दिन के फ़्लोर के लिए डाइनैमिक टाइप जोड़े गए. प्लैटफ़ॉर्म के हेल्थ सोर्स की कुंजियां, अब PlatformHealthSources.Keys (Ib7637) से कम हैं
• धड़कन की दर और हर दिन चले गए कदमों की जानकारी देने के लिए, PlatformDataProvider लागू करें. SensorGateway इंटरफ़ेस को सार्वजनिक एपीआई से हटाया गया. (I55b84)
• StateEntryValue का नाम बदलकर DynamicDataValue करें. साथ ही, DynamicDataKey का इस्तेमाल करने के लिए, स्टेट एपीआई अपडेट करें. (If1c01)
• ऐप्लिकेशन को पुश किए जाने की स्थिति को ऐक्सेस करने के लिए AppDataKey जोड़ें; प्लैटफ़ॉर्म का डेटा ऐक्सेस करने के लिए, PlatformDataKey जोड़ें; StateStore में नेमस्पेस सहायता जोड़ें. (I7985e)
• DynamicTypeEvaluator से disablePlatformSource में से enable तरीके को हटा दिया गया है. कॉलर को अपडेट के लिए ज़िम्मेदार होना चाहिए. (I78c6d)
• बाउंड डेटा टाइप के साइज़ की सीमा तय करने की अनुमति दें. (Ie2966)

वर्शन 1.2.0-alpha08

19 अप्रैल, 2023

androidx.wear.watchface:watchface-*:1.2.0-alpha08 रिलीज़ हो गया है. वर्शन 1.2.0-alpha08 में ये कमियां हैं.

नई सुविधाएं

• Android T के Android वर्शन के साथ, Android घड़ी के विजेट देने वाली कंपनियां, androidx.wear.watchface.complications.datasource.SAFE_WATCH_FACE_SUPPORTED_TYPES मेटाडेटा को रजिस्टर कर सकती हैं. यह मेटाडेटा, स्मार्टवॉच की सुरक्षित होम स्क्रीन के लिए android.support.wearable.complications.SUPPORTED_TYPES को बदल देता है.com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE इसका मतलब है कि Android घड़ी के विजेट देने वाला, भरोसेमंद और गैर-भरोसेमंद स्मार्टवॉच की होम स्क्रीन को अलग-अलग तरह का बना सकता है.

एपीआई में किए गए बदलाव

• @Deprecated क्लास को प्रॉपर्टी पर लागू करना (I882d1, b/271441831)
• Enum.valueOf के लिए मान पैरामीटर का नाम बदला गया (Ia9b89)
• enum valueOf (I818fe) से अलग-अलग अपवाद हैं
• हमने createRemoteWatchFaceView के लिए renderWatchFaceToSurface को हटा दिया है. इसे SurfaceControlViewHost में सबसे ऊपर बनाया गया है. साथ ही, इससे कॉलर को स्मार्टवॉच की होम स्क्रीन से कोई व्यू एम्बेड करने की अनुमति मिलती है, जो क्लाइंट के RemoteWatchFaceViewHost#renderWatchFace को कॉल करने पर रेंडर होता है. (Ib311d)
• हमने renderWatchFaceToSurface को InteractiveWatchFaceClient, HeadlessWatchFaceClient, और EditorSession में जोड़ा है. आम तौर पर, यह बिट मैप में रेंडर करने के मुकाबले ज़्यादा बेहतर काम करेगा. (Ieacad)
• ObservableStateStore का नाम बदलकर StateStore कर दिया गया है. (Ieb0e2)
• ज़्यादा वैकल्पिक आर्ग्युमेंट को अनुमति देने के लिए, कंस्ट्रक्टर आर्ग्युमेंट के बजाय, DynamicTypeEvaluator.Builder को जोड़ा गया. इनमें ObservableStateStore भी शामिल है, जो अब डिफ़ॉल्ट रूप से किसी खाली स्टोर पर सेट है. (I6f832)
• DynamicTypeEvaluator में पैरामीटर का क्रम बदला गया. (Ic1ba4)
• एक्ज़िक्यूटर को DynamicTypeEvaluator.bind तरीकों में जोड़ दिया गया है. (I346ab)
• हमने डाइनैमिक टाइप के बाउंड होने के बाद, इवैलुएशन को ट्रिगर करने के लिए, BoundDynamicType में startEvaluation तरीका जोड़ा है. (I19908)
• स्मार्टवॉच के लिए खास अधिकार वाले com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE के मामले में, Android घड़ी के लिए बने विजेट, 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 घड़ी के विजेट का अनुरोध, स्मार्टवॉच की किसी होम स्क्रीन से किया गया है या नहीं. यह सूची, उस सूची में मौजूद होती है जिसे ऐप्लिकेशन उपलब्ध कराने वाली कंपनी के मेनिफ़ेस्ट में ComplicationRequest#isForSafeWatchFace ने android.support.wearable.complications.SAFE_WATCH_FACES के मेटाडेटा के तहत तय किया है. TargetWatchFaceSafety.UNKNOWN के अलावा कोई भी अन्य जानकारी पाने के लिए, सेवा देने वाली कंपनी को com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE की अनुमति की ज़रूरत होगी.

• Android T के CustomValueUserStyleSetting2 वाले Android ऐप्लिकेशन को भी इस्तेमाल किया जा सकता है. इसे 12.5 केबी तक सेव किया जा सकता है. CustomValueUserStyleSetting के लिए पिछली सीमा 1 केबी थी. साइज़ की बढ़ी हुई सीमा के बावजूद, स्मार्टवॉच की होम स्क्रीन के डेवलपर को डेटा का साइज़ छोटा रखने के लिए बढ़ावा दिया जाता है. ऐसा इसलिए, क्योंकि बदलाव करने के दौरान ब्लूटूथ का इस्तेमाल करके सेटिंग तय की जाती हैं. ब्लूटूथ बैंडविथ सीमित होता है.

एपीआई में किए गए बदलाव

• हमने GlesRenderer और में एक वैकल्पिक पैरामीटर eglContextAttribList जोड़ा है GlesRenderer2 की मदद से, EGL14.eglCreateContext पर पास किए गए EGL14.EGL_CONTEXT_CLIENT_VERSION को सेट किया जा सकता है. (I2a83e)
• हमने स्मार्टवॉच की होम स्क्रीन पर ली गई लिब्स को java.util.function.Consumer के बजाय androidx.core.util.Consumer पर माइग्रेट कर दिया है. (I273f5)
• KT प्रॉपर्टी ऐक्सेस करने वालों से मिले अपवाद (Iff9d9)
• हमने InteractiveWatchFaceClient.isComplicationDisplayPolicySupported को जोड़ा है, ताकि क्लाइंट यह तय कर सके कि उसे स्मार्ट वॉच की पुरानी होम स्क्रीन की तरफ़ से सहायता देनी है या नहीं. (I24c89)
• हमने तय किया है कि isForSafeWatchFace को एक तीन राज्य IntDef होना चाहिए. (Ief2f7)
• Android T के लिए, हमने ComplicationRequest.isForSafeWatchFace लॉन्च किया है. यह OEM के इस्तेमाल के लिए है और इसके लिए com.google.wear.permission.GET_IS_FOR_SAFE_WATCH_FACE की ज़रूरत है. सिस्टम इमेज में मौजूद डेटा सोर्स के लिए, यह विकल्प तब सही दिखाएगा, जब स्मार्टवॉच की होम स्क्रीन, उस सूची में हो जिसे डेटा सोर्स के मेनिफ़ेस्ट में बताया गया है. (I0cbb6)
• Android T के लिए, हमने CustomValueUserStyleSetting2 जोड़ा है जो 12.5kb तक सेव हो सकता है. CustomValueUserStyleSetting के लिए पिछली सीमा 1 केबी थी. (I0b100)

वर्शन 1.2.0-alpha06

25 जनवरी, 2023

androidx.wear.watchface:watchface-*:1.2.0-alpha06 रिलीज़ हो गया है. वर्शन 1.2.0-alpha06 में ये कमियां हैं.

नई सुविधाएं

• Android स्मार्टवॉच के Android घड़ी के विजेट पर काम चल रहा है. फ़िलहाल, इस सुविधा का इस्तेमाल नहीं किया जा सकता. हालांकि, हमारे साथ बने रहें!
• हमने Android घड़ी के नए विजेट के टाइप, GOAL_PROGRESS और WEIGHTED_ELEMENTS के लिए एक्सएमएल ComplicationSlot सहायता जोड़ दी है.

गड़बड़ियां ठीक की गईं

• Samsung डिवाइसों पर स्मार्टवॉच की होम स्क्रीन के एडिटर को सही तरीके से रिलीज़ न करने की वजह से हुई समस्या को ठीक किया गया है. (3b5987)
• स्मार्टवॉच की होम स्क्रीन पर एक से ज़्यादा पसंदीदा होम स्क्रीन स्विच करने पर, कभी-कभी Android घड़ी के विजेट ठीक से नहीं दिखते हैं, तो उसका समाधान किया गया है. (b38ece)
• PerOptionScreenReaderNames के साथ सीरियलाइज़ेशन की गड़बड़ी को ठीक किया गया जिसकी वजह से स्मार्ट वॉच की होम स्क्रीन क्रैश हो जाती है. (e9f466)

वर्शन 1.2.0-alpha05

7 दिसंबर, 2022

androidx.wear.watchface:watchface-*:1.2.0-alpha05 रिलीज़ हो गया है. वर्शन 1.2.0-alpha05 में ये कमियां हैं.

नई सुविधाएं

• कुछ समय पहले हमने हैरारकी वाले UserStyleSettings के लिए सहायता जोड़ी थी. अब Android T की मदद से, क्रम में एक से ज़्यादा ComplicationSlotsUserStyleSetting जोड़े जा सकते हैं. उपयोगकर्ता की चुनी गई स्टाइल के आधार पर, सिर्फ़ एक ComplicationSlotsUserStyleSetting चालू होगा.

• हम screenReaderName फ़ील्ड जोड़कर, ListOption और ComplicationSlotsOption के लिए स्क्रीन रीडर की सुविधा को बेहतर बना रहे हैं. ध्यान दें कि Android T से पहले के वर्शन पर, साथी संपादक इस फ़ील्ड को अनदेखा कर देंगे.

एपीआई में किए गए बदलाव

• हमने संपादकों के इस्तेमाल के लिए ListOption और ComplicationSlotsOption में एक नया वैकल्पिक screenReaderName फ़ील्ड जोड़ा है - Android T से पहले के डिवाइस पर साथी संपादक इसे अनदेखा कर देंगे. (I75326)
• Android T के कई ComplicationSlotsUserStyleSettings अब स्टाइल के हिसाब से काम करते हैं. हालांकि, इसके लिए ज़रूरी है कि उनमें से सिर्फ़ एक एक समय पर चालू हो. हमने UserStyleSchema में एक यूटिलिटी फ़ंक्शन findComplicationSlotsOptionForUserStyle जोड़ा है, ताकि अगर कोई चालू 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 के लिए, हमने दो नए तरह के Android विजेट GoalProgressComplicationData और WeightedElementsComplicationData पर काम करने की सुविधा जोड़ी है.
• GoalProgressComplicationData की वैल्यू, RangedValueComplicationData से मिलती-जुलती है. हालांकि, इसकी वैल्यू को टारगेट से बाहर रखा जा सकता है (RangedValueComplicationData के लिए, वैल्यू को [कम से कम .. ज़्यादा से ज़्यादा] की रेंज में जोड़ा जाता है). इसका विज़ुअल डिज़ाइन कुछ हद तक दिखता है, जो शायद स्मार्टवॉच की सभी होम स्क्रीन के हिसाब से न हो.
• GoalProgressComplicationData, पाई चार्ट और आसान डेटा के मिलते-जुलते ब्रेकडाउन के लिए काम करता है.
• हमने RangedValueComplicationData में ColorRamps के लिए, वैकल्पिक सहायता जोड़ी है.
• Android T के लिए, हमने ComplicationPersistencePolicy और setCachePolicy को ComplicationData में जोड़ा है.इसकी मदद से, सेवा देने वाली कंपनी यह कंट्रोल कर सकती है कि Android TV के विजेट को जारी रखना है या नहीं. इसका मतलब है कि डिवाइस को फिर से चालू करने के बाद, उसे कैश मेमोरी में सेव किया गया था या नहीं. ज़्यादातर विजेट के लिए, कैश कंट्रोल सेट करने की ज़रूरत नहीं होगी.हालांकि, ऐसा करने से, अक्सर अपडेट होने वाली कुछ समस्याओं के लिए, पुराना डेटा मौजूद नहीं होता. जैसे, स्वास्थ्य से जुड़े डेटा के बारे में जानकारी. हमने ComplicationDisplayPolicy को भी जोड़ा है. इसमें DO_NOT_SHOW_WHEN_DEVICE_LOCKED, स्मार्टवॉच की ऐसी होम स्क्रीन को निर्देश देता है जिस पर यह सुविधा काम करती है. इस होम स्क्रीन पर, डिवाइस लॉक होने पर Android स्मार्टवॉच के विजेट को नहीं दिखाने का निर्देश दिया जाता है. (Ic9574)

एपीआई में किए गए बदलाव

• GoalProgressComplicationData, WeightedElementsComplicationData, और ColorRamp अब एक्सपेरिमेंट के तौर पर उपलब्ध नहीं हैं. (Ica9e2)
• ComplicationPersistencePolicy और ComplicationDisplayPolicy को अब T API के तौर पर मार्क कर दिया गया है. (I31d88)
• काम नहीं करने वाले ComplicationSlotOverlay कंस्ट्रक्टर में, अब DeprecationLevel.WARNING मौजूद है. इसकी मदद से, इसे एक बार फिर से Java से कॉल किया जा सकता है. (Ib308c)
• हमने ComplicationRequestListener, CanvasComplication, ComplicationTapFilter, और InteractiveWatchFaceClient की JavaScript से जुड़ी कुछ समस्याओं को ठीक किया है. इसके लिए, हमने @JvmDefaultWithCompatibility (Id94fc) में इन समस्याओं की व्याख्या की है
• हमने प्रयोग के तौर पर उपलब्ध ProtoLayoutComplicationData और ListComplicationData को हटा दिया है. इनके बारे में डेवलपर के बारे में कोई जानकारी नहीं थी. हमें उम्मीद है कि हम आने वाले समय में दोबारा विज़िट करेंगे. (I9df05)
• हमने RangedValueComplicationData में ValueType को वापस जोड़ दिया है. 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 में ये कमियां हैं.

नई सुविधाएं

• इसमें कोई नई सुविधा नहीं है. हालांकि, हमने स्मार्टवॉच की होम स्क्रीन में बदलाव करने की सुविधा से जुड़ी कुछ गड़बड़ियों को ठीक कर दिया है.

एपीआई में किए गए बदलाव

• UserStyleSchema.userStyleSettings अब काम नहीं करता, क्योंकि rootUserStyleSettings अब एक्सपेरिमेंटल नहीं है (Ie96e3)
• rootUserStyleSettings को प्रयोग से बाहर ले जाएं (I8d6b3)
• हमने WatchFaceColors को प्रयोग के तौर पर मार्क किया है, क्योंकि यह सभी सिस्टम (I6d75d) पर काम नहीं करता
• DisconnectReasons को सार्वजनिक एपीआई में दिखाएं, ताकि यह IntDef के साथ काम कर सके. (I791f8)

गड़बड़ियां ठीक की गईं

• SysUI बंद हो जाने पर, स्मार्टवॉच के एडिटर पर उपलब्ध कोई भी फ़ाइल बंद कर दें. अगर स्मार्टवॉच की होम स्क्रीन का एडिटर बंद नहीं होता है और SysUI बंद हो जाता है, तो हो सकता है कि स्मार्टवॉच की होम स्क्रीन में अंतर दिखे. इसकी वजह यह है कि उपयोगकर्ता की स्टाइल में होने वाले किसी भी बदलाव को लागू करने के लिए सिस्टम, SysUI का इस्तेमाल करता है.(ba762a
• ComplicationDataSourceInfoRetriever में मेमोरी लीक को ठीक करें, जहां kotlin कोरूटीन को जारी रखने की प्रोसेस, gc रूट के तौर पर काम कर रही थी और एडिटर गतिविधि को बनाए रख रही थी.(33ee06)

वर्शन 1.2.0-alpha02

21 सितंबर, 2022

androidx.wear.watchface:watchface-*:1.2.0-alpha02 रिलीज़ हो गया है. वर्शन 1.2.0-alpha02 में ये कमियां हैं.

नई सुविधाएं

• स्मार्टवॉच की कुछ होम स्क्रीन को UserStyle के बाहर कॉन्फ़िगर किया जाता है, जो विज़ुअल पर असर डालता है. जैसे, कोई बैकग्राउंड फ़ोटो चुनना. हमने Renderer.sendPreviewImageNeedsUpdateRequest को जोड़ा है. इसकी मदद से, स्मार्टवॉच की होम स्क्रीन पर, अपडेट की गई झलक वाली इमेज का अनुरोध किया जा सकता है. ध्यान रखें कि इसे काम करने के लिए, सिस्टम के अप-टू-डेट डेटा की ज़रूरत होगी.

• हमने स्मार्टवॉच की होम स्क्रीन के लिए एक एपीआई भी जोड़ा है, ताकि सिस्टम को उनके रंग दिख सकें. इस एपीआई के आधार पर, होम स्क्रीन के रंग पटल को चुने जा सकता है. ध्यान दें कि इसे फ़ॉलो-ऑन पैच में एक्सपेरिमेंट के तौर पर बनाया गया है.

• अब करीब हर तरह का ComplicationData, SmallImages के साथ काम करता है.

एपीआई में किए गए बदलाव

• वॉलपेपर मैनेजर कभी-कभी इंजन से अलग होकर दूसरा वॉलपेपर बना सकता है. हमने एक नई विधि का इस्तेमाल करके DisconnectReason int डिफ़ और ClientDisconnectListener को बढ़ाया है. इसमें एक DisconnectReason शामिल है, जिससे लिसनर को इंजन डिटैच का पता लगाने की अनुमति मिलती है. (I45cce)
• ComplicationSlotOverlay कंस्ट्रक्टर (I157e8) में, दो वैकल्पिक पैरामीटर nameResourceId और screenReaderResourceId जोड़े गए
• हमने PreviewImageUpdateRequestedListener के साथ getOrCreateInteractiveWatchFaceClient के नए ओवरलोड के लिए, अमरूद वाला एक रैपर जोड़ा है. (Ic31f0)
• हमने Renderer.sendPreviewImageNeedsUpdateRequest को जोड़ा है. यह स्मार्टवॉच की उन होम स्क्रीन के लिए बहुत काम का है जो UserStyleSchema के बाहर की हैं. इनसे उनकी लुक पर असर पड़ता है. जैसे, स्मार्टवॉच की ऐसी होम स्क्रीन जिसके बैकग्राउंड में इमेज हो. इन अनुरोधों पर नज़र रखने के लिए, क्लाइंट साइड पर हमने getOrCreateInteractiveWatchFaceClient में PreviewImageUpdateRequestedListener को वैकल्पिक पैरामीटर के तौर पर जोड़ा है. (Iff44a)
• हमने WatchFaceColors को सार्वजनिक करने के लिए, एपीआई को आसान बना दिया है. अब रेंडरर पर watchFaceColors नाम की एक सामान्य प्रॉपर्टी मौजूद है, जिसे स्मार्टवॉच की होम स्क्रीन पर सेट किया जा सकता है. इसे स्टाइल में होने वाले किसी भी बदलाव के हिसाब से अपडेट किया जाना चाहिए. रंग में होने वाले बदलावों पर नज़र रखने के लिए WallpaperManager का इस्तेमाल करने के बजाय, हमने OnWatchFaceColorsListener को InteractiveWatchFaceClient में जोड़ दिया है. (I490bc)
• हमने एक WatchFaceColors क्लास जोड़ी है. इसमें स्मार्टवॉच की होम स्क्रीन के तीन सबसे मुख्य कलर हैं. साथ ही, खोलने के तरीके जोड़े गए हैं watchfaceColors और रेंडरर को notifyWatchFaceColorsChanged मिलने पर, सिस्टम WallpaperManager.getWallpaperColors के ज़रिए स्मार्टवॉच की होम स्क्रीन के रंगों का पता लगा पाता है. (I3d611)
• ShortTextComplicationData, RangedValueComplicationData, NoPermissionComplicationData (और प्रयोगात्मक DiscreteRangedValueComplicationData, GoalProgressComplicationData और WeightedElementsComplicationData) अब SmallImages का समर्थन करते हैं. अगर स्मार्टवॉच की किसी होम स्क्रीन पर, कई रंगों का इस्तेमाल करके Android घड़ी के विजेट को रेंडर करने का विकल्प चुना जाता है, तो अब कई रंगों वाले SmallImage का इस्तेमाल किया जा सकता है. पहले इसमें एक ही रंग की इमेज इस्तेमाल की जाती थी. (I257df)
• इसके बजाय, Consumer<> के तौर पर PreviewImageUpdateRequestedListener को रीफ़ैक्ट करें (Ia875d)
• कस्टम सिंगल ऐब्स्ट्रैक्ट मेथड (एसएएम) टाइप 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 में ये कमियां हैं.

नई सुविधाएं

• हमने Android घड़ी के विजेट के कई नए फ़ॉर्मैट के लिए, एक्सपेरिमेंट के तौर पर उपलब्ध सहायता जोड़ी है. इस क्षेत्र में लगातार विकास हो रहा है; इन नए फ़ॉर्मैट में बिना किसी सूचना के बदलाव किया जा सकता है. फ़िलहाल, CanvasComplicationDrawable रेंडर करने की सुविधा उपलब्ध नहीं है.
• हमने Android घड़ी के विजेट के लिए, विकल्प के तौर पर मार्जिन भी जोड़े हैं. इससे Android घड़ी के विजेट पर, आसानी से टैप किया जा सकता है.

एपीआई में किए गए बदलाव

• प्रयोग के तौर पर शुरू की गई BoundingArc क्लास को अब नहीं बदला जा सकता. (If624a)
• ऐप्लिकेशन के छोटे-छोटे विजेट पर टैप करना मुश्किल हो सकता है. इसे कम करने के लिए, हमने मार्जिन के लिए सहायता सुविधा शुरू की है. इससे रेंडरिंग पर असर डाले बिना, टैप किए जा सकने वाले हिस्से की संख्या बढ़ जाती है. जब तक साफ़ तौर पर बताया न जाए (कोड में या एक्सएमएल के ज़रिए) ComplciationSlots का मार्जिन शून्य होता है. (I14089)
• जो फ़ैक्ट्री इंस्टेंस खाली नहीं है उसे लौटाने के लिए, getComplicationSlotInflationFactory(CurrentUserStyleRepository) सिग्नेचर बदला गया. पहले शून्य लौटाने पर कोई गड़बड़ी हुई, इसलिए इससे सिर्फ़ एपीआई कॉन्ट्रैक्ट के बारे में साफ़ तौर पर जानकारी मिल रही है. (I0fcc0)
• हमने createComplicationSlotsManager के मुताबिक बनाए रखने के लिए, WatchFaceService.getComplicationSlotInflationFactory तरीके में currentUserStyleRepository आर्ग्युमेंट जोड़ा है. (I2ddd2)
• UserStyleFlavors अब प्रयोग के तौर पर उपलब्ध नहीं हैं. (I69cdc)
• हमने RangedValueComplicationData से प्रयोग के तौर पर इस्तेमाल होने वाले ValueType को हटा दिया है. इसके बजाय, प्रयोग के तौर पर इस्तेमाल होने वाला DiscreteRangedValueComplicationData शामिल किया है, जो पूर्णांक रेंज और RangedValueComplicationData की तरह है वैल्यू. हमने प्रयोग के तौर पर GoalProgressComplicationData की सुविधा भी उपलब्ध कराई है जो RangedValueComplicationData से मिलती-जुलती है. हालांकि, यह सिर्फ़ उस लक्ष्य की प्रोग्रेस के लिए है जिसमें कम से कम वैल्यू शून्य है और वैल्यू को targetValue से ज़्यादा रखा जा सकता है. ध्यान दें कि सभी RangedValue वैरिएंट के लिए, मोनोक्रोम इमेज, टेक्स्ट या टाइटल में से कम से कम एक के बारे में बताना ज़रूरी है. (I9590c)
• हमने ComplicationSlotState से boundsWithMargins को हटा दिया है, क्योंकि सिस्टम सॉफ़्टवेयर में इसके इस्तेमाल का कोई उदाहरण नहीं है. (I42e26)
• हमने WeightedElementsComplicationData के लिए, एक्सपेरिमेंट के तौर पर उपलब्ध सहायता जोड़ी है. इसमें टेक्स्ट/टाइटल/इमेज के साथ-साथ एलिमेंट (वज़न और रंग के जोड़े) का कलेक्शन भी मौजूद है. इन्हें पाई चार्ट के तौर पर दिखाया जा सकता है, जहां कॉन्टेक्स्ट के हिसाब से कलर का सही तरह से होना ज़रूरी है. इसकी वजह यह है कि लेबल को रेंडर करने के लिए, विजेट में आम तौर पर जगह नहीं होती है. (I87eea)
• RangedValueComplicationData और GoalProgressComplicationData में वैकल्पिक तौर पर इस्तेमाल किए जाने वाले ColorRamps के एक्सपेरिमेंट के लिए, अब ज़्यादा से ज़्यादा सात रंगों का क्रम तय किया जा सकता है. साथ ही, यह फ़्लैग भी बताया जा सकता है कि रंगों को आसानी से ट्वीट किया जाना चाहिए या नहीं या एक जैसे साइज़ के ठोस चरणों को रेंडर किया जाना चाहिए या नहीं. (I9f5bf)
• RangedValueComplicationData.drawSegmented को valueType में बदल दिया गया है जो कि उससे जुड़े ValueType IntDef के साथ पूर्णांक है जो रेंज वाली वैल्यू को सिमैंटिक मतलब देता है. साथ ही, इसका इस्तेमाल Android घड़ी के संकेत वाला रेंडरर, स्टाइल पर असर डालने के लिए कर सकता है. (I0616b)
• हमने RangedValueComplicationData में वैकल्पिक ColorRanges के लिए प्रयोग के तौर पर सहायता जोड़ी है. आम तौर पर, विजेट को स्मार्टवॉच की होम स्क्रीन के हिसाब से कलर सेट किया जाता है.हालांकि, कभी-कभी कलर सेट करने के लिए ComplicationDataSource को सबसे सही तरीके से सेट किया जाता है. उदाहरण के लिए, जब उनका कोई खास मतलब होता है. उदाहरण के लिए, तापमान मापने के लिए लाल से नीला. (I5153a)
• हमने RangedValueComplicationData में एक प्रयोग के तौर पर drawSegmented संकेत जोड़ा है. यह रेंडरर को सेगमेंट के साथ रेंज की गई वैल्यू इंडिकेटर को दिखाने के लिए सिग्नल देता है, जहां 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 को बहुत जल्द लागू कर दिया गया था. इसका मतलब है कि स्मार्टवॉच की होम स्क्रीन को चालू करने के लिए कुछ समय बचा था. इस वजह से, Android स्मार्टवॉच के विजेट को pendingInitialComplications पर रखा जाएगा और उन पर ध्यान नहीं दिया जाएगा. इस समस्या को अब ठीक कर दिया गया है. इसके अलावा, यह पैच एक गड़बड़ी को भी ठीक करता है, जिसमें ComplicationRenderer गलत तरीके से प्लेसहोल्डर को एसिंक्रोनस रूप से लोड करने की कोशिश कर रहा था. इसकी वजह से, कंपाइलेशन ग्राफ़िक कभी अपडेट नहीं हुआ. आखिर में यह पैच एक संभावित सैद्धांतिक गड़बड़ी को ठीक कर देता है, जहां कई pendingInitialComplications को मर्ज करने की ज़रूरत होती है. (0d03ba3)

• InteractiveInstanceManager में संभावित डेडलॉक को ठीक करें, जहां getExistingInstanceOrSetPendingWallpaperInteractiveWatchFaceInstance ने ज़रूरत से ज़्यादा समय तक लॉक को पकड़ा हुआ था. आम तौर पर, हम उम्मीद करते हैं कि engine.setUserStyle जल्द से जल्द काम करेगा. हालांकि, अगर किसी वजह से ऐसा नहीं होता है, तो समस्या आ सकती है. इसके अलावा, ANR की गड़बड़ी भी पैदा हो सकती है. इस पैच के ज़रिए गै़र-ज़रूरी काम लॉक से बाहर आ जाता है, जिससे डेडलॉक बनने का खतरा कम हो जाता है.(5a2adca)

• उन कई समस्याओं को ठीक करें जिनकी वजह से WatchFaceService पुराना रहा. कभी-कभी वेकलॉक, WatchFaceService को बनाए रख सकता है. release() कॉल जोड़ने से यह समस्या ठीक हो जाती है. साथ ही, StateFlows, WatchFaceService को बनाए रख सकता है और CoroutineScopes में किए गए सुधारों को रद्द कर सकता है.(fd48138)

• टाइम आउट को awaitDeferredWatchFace* में जोड़ें और watchfaceOverlayStyle NullPointerException को ठीक करें. सामान्य स्थितियों में, नए इंस्टॉल के बाद और ऐसे DirectBoot मामलों में टाइम आउट नहीं होना चाहिए जहां सीपीयू का लोड ज़्यादा होता है. अगर getWatchfaceOverlayStyle को close() के बाद कॉल किया जाता है, तो हमने एनपीई को भी ठीक कर दिया है.(a4c3a5a)

वर्शन 1.1.0

15 जून, 2022

androidx.wear.watchface:watchface-*:1.1.0 रिलीज़ हो गया है. वर्शन 1.1.0 में ये कमियां शामिल हैं.

1.0.0 के बाद के अहम बदलाव

बेहतर एडिटिंग:

• हमने हैरारकी वाले स्कीमा के लिए सहायता जोड़ी है. इससे एडिटर के यूज़र इंटरफ़ेस (यूआई) से स्टाइल की हैरारकी को तय किया जा सकता है. अब स्मार्टवॉच की होम स्क्रीन और साथी एडिटर पर इस्तेमाल के लिए, अलग-अलग आइकॉन तय किए जा सकते हैं.
• स्मार्टवॉच की किसी होम स्क्रीन के कई इंस्टेंस के लिए ऑप्ट-इन की सुविधा मौजूद है. हर इंस्टेंस का एक यूनीक आईडी होता है, जो सभी एपीआई प्लैटफ़ॉर्म पर उपलब्ध होता है.
• अब आप एडिटर में इस्तेमाल करने के लिए, ComplicationSlots के लिए ऐसे नाम तय कर सकते हैं जिन्हें कोई भी व्यक्ति आसानी से पढ़ सके.
• “फ़्लेवर” को स्टाइल देने के लिए एक्सपेरिमेंट के तौर पर उपलब्ध सुविधा. यह चुनिंदा स्टाइल का चुनिंदा विकल्प है, जिसे कंपैनियन एडिटर से ऐक्सेस किया जा सकता है.
• स्मार्टवॉच की होम स्क्रीन के दो इंस्टेंस में बदलाव करने पर, अब स्मार्ट वॉच की होम स्क्रीन के इंस्टेंस में बदलाव किए जा सकते हैं. इससे, मेमोरी सेव होती है और संसाधनों को शेयर किया जा सकता है
• स्मार्टवॉच की होम स्क्रीन पर दिखने वाले एडिटर में, विजेट चुनते समय, सेवा देने वाली मौजूदा कंपनी पहले से चुनी गई होती है.

Android स्मार्टवॉच के विजेट:

• अब प्राइमरी और सेकंडरी डेटा सोर्स के लिए ComplicationType तय किया जा सकता है. इससे डेवलपर को अलग-अलग तरह का अनुभव मिलता है.
• हमने ComplicationDataTimeline को जोड़ा है. यह स्मार्टवॉच की होम स्क्रीन पर, समय से जुड़ा डेटा एक क्रम में दिखाता है. इस डेटा को कैश मेमोरी में सेव किया जा सकता है और अपने-आप अपडेट किया जा सकता है. उदाहरण के लिए, अलग-अलग समय पर आज के मौसम का पूर्वानुमान या आने वाले कई कैलेंडर इवेंट.
• Android घड़ी के विजेट की सेवा देने वाली कंपनी का ComponentName, ComplicationData का हिस्सा है.
• Android स्मार्टवॉच के विजेट अब कैश मेमोरी में सेव किए जाते हैं. इससे, स्मार्टवॉच की होम स्क्रीन के बीच स्विच करते समय बेहतर अनुभव मिलता है.

अन्य बदलाव:

• UserStyleSchema और ComplicationSlots को अब एक्सएमएल में तय किया जा सकता है. इससे स्मार्टवॉच की होम स्क्रीन आसानी से बनाई जा सकती है और सिस्टम से मेटाडेटा क्वेरी की प्रोसेस तेज़ी से की जा सकती है.
• स्मार्टवॉच की होम स्क्रीन, अब सिस्टम ओवरले को रेंडर करने के लिए इस्तेमाल किए जाने वाले कलर में बदलाव कर सकती हैं.

वर्शन 1.1.0-rc01

18 मई, 2022

androidx.wear.watchface:watchface-*:1.1.0-rc01 रिलीज़ हो गया है. वर्शन 1.1.0-rc01 में ये कमिट शामिल हैं.

नई सुविधाएं

• हमने Watchface एक्सएमएल से जुड़ी सहायता के लिए, उपयोगिता में कुछ बदलाव किए हैं. इससे, ComplicationSlotBounds और इसके साथ काम करने वाली पहचान फ़ाइलों के बारे में जानकारी देना आसान हो जाता है. किनारे की जटिलता BoundingArc के साथ प्रयोग जारी है और इसे drawHighlight तक ले जाया जा रहा है. हालांकि, उस समय इसका इस्तेमाल करने का सुझाव नहीं दिया जाता है.

एपीआई में किए गए बदलाव

• हमने प्रयोग के तौर पर drawHighlight का एक ओवरलोड जोड़ा है. इसमें BoundingArc पैरामीटर स्वीकार किए जाते हैं. (I705f8)
• स्मार्टवॉच की होम स्क्रीन का एक्सएमएल, अब संसाधन के रेफ़रंस के साथ काम करता है. इसकी मदद से, एक्सएमएल और अपने कोड, दोनों में एक जैसे कॉन्सटेंट का इस्तेमाल किया जा सकता है. (I3ef61)
• हमने center_x, center_y, size_x, size_y फ़ॉर्म में ComplicationSlotBounds को परिभाषित करने की सुविधा जोड़ी है. अब रिसॉर्स रेफ़रंस का इस्तेमाल करके, अलग-अलग इकाइयों (जैसे, डीपी) का इस्तेमाल भी किया जा सकता है. (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 के लिए, प्रयोग के तौर पर सहायता उपलब्ध कराई है. फ़िलहाल, ये सुविधाएं इस्तेमाल के लिए तैयार नहीं हैं. हालांकि, इस स्पेस में देखें.

एपीआई में किए गए बदलाव

• हमने BoundingArc को जोड़ा है. यह एक ऐसी प्रयोग की कक्षा है जिसमें किसी किनारे की जटिलता के स्लॉट की ज्यामिति के बारे में जानकारी दी गई है. इस जानकारी को ComplicationSlot में जोड़ दिया गया है. साथ ही, ComplicationSlotState और WatchFaceMetadataClient से जोड़ दिया गया है. (I61a40)
• हमने UserStyleSetting एक्सएमएल में सेटिंग को इनहेरिट करने की सुविधा जोड़ी है. यह आपको 'कितने शब्दों में जानकारी दी जाए' सेटिंग का इस्तेमाल करने की सुविधा देता है. साथ ही, स्मार्टवॉच की होम स्क्रीन के बीच सेटिंग शेयर करता है. (Ief841)
• हमने ComplicationData के दो नए तरह के प्रयोग जोड़े हैं: ListComplicationData और ProtoLayoutComplicationData. फ़िलहाल, इनमें से किसी भी टाइप के लिए रेंडरिंग की सुविधा उपलब्ध नहीं है. साथ ही, अगर ComplicationDataSource's मेनिफ़ेस्ट में जोड़ा गया हो, तो WearOS फ़िलहाल इन टाइप को नहीं पहचान पाता. (I1811c)

गड़बड़ियां ठीक की गईं

• TimeLineEntry टाइप को क्रम से लगाने की समस्या ठीक करें. हम TimeLineEntry टाइप को क्रम से नहीं लगा रहे थे. इसका मतलब है कि NoData टाइप की कैश मेमोरी में सेव किए गए TimeLineEntries को, गलत तरीके से पैरंट Android घड़ी के विजेट के तौर पर माना जाएगा. इसकी वजह से, ऐसे ज़रूरी फ़ील्ड को ऐक्सेस किया जाता है जो मौजूद नहीं हैं. (55ffdf5)
• setComplicationData के छोड़े गए टाइमलाइन फ़ील्ड(fb392f5) की गड़बड़ी ठीक करें
• उस गड़बड़ी को ठीक करता है जो कभी-कभी runBlockingWithTracing से एनपीई(12ca62e) तक ले जाती थी
• उस बग को ठीक करता है जहां से, विजेट मिलने पर हमें कभी-कभी ClassNotFoundException: android.support.wearable.complications.ComplicationText मिलता है.(217942d9)
• GlesRenderer.backgroundThreadInitInternal में उस गड़बड़ी को ठीक किया गया है जिसमें EGL14.eglCreateContext को कॉल किए जाने पर ही onBackgroundThreadGlContextCreated को कॉल किया जाता था. उस दूसरी गड़बड़ी को ठीक करता है जहां verticalFlip की वजह से स्क्रीनशॉट में विज़ुअल ग्लिच हुआ था.(c674ad2)
• WatchFaceService एक्सएमएल वर्शन की जांच से जुड़ी समस्या ठीक करें, यह गलत पैकेज से लोड हो रही थी.(dfa06f3)
• प्लेसहोल्डर वाले वायर फ़ॉर्मैट में अब इनर बंडल का इस्तेमाल किया जाता है. हम नहीं चाहते कि प्लेसहोल्डर मौजूदा स्मार्ट वॉच की होम स्क्रीन को तोड़ें, क्योंकि हो सकता है कि छिपी हुई इनर 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 में ये तय किए गए हिस्से शामिल हैं.

एपीआई में किए गए बदलाव

• अब WatchFaceMetadataClient तरीकों में (getUserStyleSchema, getComplicationSlotMetadataMap, getUserStyleFlavors) और HeadlessWatchFaceClient.getUserStyleFlavors, WatchFaceException के बजाय, नहीं का निशान वाले Runtimeअपवाद को फेंकते हैं. (I0718a)
• WatchFaceMetadataClient.WatchFaceException को क्लास से बाहर कर दिया गया है, ताकि उसे फिर से इस्तेमाल किया जा सके. (I4e869)

गड़बड़ियां ठीक की गईं

• ComplicationSlotBounds की आंशिक जानकारी भेजने पर, WatchFaceMetadataClient अब क्रैश नहीं होगा.(Iaafd)

वर्शन 1.1.0-alpha05

6 अप्रैल, 2022

androidx.wear.watchface:watchface-*:1.1.0-alpha05 रिलीज़ हो गया है. वर्शन 1.1.0-alpha05 में ये कमियां हैं.

नई सुविधाएं

• अब ComplicationData.dataSource की जांच करके पता लगाया जा सकता है कि किस डेटा सोर्स ने ComplicationData भेजा है. स्मार्टवॉच की कुछ होम स्क्रीन, Android घड़ी के विजेट को पसंद के मुताबिक बनाने के लिए इसका इस्तेमाल कर सकती हैं. (I44a73)

एपीआई में किए गए बदलाव

• 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 को डाइजेस्ट हैश का हिसाब लगाने से पहले, स्कीमा को एआईडीएल पर पास करने से होने वाले कम ओवरहेड से बचा जा सकता है. (I33597)
• हमने isUserStyleSchemaStatic को WatchFaceMetadataClient में जोड़ा है. यह तभी लागू होता है, जब UserStyleSchema पर भरोसा किया जा सकता हो और स्मार्टवॉच की होम स्क्रीन वाला APK अपडेट न किया गया हो. (I45a3f)
• हमने UserStyleSchema में getDigestHash जोड़ा है, जो स्कीमा के डाइजेस्ट हैश को कंप्यूट करता है. इसका इस्तेमाल यह पता लगाने के लिए किया जा सकता है कि 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 में ये कमियां हैं.

एपीआई में किए गए बदलाव

• हो सकता है कि अप-टू-डेट ComplicationData हमेशा उपलब्ध न हो (उदाहरण के लिए, कैश मेमोरी में सेव किया गया ComplicationData), इसलिए हमने वैकल्पिक प्लेसहोल्डर ComplicationData के साथ NoDataComplication को बढ़ा दिया है. साथ ही, ComplicationText.PLACEHOLDER, MonochromaticImage.PLACEHOLDER, SmallImage.PLACEHOLDER, PhotoImage.PLACEHOLDER को जोड़ा है, जिनका इस्तेमाल सिर्फ़ NoDataComplicationData प्लेसहोल्डर के तौर पर किया जा सकता है. चुने जाने पर, इन प्लेसहोल्डर को स्लेटी रंग के बॉक्स/आर्क से रेंडर करने का सुझाव दिया जाता है. (I6285d)
• हमने ComplicationData.getNextChangeInstant जोड़ा है जो आपको उस झटपट संदर्भ के बाद अगला झटपट बताता है जिस पर जटिलता का कोई भी फ़ील्ड बदल सकता है. इस सुविधा का इस्तेमाल, Android घड़ी के विजेट के फ़्रेम को शेड्यूल करने के लिए किया जाता है. उदाहरण के लिए, अगर स्मार्टवॉच की होम स्क्रीन हर मिनट में एक बार सामान्य रूप से अपडेट होती है, तो 'स्मार्टवॉच का विजेट रोकें' को सेट करने पर, यह हर सेकंड में एक बार अपडेट होगा. (I7ceb2)
• EditorSession.watchFaceId का इस्तेमाल अब सभी एपीआई लेवल पर किया जा सकता है. इसके अलावा, इसकी वैल्यू अब हमेशा WatchState.watchFaceInstanceId के हिसाब से होगी. (I323b9)
• इस समस्या को फ़्रेमवर्क में ठीक कर लिया गया है. इसलिए, अब getPendingIntentForTouchEvent एपीआई की ज़रूरत नहीं है. इसलिए, इससे जुड़े सभी एपीआई हटा दिए गए हैं. भले ही, होम बटन हाल ही में दबाया गया हो, स्मार्टवॉच की होम स्क्रीन को PendingIntents फ़ायर करने के लिए, कुछ खास करने की ज़रूरत नहीं होती है. (I1f2e8)
• हमने RendererParameters.isForScreenShot को जोड़ा है. अगर रेंडर किया गया कॉन्टेंट, स्क्रीन शॉट के लिए होगा, तो यह लागू होगा. बेहतरीन नतीजे पाने के लिए, ऐनिमेशन वाली स्मार्टवॉच की कुछ होम स्क्रीन को इसकी जानकारी होनी ज़रूरी है. इससे, होम स्क्रीन में बदलाव किए जा सकते हैं. (I96d99)
• हमने WatchFaceExceptionReason को WatchFaceException में जोड़ दिया है, ताकि गड़बड़ी के बारे में आपको कुछ जानकारी दी जा सके. (I01d15)
• ComplicationDataSourceService.onImmediateComplicationRequest को हटा दिया गया है. इसके बजाय, ComplicationRequest.immediateResponseRequired को यह सिग्नल देने के लिए जोड़ा गया है कि सेवा देने वाली कंपनी को तुरंत जवाब देना होगा (100 मि॰से॰ से कम समय में जवाब देना बेहतर होगा). ध्यान दें कि यह सुविधा खास तौर पर com.google.android.wearable.permission.USE_IMMEDIATE_COMPLICATION_UPDATE को मिली अनुमति का इस्तेमाल करती है. (Ie6b23)
• तिरामीसु DP2 (I0cbb7) से मैच करने के लिए, कोर और ऐपकंपैट में शून्य होने की संभावना को अपडेट किया गया

गड़बड़ियां ठीक की गईं

• स्कीमा की पुष्टि नहीं होने पर, Watchface ऐप्लिकेशन किसी अपवाद के साथ क्रैश हो जाता है (Ia400f)

वर्शन 1.1.0-alpha03

9 फ़रवरी, 2022

androidx.wear.watchface:watchface-*:1.1.0-alpha03 रिलीज़ हो गया है. वर्शन 1.1.0-alpha03 में ये कमियां हैं.

एपीआई में किए गए बदलाव

• हमने हैरारकी वाले स्टाइल के स्कीमा के लिए, एक्सपेरिमेंट के तौर पर उपलब्ध सहायता जोड़ी है. हमने androidx.wear.watchface.style.UserStyleSetting.Option में एक नई प्रॉपर्टी जोड़ी है, चाइल्ड सेटिंग का इस्तेमाल शुरू में सिर्फ़ ListOption करता है. इसकी मदद से, एडिटर के यूज़र इंटरफ़ेस (यूआई) में इस्तेमाल के लिए स्टाइल की हैरारकी बताई जा सकती है. मौजूदा UserStyle में कोई बदलाव नहीं किया गया है और यह अब भी Map<String, ByteArray> है. (Iaf6f4)
• हमने WatchFace.OverlayStyle को जोड़ा है. इसकी मदद से, स्मार्टवॉच की होम स्क्रीन पर सिस्टम स्टेटस ओवरले को रेंडर किया जा सकता है. (I8520d)
• हमने CanvasRenderer के लिए, clearWithBackgroundTintBeforeRenderingHighlightLayer को एक नया वैकल्पिक कंस्ट्रक्टर पैरामीटर लॉन्च किया है. यह डिफ़ॉल्ट तौर पर 'गलत' है. अगर 'सही है' पर सेट किया जाता है, तो कैनवस को बैकग्राउंड के रंग में बदल दिया जाएगा. (Ie01e5)
• androidx.watchface.complications.datasource.DEFAULT_CONFIGURATION_SUPPORTED मेटाडेटा कुंजी जोड़ी गई. इससे, Android घड़ी के विजेट के डेटा सोर्स को यह बताने की अनुमति मिलती है कि वे बिना किसी कॉन्फ़िगरेशन (Icc0d4) के डिफ़ॉल्ट वैल्यू दे सकते हैं
• स्मार्टवॉच की होम स्क्रीन को इंटरैक्टिव और हेडलेस (सिर्फ़ बैक-एंड पर काम करने की सुविधा), दोनों के लिए इस्तेमाल करना आम बात है. मेमोरी बचाने के लिए हमने Renderer.SharedAssets की शुरुआत की है. यह स्मार्टवॉच की होम स्क्रीन को रेंडर करने वाले टूल को अलग-अलग इंस्टेंस के बीच ऐसा डेटा (जैसे कि टेक्सचर और शेडर) शेयर करने की अनुमति देता है जिसमें बदलाव नहीं किया जा सकता. GlesRenderer.setEglConfig और GlesRenderer.setEglDisplay अब काम नहीं करते हैं. इन्हें कभी भी सेट करने के मकसद से नहीं बनाया गया था. ऐसा करने से, व्यवहार के बारे में कोई जानकारी नहीं मिलेगी. (I0d9e7)
• हमने setNameResourceId और ComplicationSlot.Builder के लिए setScreenReaderNameResourceId (जिसमें रेफ़रंस स्ट्रिंग रिसॉर्स) और androidx.wear.watchface.client.ComplicationSlotState में इससे जुड़े गैटर शामिल होते हैं. इससे सिस्टम, एडिटर और स्क्रीन रीडर में इस्तेमाल करने के लिए ComplicationSlots के नाम फ़ेच कर पाता है. (If6c6a)
• WatchfaceMetadataClient.getUserStyleSchema और getComplicationSlotMetadataMap ने अब RemoteException की जगह WatchFaceException बॉल फेंकी. (I86f11)
• ComplicationDataSourceService में onSynchronousComplicationRequest और उससे जुड़े फ़ंक्शन का नाम बदलकर onImmediateComplicationRequest वगैरह कर दिया गया है... (I87ba0)
• स्मार्टवॉच की होम स्क्रीन के एडिटर में, साथी एडिटर के मुकाबले स्मार्टवॉच की स्क्रीन पर अलग-अलग आइकॉन का इस्तेमाल किया जा सकता है. इसलिए, इसमें अलग-अलग आइकॉन का इस्तेमाल किया जा सकता है. यह पैच, OnWatchEditorData को सभी UserStyleSettings में और जहां ज़रूरत हो वहां उनके विकल्प क्लास में जोड़ता है. फ़िलहाल, इसमें सिर्फ़ एक आइकॉन है. (If1886)
• हमने LearnableGlesRenderer के कंस्ट्रक्टर में, @JvmOverloads को जोड़ा है, ताकि बेहतर Java इंटरऑप के लिए इसका इस्तेमाल किया जा सके. (I2974a)

गड़बड़ियां ठीक की गईं

• ListenableGlesRenderer का कंस्ट्रक्टर अब सही तरीके से @Throws(GlesException::class) के तौर पर मार्क किया गया है, और अब इस क्लास को java में बढ़ाया जा सकता है. (Iac6d0)
• PhotoImageComplicationData TapAction से जुड़ी गड़बड़ी को ठीक करता है सही तरीके से संभाला जा रहा है (I1cc30)

वर्शन 1.1.0-alpha02

12 जनवरी, 2022

androidx.wear.watchface:watchface-*:1.1.0-alpha02 रिलीज़ हो गया है. वर्शन 1.1.0-alpha02 में ये कमियां हैं.

नई सुविधाएं

• डीबग करने और जांच करने में मदद के लिए, ComplicationData और इससे जुड़े सब-क्लास अब ओवरराइड किए गए हैशकोड, equals और toString मेथड हैं. इनकी मदद से, इनके साथ काम करना आसान हो जाता है.

एपीआई में किए गए बदलाव

• WatchfaceMetadataClient तरीकों में जहां ज़रूरत हो वहां RemoteExceptions को फिर से शामिल किया जाता है. इससे क्लाइंट कोड के लिए स्मार्टवॉच की होम स्क्रीन से गड़बड़ियों को पहचानना आसान हो जाता है. (I78785)
• ComplicationData और सब-क्लास में अब हैशकोड, equals, और toString शामिल हैं. (I24bc6)

वर्शन 1.1.0-alpha01

15 दिसंबर, 2021

androidx.wear.watchface:watchface-*:1.1.0-alpha01 रिलीज़ हो गया है. वर्शन 1.1.0-alpha01 में ये कमियां हैं.

नई सुविधाएं

• UserStyleSchema और ComplicationSlots को अब एक्सएमएल में तय किया जा सकता है. इससे स्मार्टवॉच की होम स्क्रीन को आसानी से बनाया जा सकता है. इसके अलावा, WatchFaceMetadataClient क्वेरी ज़्यादा तेज़ होती हैं, क्योंकि मेटाडेटा पाने के लिए उसे सेवा से बाइंड करने की ज़रूरत नहीं होती. WatchFaceMetadataClient और ListenableWatchFaceMetadataClient पर अब प्रयोग नहीं चल रहा है. साथ ही, ये स्थायी एपीआई का हिस्सा बन जाएंगे. इसके अलावा, स्मार्टवॉच की होम स्क्रीन को एक से ज़्यादा बार इस्तेमाल किया जा सकता है. हालांकि, हर एक के लिए, अलग-अलग स्टाइल के विकल्प उपलब्ध होते हैं. ये होम स्क्रीन चुनने के टूल में दिखेंगे. इसे ऑप्ट-इन करने के लिए, स्मार्टवॉच की किसी होम स्क्रीन के मेनिफ़ेस्ट में, यहां दिया गया मेटा डेटा टैग शामिल करना ज़रूरी है.

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

• स्मार्टवॉच की कुछ होम स्क्रीन पर यह स्टेटस दिखता है कि उसे UserStyle में कैप्चर नहीं किया गया है. इसलिए, इस सुविधा के साथ-साथ, कई बार स्मार्टवॉच की होम स्क्रीन का इंस्टेंस आईडी अब WatchState.watchFaceInstanceId पर उपलब्ध है.

• ComplicationData को अब कैश मेमोरी में सेव किया जा रहा है, ताकि लोड होते ही Android घड़ी के विजेट तुरंत दिखें. कभी-कभी सिस्टम, मेमोरी में ComplicationData को कैश मेमोरी में सेव करता है और कभी-कभी इसे स्मार्टवॉच की होम स्क्रीन वाली लाइब्रेरी में क्रम से लगाया जाता है. क्रम से लगाए जाने पर, जोड़ा गया कोई भी tapAction दिखना बंद हो जाएगा. अगर ऐसा होता है, तो ComplicationData.tapActionLostDueToSerialization true दिखाएगा. साथ ही, स्मार्टवॉच की होम स्क्रीन पर Android घड़ी के विजेट को अलग तरीके से दिखाया जाएगा, ताकि यह पता चल सके कि उस पर टैप नहीं किया जा सकता. जैसे, धूसर किया गया या आधा पारदर्शी. सिस्टम, tapAction के साथ अपडेट किए गए ComplicationData को जल्द से जल्द भेजेगा.

• कुछ ComplicationData को लंबे समय तक कैश मेमोरी में सेव नहीं रखना चाहिए. इसे बेहतर बनाने के लिए, हमने एक सामान्य सुविधा ComplicationDataTimeline जोड़ी है. इसका इस्तेमाल, स्मार्टवॉच की होम स्क्रीन पर दिखाने के लिए टाइम-गेट किए गए ComplicationData का क्रम देने के लिए किया जा सकता है. इस संख्या को कैश मेमोरी में सेव किया जा सकता है और अपने-आप अपडेट किया जा सकता है. उदाहरण के लिए, अलग-अलग समय पर आज के मौसम का पूर्वानुमान या आने वाले कई कैलेंडर इवेंट. ComplicationRequestListener की समयावधि, onComplicationDataTimeline नए तरीके से बढ़ाई गई है. इस डेटा को वापस करने के लिए, इसका इस्तेमाल किया जा सकता है.

• DefaultComplicationDataSourcePolicy की अवधि बढ़ा दी गई है, ताकि आप प्राइमरी और सेकंडरी डेटा सोर्स के लिए ComplicationType तय कर सकें.

• हमने Android घड़ी के विजेट को सिंक करने वाली उन कंपनियों के लिए सहायता जोड़ी है जहां Android घड़ी के विजेट को सामान्य से ज़्यादा फ़्रीक्वेंसी पर अपडेट किया जाता है. स्मार्टवॉच की होम स्क्रीन दिख रही हो और वह आस-पास न हो, तब हर सेकंड के लिए इस सुविधा को ज़्यादा से ज़्यादा एक बार अपडेट किया जाता है. ध्यान दें: मेमोरी दबाव से जुड़ी समस्याओं की वजह से, हो सकता है कि सिंक्रोनस Android घड़ी के विजेट की सेवा देने वाली कंपनियों का सीमित इस्तेमाल हो.

• ऐसा हो सकता है कि PendingIntentTapListener के बदलावों को पहले जैसा कर दिया गया हो, क्योंकि हमने फ़्रेमवर्क में इस समस्या को हल कर लिया था. स्मार्ट वॉच की होम स्क्रीन पर, होम बटन दबाने के बाद पांच सेकंड तक गतिविधियां शुरू की जा सकती हैं. ऐसा नहीं हो सकता.

एपीआई में किए गए बदलाव

• ComplicationData.isCached को tapActionLostDueToSerialization में बदल दिया गया है. इससे यह तय करना ज़्यादा आसान होगा कि Android घड़ी के विजेट को अलग तरीके से रेंडर करना है या नहीं, ताकि यह पता चल सके कि उस पर टैप नहीं किया जा सकता. (I6de2f)
• ComplicationDataTimeline को wear-complication-data-source में जोड़ा गया. इसका इस्तेमाल, स्मार्टवॉच की होम स्क्रीन पर दिखाने के लिए टाइम-गेट किए गए ComplicationData का क्रम देने के लिए किया जा सकता है. इस संख्या को कैश मेमोरी में सेव किया जा सकता है और अपने-आप अपडेट किया जा सकता है. उदाहरण के लिए, अलग-अलग समय पर आज के मौसम का पूर्वानुमान या आने वाले कई कैलेंडर इवेंट. ComplicationRequestListener की समयावधि, onComplicationDataTimeline नए तरीके से बढ़ाई गई है. इस डेटा को वापस करने के लिए, इसका इस्तेमाल किया जा सकता है. डेटा सोर्स से जुड़ी सेवाओं को निलंबित करने के लिए, एक नया kotlin रैपर SuspendingTimelineComplicationDataSourceService उपलब्ध है. (Idecdc)
• PendingIntentTapListener और WatchFaceControlClient.getPendingIntentForTouchEvent जोड़े गए. इससे उन होम स्क्रीन को देखने में मदद मिल सकती है जिन्हें किसी समस्या को हल करने के लिए, टैप करने पर इंटेंट लॉन्च करने की ज़रूरत होती है. ऐसा तब होता है, जब फ़्रेमवर्क, होम बटन दबाने के बाद पांच सेकंड के लिए नई गतिविधियों को लॉन्च करना ब्लॉक कर देता है. (I98074)
• हर स्मार्टवॉच की होम स्क्रीन के लिए ComplicationData कैश मेमोरी लॉन्च की गई. इसका मकसद स्मार्टवॉच की होम स्क्रीन पर, Android स्मार्टवॉच के लोड होने के बाद, Android स्मार्टवॉच के, Android घड़ी के विजेट के लिए जाना-पहचाना Android डेटा देखने की अनुमति देना है. ऐसा तब तक किया जा सकता है, जब तक सिस्टम इसे अपडेट नहीं कर लेता. OEM के लिए, एपीआई का एक नया तरीका WatchFaceControlClient.hasComplicationCache है. इससे स्मार्टवॉच की होम स्क्रीन पर, विजेट भेजने की सिस्टम की रणनीति पर असर पड़ सकता है. इसके अलावा, ComplicationData में एक isCached प्रॉपर्टी है. हमारा सुझाव है कि कैश मेमोरी में सेव किए गए विजेट को अलग तरह से रेंडर करें, क्योंकि tapAction को कैश मेमोरी में सेव नहीं किया जा सकता और कैश मेमोरी में सेव किए गए Android घड़ी के विजेट को null माना जाएगा. (I404b0)
• स्मार्टवॉच की होम स्क्रीन का इंस्टेंस आईडी अब WatchState.watchFaceInstanceId के ज़रिए उपलब्ध है. ज़्यादातर स्मार्टवॉच की होम स्क्रीन पर इसका इस्तेमाल करने की ज़रूरत नहीं होगी. हालांकि, अगर स्मार्टवॉच की हर होम स्क्रीन पर ऐसी कोई स्थिति है जो स्कीमा में सेव नहीं है, तो स्मार्टवॉच की होम स्क्रीन को पहचानने के लिए इस बटन का इस्तेमाल किया जाता है. आपकी मदद करने के लिए, अब WatchFaceControlClient.createHeadlessWatchFaceClient पर कॉल करते समय आईडी दिया जा सकता है. (I1ff98)
• मुख्य कंपनी, दूसरी कंपनी, और फ़ॉलबैक सिस्टम की सेवा देने वाली कंपनी के लिए, डिफ़ॉल्ट ComplicationTypes सेट करने की सुविधा के साथ DefaultComplicationDataSourcePolicy को बढ़ाया गया. ComplicationSlot.defaultDataSourceType अब काम नहीं करता. (If0ce3)
• ComplicationSlot.configExtras में अब बदलाव किया जा सकता है. EditorSession.openComplicationDataSourceChooser() को कॉल करने से पहले, इसे अपडेट किया जा सकता है. (I6f852)
• WatchFace.setComplicationDeniedDialogIntent और setComplicationRationaleDialogIntent जोड़े गए. इन इंटेंट को इसलिए लॉन्च किया जाता है, ताकि Android घड़ी के विजेट की अनुमतियों का अनुरोध करने से पहले, वजह बताने वाला डायलॉग दिखाया जा सके. इसके अलावा, एक अन्य डायलॉग बॉक्स यह बताता है कि अनुमतियों को अस्वीकार किए जाने पर, Android घड़ी के विजेट में बदलाव करने की अनुमति ज़रूरी होती है. (I3a29c)
• UserStyleSchema और ComplicationSlots को अब एक्सएमएल में तय किया जा सकता है. इससे स्मार्टवॉच की होम स्क्रीन आसानी से बनाई जा सकती है. साथ ही, WatchFaceMetadataClient क्वेरी को तेज़ी से पूरा किया जा सकता है, क्योंकि मेटाडेटा पाने के लिए इन्हें किसी सेवा से जुड़ना ज़रूरी नहीं होता. (I85bFA)
• InteractiveWatchFaceClient.supportsPendingIntentForTouchEvent को जोड़ा गया, ताकि क्लाइंट यह पता लगा सके कि स्मार्टवॉच की होम स्क्रीन, getPendingIntentForTouchEvent के साथ काम करती है या नहीं. (I0b917)
• WatchFaceMetadataClient और ListenableWatchFaceMetadataClient अब प्रयोग के तौर पर नहीं हैं. स्मार्टवॉच की होम स्क्रीन का मेटाडेटा बेहतर तरीके से पाने के लिए, इनका इस्तेमाल किया जा सकता है. ऐसा करने के लिए, होम स्क्रीन पर बाइंडर नहीं खुलना चाहिए. (Ibb827)
• Android घड़ी के विजेट को सिंक करने वाली सुविधा जोड़ी गई. इसमें Android घड़ी के विजेट को सामान्य से ज़्यादा फ़्रीक्वेंसी पर अपडेट किया जाता है. स्मार्टवॉच की होम स्क्रीन बिना स्क्रीन के दिख रही हो और वह आस-पास न दिखे. इसका इस्तेमाल करने के लिए, सेवा देने वाली कंपनी को अपने मेनिफ़ेस्ट में एक नया androidx.wear.watchface.complications.data.source.SYNCHRONOUS_UPDATE_PERIOD_SECONDS मेटाडेटा टैग शामिल करना होगा और onSynchronousComplicationRequest को बदलना होगा. डेटा सोर्स के टाइप के आधार पर, Android को onStartSynchronousComplicationRequests और onStopInteractiveComplicationRequests को भी बदलना पड़ सकता है, ताकि Android घड़ी के संकेत के इंटरैक्टिव मोड में जाने और बंद होने की सूचना मिले. (I8fe9d)

संस्करण 1.0

वर्शन 1.0.1

9 फ़रवरी, 2022

androidx.wear.watchface:watchface-*:1.0.1 रिलीज़ हो गया है. वर्शन 1.0.1 में ये कमियां शामिल हैं.

गड़बड़ियां ठीक की गईं

• PhotoImageComplicationData TapAction से जुड़ी गड़बड़ी को ठीक करता है सही तरीके से संभाला जा रहा है (I1cc30)

वर्शन 1.0.0

1 दिसंबर, 2021

androidx.wear.watchface:watchface-*:1.0.0 रिलीज़ हो गया है. वर्शन 1.0.0 में ये कमियां शामिल हैं.

1.0.0 की मुख्य सुविधाएं

androidx.wear.watchface पैकेज, WearOS स्मार्टवॉच की होम स्क्रीन डेवलप करने के लिए सुझाई गई नई लाइब्रेरी है. इसमें, Wearable की पुरानी सहायता लाइब्रेरी में कई नई सुविधाएं जोड़ी गई हैं.

• उपयोगकर्ता की स्टाइलिंग (जैसे, रंग पटल, स्मार्टवॉच की सुई की स्टाइल, घंटे के निशान वगैरह) को सीधे लाइब्रेरी में इस्तेमाल किया जा सकता है (androidx.wear.watchface.style देखें). अब androidx.wear.watchface.संपादक का इस्तेमाल करके, स्मार्टवॉच की होम स्क्रीन पर काम करने वाला एडिटर बनाना बहुत आसान हो गया है. साथ ही, सिस्टम के साथी ऐप्लिकेशन से, स्मार्टवॉच की होम स्क्रीन को एडिट करने के लिए, अलग से कोड लिखने की ज़रूरत नहीं होती.
• सबसे सही तरीके. लाइब्रेरी से, Android घड़ी के विजेट के लिए, स्क्रीन रीडर के कॉन्टेंट लेबल अपने-आप जनरेट होते हैं. आपके पास अपना लेबल जोड़ने का विकल्प भी होता है. बैटरी कम होने और चार्ज न होने पर, फ़्रेमरेट अपने-आप कम हो जाता है. इससे बैटरी लाइफ़ बेहतर होती है.
• स्मार्टवॉच की होम स्क्रीन बनाने के लिए, कम कोड की ज़रूरत होती है. खास तौर पर, ऐसे विजेट के लिए जिन्हें लंबे समय तक बॉयलरप्लेट लाइब्रेरी में जोड़ दिया गया हो.

गड़बड़ियां ठीक की गईं

• EditorSession.userStyle.compareAndSet (I6f676) को ठीक करें
• स्मार्टवॉच की होम स्क्रीन पर दिखने वाली देरी की समस्या को ठीक करना (Iffb97)
• यूज़र इंटरफ़ेस (यूआई) थ्रेड पर InteractiveWatchFaceImpl.onDestroy डिस्पैच करें (I83340)
• ब्रॉडकास्ट रिसीवर से जुड़ी कई समस्याओं को ठीक करना (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 के बाद चलाएं या इनसे यूज़र इंटरफ़ेस (यूआई) थ्रेड init में देरी होने का जोखिम हो.(37650ac)

• पक्का करें कि Renderer.onDestroy को कॉल किया गया हो. ऐसी स्थिति में, जहां रेंडरर बनाया गया है, लेकिन WF में वह पूरा नहीं हुआ है और Engine.onDestroy को कॉल किया जाता है, तो हमें Renderer.onDestroy को कॉल करना होगा. (f9952dc)

• इसे ऑप्टिमाइज़ करने/ठीक करने की कोशिश करें isBatteryLowAndNotCharging. यह पैच isबैटरीLowAndNotCharging के शुरुआती सेटअप को पहले ले जाता है, जिसका मतलब है कि इसे साथ में किया जा सकता है WatchFace बनाने के लिए करें. इसके अलावा अब हम 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 में ये कमियां हैं.

एपीआई में किए गए बदलाव

• 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<> प्रॉपर्टी हैं जिनकी वैल्यू शुरुआत में शून्य है. LookableEditorsession में getListenableComplicationPreviewData और getListenableComplicationsProviderInfo को बेस क्लास के नए StateFlow<> ऑब्जेक्ट से हटा दिया गया है. अगर आपको Java कोड में हुए बदलावों को सुनना है, तो LiveData<> में बदलने के लिए androidx.lifecycle.FlowLiveDataConversions.asLiveData का इस्तेमाल करें. (Ic5483)

वर्शन 1.0.0-alpha23

29 सितंबर, 2021

androidx.wear.watchface:watchface-*:1.0.0-alpha23 रिलीज़ हो गया है. वर्शन 1.0.0-alpha23 में ये कमियां हैं.

नई सुविधाएं

Watchface लाइब्रेरी अब सिर्फ़ एक लाइब्रेरी ग्रुप है. इस वजह से, लाइब्रेरी बदल गई हैं. इसलिए, आपको gradle इंपोर्ट को इस तरह से अपडेट करना होगा:

एपीआई में किए गए बदलाव

• अलग-अलग androidx.wear स्मार्टवॉच की होम स्क्रीन और Android घड़ी के विजेट को androidx.wear.watchface लाइब्रेरी ग्रुप में माइग्रेट करें. (b25f3c0)
• EditorRequest.canWatchFaceSupportheadlessEditing को जोड़ा गया है, ताकि क्लाइंट को यह बताया जा सके कि स्मार्टवॉच के चेहरे वाला एडिटर, हेडलेस (सिर्फ़ बैक-एंड पर काम करने की सुविधा) में बदलाव करने की सुविधा देता है या नहीं. ध्यान दें कि इससे कुछ फ़ॉल्स नेगेटिव हो सकते हैं, क्योंकि asop/1756809 में सपोर्ट जोड़ा गया था. हालांकि, यह आने वाले समय में सभी स्मार्टवॉच की होम स्क्रीन के लिए सही वैल्यू दिखाएगा. (ca55590)
• अब रेंडरर में dump() तरीका उपलब्ध है, जिसे ABD Shell dumpsys गतिविधि सेवा WatchFaceService से जनरेट की गई जानकारी में कस्टम डेटा जोड़ने के लिए बदला जा सकता है. (95235f9)
• InteractiveWatchFaceClient.addWatchFaceReadyListener अब सबसे पहले एक्ज़िक्यूटर की जानकारी देता है. (563ac2f)
• StateFlowCompatHelper को हटा दिया गया है. इसके बजाय, asLiveData (androidx.lifecycle.asLiveData) का इस्तेमाल करें. (bd35d3)
• currentUserStyleRepository.userStyle अब म्यूट नहीं किया जा सकता. (I44889)
• WatchFaceFrameListener का नाम बदलकर OnWatchFaceFrameListener कर दिया गया है. (Ic12a9)

गड़बड़ियां ठीक की गईं

• onDestroy को कॉल करने के लिए InteractiveViewsManager.delete शरीर का इस्तेमाल किया जाता है. यह इसलिए ज़रूरी है, ताकि InteractiveWatchFaceImpl को गारबेज इकट्ठा किया जा सके.(fce4af8, b/199485839)