इस पेज पर, Watch Face Format का इस्तेमाल करके बनाई गई वॉच फ़ेस को डीबग करने का तरीका बताया गया है. इसमें, स्मार्टवॉच की होम स्क्रीन के एक्सएमएल की पुष्टि करने और रनटाइम की गड़बड़ियों की पहचान करने का तरीका भी बताया गया है.
Watch Face Format के मान्य दस्तावेज़ों की जांच करना
Watch Face Format के लिए, अच्छी तरह से व्यवस्थित किया गया एक्सएमएल ज़रूरी है, जो पब्लिश किए गए एक्सएसडी के मुताबिक हो. इससे, यह पुष्टि की जा सकती है कि आपकी स्मार्टवॉच की होम स्क्रीन मान्य है या नहीं. साथ ही, गड़बड़ियों की पहचान की जा सकती है.
बिल्ड करने की प्रोसेस के दौरान आने वाली समस्याओं की पहचान करने के लिए, एक्सएमएल की पुष्टि करने वाले टूल का इस्तेमाल करें. यह टूल, स्मार्टवॉच की होम स्क्रीन के सैंपल में बिल्ड करने की प्रोसेस में इंटिग्रेट किया गया है.
अगर स्मार्टवॉच की होम स्क्रीन बनाने के लिए कोई टूल बनाया जा रहा है, तो पक्का करें कि वह टूल, एक्सएसडी का इस्तेमाल करके एक्सएमएल की पुष्टि करता हो.
पुष्टि करने वाले टूल को मैन्युअल तरीके से चलाने का उदाहरण:
java -jar wff-validator.jar 2 ~/MyWatchface/res/raw/watchface.xml
अगर आपके watchface.xml दस्तावेज़ में कोई गड़बड़ी है, तो आपको गड़बड़ी का मैसेज दिखेगा. जैसे, इस मामले में height को hight लिखा गया है:
INFO: DWF Validation Application Version 1.0. Maximum Supported Format Version #2
SEVERE: [Line 41:Column 53]: cvc-complex-type.3.2.2: Attribute 'hight' is not allowed to appear in element 'PartDraw'.
INFO: ❌ FAILED : watchface.xml is NOT valid against watch face format version #1
पुष्टि करने वाला टूल, उस एलिमेंट की जगह की पहचान करता है जिसे ठीक करना है—लाइन 41, कॉलम 53.
एक्सएमएल फ़ाइल की पुष्टि करने वाले टूल को पाने और इस्तेमाल के लिए उसे बनाने का तरीका जानें.
रनटाइम की गड़बड़ियों की पहचान करना
सभी संभावित समस्याओं का पता लगाने के लिए, यह पक्का करना कि एक्सएमएल मान्य है ही काफ़ी नहीं है.
उदाहरण के लिए, हो सकता है कि आपका एक्सएमएल किसी ऐसे फ़ॉन्ट या ड्रॉबल संसाधन का रेफ़रंस दे जो मौजूद न हो. इसके अलावा, हो सकता है कि किसी एक्सप्रेशन से संख्या वाली वैल्यू मिलने की उम्मीद हो, लेकिन इसके बजाय स्ट्रिंग मिल जाए.
इस तरह की समस्याओं के बारे में ज़्यादा जानकारी पाने के लिए, Android Studio या ADB के ज़रिए logcat का इस्तेमाल करना एक अच्छा तरीका है.
"रनटाइम" पर फ़िल्टर करें. इससे आपको वॉच फ़ेस पर असर डालने वाली गंभीर और सामान्य, दोनों तरह की समस्याएं दिखेंगी. उदाहरण के लिए, यहां HourHand के लिए ऐसा रिसॉर्स तय किया गया है जो मौजूद नहीं है:
E Invalid resource ID 0x00000000.
E FATAL EXCEPTION: main
Process: com.google.wear.watchface.runtime, PID: 29115 android.content.res.Resources$NotFoundException: Resource ID #0x0
इसके अलावा, यहां किसी रंग की थीम का इस्तेमाल करते समय, टाइपिंग में हुई गड़बड़ी की वजह से भी यह गड़बड़ी दिख सकती है:
W color has wrong type of source:CONFIGURATION.myTheeeme.2[OBJECT:]
E Cannot parse theme color. Using theme color WHITE