توضّح هذه الصفحة كيفية تصحيح أخطاء خلفية شاشة ساعة تم إنشاؤها باستخدام تنسيق خلفية شاشة الساعة. ويشرح أيضًا كيفية التحقّق من صحة ملف XML الخاص بخلفية شاشة الساعة وتحديد أخطاء وقت التشغيل.
البحث عن مستندات صالحة بتنسيق خلفية شاشة الساعة
بما أنّ تنسيق خلفية شاشة الساعة يتطلّب ملف XML منظَّمًا جيدًا ومتوافقًا مع ملف XSD منشور، يمكنك التأكّد مما إذا كانت خلفية شاشة الساعة صالحة أم لا، وتحديد الأخطاء.
استخدِم أداة التحقّق من صحة ملف XML لتحديد المشاكل أثناء عملية الإنشاء. تم دمج هذه الأداة في عملية الإنشاء في عيّنات خلفيات الساعة.
إذا كنت بصدد إنشاء أداة لإنشاء خلفيات شاشة الساعة، تأكَّد من أنّ الأداة تُجري عملية التحقّق من صحة ملف XML باستخدام XSD في أداتك.
مثال على تشغيل أداة التحقّق يدويًا:
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.
تعرَّف على كيفية الحصول على أداة التحقّق من XML وإعدادها للاستخدام.
تحديد أخطاء وقت التشغيل
لا يكفي التأكّد من أنّ ملف XML نفسه صالح لرصد جميع المشاكل المحتمَلة.
على سبيل المثال، قد يشير ملف XML إلى خط أو مورد قابل للرسم غير متوفّر، أو قد يكون من المتوقّع أن ينتج التعبير قيمة رقمية، ولكنه ينتج سلسلة بدلاً من ذلك.
بالنسبة إلى هذه الأنواع من المشاكل، يُعدّ استخدام logcat، إما في "استوديو Android" أو من خلال ADB، طريقة جيدة للحصول على معلومات أكثر تفصيلاً.
يمكنك الفلترة حسب "وقت التشغيل" وستتمكّن من الاطّلاع على كلّ من المشاكل الخطيرة وغير الخطيرة
التي تؤثّر في خلفية شاشة الساعة. على سبيل المثال، في ما يلي، عند تحديد مورد لمحاولة 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