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

ابدأ من هنا

بعد أن ينهي 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 من دون مشاركة ملفات تعريف الارتباط أو الرموز المميزة أو القيم السرية. إذا استمرت المشكلة، فأدرج تفاصيل الخطأ المنقّحة في تقريرك.

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

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

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

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

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

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

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

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

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

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

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

الإبلاغ عن مشكلة

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

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

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

للاطلاع على التدفق الكامل لـ الإبلاغ عن مشكلة، راجع الإبلاغ عن مشكلة.

أدرج تفاصيل كافية لإعادة إنتاج المشكلة

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

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

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

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

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

لماذا يعرض عارض التطبيقات شاشة بيضاء فارغة؟

1. أكّد ما إذا كانت المشكلة تؤثر فقط على عارض التطبيقات أو على عنوان URL الخاص بـ Preview أو على الموقع المنشور أيضًا.
2. حدّد Reload App Viewer مرة واحدة، وافتح Preview في علامة تبويب جديدة، واختبر نافذة تصفح خفي.
3. تحقّق مما إذا كانت المهمة الحالية أو عملية الإنشاء الحالية لا تزال قيد التشغيل. انتظر حتى تنتهي قبل إعادة المحاولة.
4. إذا كانت هناك رسالة صريحة تفيد بأن رصيد Cloud & AI غير كافٍ أو أن التطبيق معلّق، فافتح Settings → Cloud & AI وراجع ذلك الرصيد. لا تقم بإعادة الشحن اعتمادًا على شاشة فارغة فقط.
5. سجّل أي خطأ في Console أو Network من دون مشاركة ملفات تعريف الارتباط أو الرموز المميزة أو القيم السرية.

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