تصحيح أخطاء التنسيق باستخدام أداة فحص التنسيق

تتيح لك أداة فحص التنسيق في استوديو Android تصحيح الأخطاء في تنسيق تطبيقك من خلال إظهار تدرج هرمي لطريقة العرض حيث يمكنك فحص خصائص كل طريقة عرض. باستخدام Layout Inspector (أداة فحص التخطيط)، يمكنك مقارنة تخطيط تطبيقك بنماذج تجريبية للتصميم، وعرض عرض مكبر أو ثلاثي الأبعاد لتطبيقك، وفحص تفاصيل تخطيطه في وقت التشغيل. يكون ذلك مفيدًا على وجه الخصوص عندما يتم إنشاء التنسيق في وقت التشغيل بدلاً من كله بتنسيق XML ويعمل التنسيق بشكل غير متوقع.

لمعرفة المزيد من المعلومات عن "محرِّر التنسيق"، يُرجى الاطّلاع على مقدمة إلى "محرِّر التنسيق".

بدء

لبدء أداة "فحص التنسيق"، شغِّل تطبيقك وانتقِل إلى نافذة الأجهزة قيد التشغيل وانقر على رمز تبديل أداة فحص التنسيق . في حال التبديل بين أجهزة أو مشاريع متعددة، تتصل أداة Layout Inspector تلقائيًا بالعمليات القابلة لتصحيح الأخطاء التي تعمل في مقدمة الجهاز المتصل.

في ما يلي كيفية تنفيذ بعض المهام الشائعة:

• للاطّلاع على التدرج الهرمي وفحص خصائص كل ملف شخصي، استخدِم نافذتَي أداة شجرة المكونات والسمات. قد تتطلب أداة فحص التخطيط إعادة تشغيل النشاط للوصول إلى السمات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تجنُّب إعادة تشغيل النشاط.
• لاختيار طرق العرض من خلال النقر مرة واحدة مباشرةً على طرق العرض أو انتقِل إلى الترميز من خلال النقر مرّتين على طرق العرض، فعِّل خيار تبديل الفحص الدقيق .
• للتفاعل مع التطبيق، أوقِف تبديل الفحص الدقيق .
• لفحص الأجهزة الخارجية، فعِّل النسخ المطابق للجهاز.
• لتفعيل التحديثات المباشرة أثناء تحديث واجهة المستخدم لتطبيقك، تأكّد من أنّ التعديل المباشر مفعَّلة.
• لاستخدام الوضع الثلاثي الأبعاد، اختَر لقطة من أداة فحص التنسيق ، ثم انقر على الوضع الثلاثي الأبعاد .

اختيار طريقة عرض أو عزلها

ترسم طريقة العرض عادةً شيئًا يمكن للمستخدم رؤيته والتفاعل معه. تعرض شجرة المكونات العرض الهرمي لتطبيقك في الوقت الفعلي مع كل مكوّن عرض، ما يساعدك في تصحيح الأخطاء في تنسيق تطبيقك لأنّه يمكنك تمثيل العناصر داخل تطبيقك والقيم المرتبطة بها.

لاختيار ملف شخصي، انقر عليه في شجرة المكونات أو عرض التنسيق. تظهر جميع سمات التنسيق لطريقة العرض المحددة في لوحة السمات.

إذا كان التنسيق يتضمن طرق عرض متداخلة، يمكنك الاطّلاع على جميع طرق العرض في منطقة عند النقر بزر الماوس الأيمن في وضع الفحص الدقيق . لاختيار طريقة عرض غير متوفّرة في المقدمة، انقر عليها في شجرة المكونات أو يمكنك تدوير التنسيق.

لاستخدام التنسيقات المعقدة، يمكنك عزل طرق العرض الفردية بحيث لا يتم عرض سوى مجموعة فرعية من التنسيق في شجرة المكونات ويتم عرضها في عرض التنسيق. لعزل عرض، سجّل لقطة، ، انقر بزر الماوس الأيمن على طريقة العرض في شجرة المكونات، واختَر إظهار الشجرة الفرعية فقط أو إظهار العناصر الرئيسية فقط. للعودة إلى العرض الكامل، انقر بزر الماوس الأيمن على العرض وحدد عرض الكل. يجب أخذ لقطة قبل عزل طريقة العرض.

إخفاء حدود التنسيق وعرض التصنيفات

لإخفاء مربّع الإحاطة أو عرض تسميات عنصر التنسيق، انقر على خيارات العرض أعلى عرض التنسيق وبدِّل بين إظهار الحدود أو إظهار تصنيف العرض.

التقاط لقطات العرض الهرمي للتخطيط

تتيح لك أداة فحص التنسيق حفظ لقطات من التسلسل الهرمي لتخطيط تطبيقك قيد التشغيل، بحيث يمكنك مشاركتها مع الآخرين أو الرجوع إليها لاحقًا.

تلتقط اللقطات البيانات التي تراها عادةً عند استخدام عارض التصميم، بما في ذلك العرض الثلاثي الأبعاد التفصيلي للتنسيق وشجرة مكوّنات طريقة العرض أو الإنشاء أو التنسيق المختلط والسمات التفصيلية لكل مكوّن من مكوّنات واجهة المستخدم. لحفظ لقطة، انقر على تصدير/استيراد لقطة ، ثم تصدير اللقطة.

حمِّل لقطة أداة فحص التنسيق محفوظة سابقًا من خلال النقر على استيراد لقطة.

الوضع الثلاثي الأبعاد

تتميز شاشة التنسيق بعرض مرئي ثلاثي الأبعاد متقدم للتدرّج الهرمي لعرض تطبيقك في وقت التشغيل. لاستخدام هذه الميزة، عليك التقاط لقطة ، والنقر على زر الوضع الثلاثي الأبعاد في نافذة أداة فحص اللقطات، وتدويرها من خلال سحب الماوس.

مقارنة تنسيق التطبيق بتراكب صورة مرجعية

لمقارنة تخطيط تطبيقك بصورة مرجعية، مثل نموذج واجهة المستخدم، يمكنك تحميل تراكب صورة نقطية في Layout Inspector (أداة فحص التخطيط).

• لتحميل تراكب، حدد الخيار تحميل تراكب من شريط الأدوات أداة فحص التنسيق. يتم تغيير حجم التراكب ليلائم التصميم.
• لضبط شفافية التراكب، استخدم شريط تمرير الإصدار الأولي للتراكب.
• لإزالة العنصر الذي يظهر على سطح الفيديو، انقر على محو المحتوى الذي يظهر على سطح الفيديو.

فحص Compose

يتيح لك Layout Inspector (أداة فحص التنسيق) فحص تخطيط Compose داخل تطبيق قيد التشغيل في المحاكي أو الجهاز المادي. يمكنك استخدام Layout Inspector (أداة فحص التنسيق) للتحقق من عدد المرات التي تتم فيها إعادة إنشاء أو تخطي عنصر قابل للإنشاء، ما يمكن أن يساعد في تحديد المشاكل في تطبيقك. على سبيل المثال، قد تجبر بعض أخطاء الترميز على إعادة إنشاء واجهة المستخدم بشكل مفرط، ما قد يتسبب في ضعف الأداء. يمكن أن تمنع بعض أخطاء البرمجة إعادة إنشاء واجهة المستخدم، وبالتالي تمنع ظهور تغييرات واجهة المستخدم على الشاشة.

مزيد من المعلومات عن "أداة فحص التنسيق" لأداة Compose

تجنُّب عمليات إعادة تشغيل النشاط

تتطلب أداة فحص التنسيق أحد الإعدادات العامة التالية لتعمل بشكل صحيح. إذا لم تحدد إعدادًا عموميًا، فسيتولى عارض التنسيق تعيين هذا الإعداد تلقائيًا.

1. adb shell settings put global debug_view_attributes_application_package <processname>

   يؤدي هذا الخيار إلى إنشاء معلومات إضافية لفحص العملية المحدّدة.

2. adb shell settings put global debug_view_attributes 1

   ينشئ هذا الخيار معلومات إضافية لفحص جميع العمليات على الجهاز.

وقد يؤدي تغيير إعداد عام إلى إعادة تشغيل النشاط. لتجنُّب إعادة تشغيل نشاط، يمكنك إمّا تغيير الإعدادات في "استوديو Android" أو تغيير خيارات المطوّرين في إعدادات جهازك.

لتفعيل إعادة التحميل التلقائية في "استوديو Android"، افتح إعدادات التشغيل/تصحيح الأخطاء من خلال اختيار تشغيل > تعديل الإعدادات من القائمة. بعد ذلك، انتقِل إلى علامة التبويب بنود متنوعة وضَع علامة في المربّع الاتصال بأداة فحص التنسيق بدون إعادة تشغيل النشاط ضمن خيارات أداة فحص التنسيق.

بدلاً من ذلك، يمكنك تفعيل خيارات المطوّرين على جهازك، ثم تفعيل تفعيل فحص سمة العرض من إعدادات المطوّرين على الجهاز.

أداة فحص التصميم المستقلة

للحصول على الأداء الأمثل، نوصي باستخدام عارض التخطيط في وضعه المضمن الافتراضي. إذا كنت تريد إلغاء تضمين أداة فحص التنسيق، انتقِل إلى File (ملف) (Android Studio على نظام التشغيل macOS)> الإعدادات > الأدوات > أداة فحص التنسيق وألغِ تحديد مربّع الاختيار تفعيل أداة فحص التنسيق المضمَّنة.

في الوضع المستقل، فعِّل التحديثات المباشرة بالنقر على الخيار التحديثات المباشرة من شريط أدوات أداة فحص التنسيق.