استكشاف أخطاء البناء والمعاينة وإصلاحها

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

ابدأ من هنا

بعد أن ينهي Agent مهمة، يقوم عارض التطبيقات بتحميل تطبيقك. يعرض Terminal نشاط المهمة والأخطاء، بينما يوفّر لك شريط أدوات عارض التطبيقات عنصر تحكم Reload App Viewer، ومبدّل عرض الجهاز، وخيار فتح المعاينة في علامة تبويب جديدة، وConsole.

1. احفظ أحدث تغيير وانتظر حتى تنتهي المهمة الحالية أو عملية البناء الحالية.
2. حدد Reload App Viewer مرة واحدة إذا بدت المعاينة قديمة أو بقيت على شاشة تحميل.
3. افتح المعاينة في علامة تبويب جديدة إذا كان عارض التطبيقات المضمّن عالقًا أو لا يستجيب.
4. افتح Console وانسخ أول خطأ ظاهر. احتفظ برابط المشروع ووقت حدوث الفشل.

عندما يفشل البناء

جرّب Resolve أولًا

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

1. حدد Resolve وانتظر حتى تنتهي المحاولة الحالية.
2. لا تحدد Resolve مرة أخرى أثناء تشغيله.
3. إذا لم تنتهِ المحاولة، فسجّل الحالة الظاهرة وتابع خطوات الإبلاغ أدناه. لا تبدأ محاولة Resolve أخرى.
4. عند انتهاء المحاولة، تحقّق من المعاينة المحدّثة. إذا لم يتم تحديثها، فحدّث المتصفح مرة واحدة.
5. كرّر الإجراء الذي تسبب في المشكلة. إذا استمرت المشكلة، فوسّع الإبلاغ عن مشكلة وتابع خطوات الإبلاغ أدناه.

خطأ في البناء أو تبعية مفقودة

إذا كانت لوحة Preview تعرض خطأ في البناء، أو شريط خطأ أحمر، أو رسالة حول حزمة مفقودة، فاستخدم الرسالة الدقيقة لتحديد الخطوة التالية.

1. افتح Console وانسخ رسالة الخطأ الكاملة الظاهرة هناك.
2. إذا كان Resolve متاحًا، فاستخدمه مرة واحدة وانتظر حتى تنتهي المحاولة.
3. إذا لم يكن هناك زر Resolve، فالصق الخطأ الدقيق في دردشة المشروع واطلب من Agent إصلاح خطأ البناء هذا.
4. إذا بدأ الخطأ بعد تغيير محدد، فافتح History وقارن الإصدار الحالي بآخر إصدار كان يعمل.
5. إذا كان من الصعب عزل الخطأ، فقم بعمل ريمكس من آخر إصدار مستقر وأعد تطبيق التغييرات بشكل تدريجي.

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

ما يزال البناء قيد التقدم

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

عندما لا يتم تحميل Preview أو عارض التطبيقات

شاشة تحميل أو معاينة لا تستجيب

تحقق أولًا مما إذا كان المتأثر هو عارض التطبيقات المضمّن فقط، أو ما إذا كان عنوان URL الخاص بـ Preview والموقع المنشور متأثرين أيضًا.

1. أكد ما إذا كانت المهمة الحالية أو عملية البناء ما تزال قيد التشغيل.
2. حدد Reload App Viewer مرة واحدة.
3. افتح Preview في علامة تبويب جديدة في المتصفح.
4. اختبر عنوان URL نفسه في نافذة التصفح المتخفي.
5. إذا تم تحميل آخر إصدار معروف أنه كان يعمل، فقارنه بالتغيير الأخير الذي تسبب في المشكلة.

إذا أبلغ المنتج صراحةً عن عدم كفاية رصيد Cloud & AI أو عن تعليق التطبيق، فافتح Settings → Cloud & AI وراجع تلك الحالة. لا تقم بإعادة الشحن استنادًا إلى شاشة فارغة فقط.

معاينة فارغة أو غير مكتملة

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

سجّل أي خطأ في Console أو Network من دون مشاركة ملفات تعريف الارتباط أو Tokens أو القيم السرية. إذا استمرت المشكلة، فأدرج تفاصيل الخطأ المنقّحة في تقريرك.

تعرض المعاينة إصدارًا أقدم

المعاينة والموقع المنشور قناتان منفصلتان. تأكد من حفظ أحدث التغييرات واكتمال أحدث عملية بناء قبل تحديث المعاينة. أعد فتح Preview بعد اكتمال البناء. إذا كانت لا تزال تعرض محتوى أقدم، فقارن الإصدار الحالي بآخر إصدار معروف أنه كان يعمل في History.

عندما تبدو المعاينة غير صحيحة

التفاعلات أو التنقل لا يعملان

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

تخطيط الهاتف المحمول معطّل

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

الصور أو الأصول الأخرى مفقودة

1. افتح قسم Files وتأكد من أن الملف المشار إليه موجود.
2. تحقق من أن المسار واسم الملف والتنسيق تطابق المرجع الذي يستخدمه التطبيق.
3. إذا تم نقل الأصل أو إعادة تسميته مؤخرًا، فاستعد المرجع أو حدّثه بشكل مقصود.
4. حدد Reload App Viewer واختبر الصفحة المتأثرة مرة أخرى.

قام Agent بتغيير العنصر الخطأ أو أفسد منطقة أخرى

1. افتح History وقم بعمل ريمكس من آخر إصدار مستقر.
2. استخدم وضع التصميم لاستهداف العنصر الدقيق عندما يكون ذلك متاحًا.
3. اذكر ما الذي يجب ألا يتغير، وأجرِ تغييرًا واحدًا لكل Prompt.
4. تحقق من النتيجة قبل المتابعة إلى التغيير التالي.

أبلغ عن مشكلة

أبلغ عن المشكلة عندما لا يكون Resolve متاحًا، أو عندما تستمر المشكلة بعد اكتمال محاولة Resolve، أو عندما تكون Preview لا تستجيب لكن دردشة المشروع ما تزال تعمل، أو عندما يستمر السلوك غير المتوقع بعد أن يحقق Agent في الأمر.

افتح Feedback من دردشة المشروع

1. افتح دردشة المشروع المتأثرة واعثر على أحدث رسالة ذات صلة من Agent.
2. حدد ... (المزيد من الخيارات)، ثم حدد Feedback.
3. في مراسل الدعم، حدد Send us a message وأرسل التقرير في المحادثة الحالية إذا كانت موجودة بالفعل.

للاطلاع على مسار الإبلاغ عن مشكلة الكامل، راجع أبلغ عن مشكلة.

ضمّن تفاصيل كافية لإعادة إنتاج المشكلة

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

أزل كلمات المرور ومفاتيح API وTokens الخاصة بالمصادقة وملفات تعريف الارتباط وتفاصيل الدفع والبيانات الشخصية أو السرية غير ذات الصلة قبل مشاركة لقطات الشاشة أو السجلات.

بعد إصلاح المشكلة

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

الأسئلة الشائعة