בניית גרסה ופתרון תקלות בתצוגה מקדימה

התחל כאן

לאחר ש-Agent מסיים משימה, App Viewer טוען את האפליקציה שלך. ה-Terminal מציג פעילות משימה ושגיאות, בעוד שסרגל הכלים של App Viewer מספק לך פקד Reload App Viewer, מתג לתצוגת מכשיר, אפשרות לפתוח את התצוגה המקדימה בלשונית חדשה, ואת ה-Console.

1. שמור את השינוי האחרון והמתן לסיום המשימה או ה-build הנוכחיים.
2. בחר Reload App Viewer פעם אחת אם התצוגה המקדימה נראית לא מעודכנת או נשארת במסך טעינה.
3. פתח את התצוגה המקדימה בלשונית חדשה אם App Viewer המוטמע תקוע או לא מגיב.
4. פתח Console והעתק את השגיאה הגלויה הראשונה. שמור את קישור הפרויקט ואת זמן הכשל.

כאשר ה-build נכשל

נסה את Resolve תחילה

כאשר Atoms מזהה בעיית build, התראת Issue Report מופיעה בפינה השמאלית התחתונה. אם ההתראה כוללת את Resolve, התחל ניסיון תיקון אחד לפני נקיטת פעולה אחרת.

1. בחר Resolve והמתן לסיום הניסיון הנוכחי.
2. אל תבחר Resolve שוב בזמן שהוא פועל.
3. אם הניסיון לא מסתיים, תעד את הסטטוס הגלוי והמשך עם שלבי הדיווח שלמטה. אל תתחיל ניסיון Resolve נוסף.
4. כאשר הניסיון מסתיים, בדוק את התצוגה המקדימה שרועננה. אם היא לא מתעדכנת, רענן את הדפדפן פעם אחת.
5. חזור על הפעולה שגרמה לבעיה. אם הבעיה נשארת, הרחב את Issue Report והמשך עם שלבי הדיווח שלמטה.

שגיאת build או תלות חסרה

אם חלונית Preview מציגה שגיאת build, באנר שגיאה אדום, או הודעה על חבילה חסרה, השתמש בהודעה המדויקת כדי לצמצם את הצעד הבא.

1. פתח Console והעתק את הודעת השגיאה המלאה שגלויה שם.
2. אם Resolve זמין, השתמש בו פעם אחת והמתן לסיום הניסיון.
3. אם אין כפתור Resolve הדבק את השגיאה המדויקת ב-Project chat ובקש מה-Agent לתקן את שגיאת ה-build הזו.
4. אם השגיאה התחילה לאחר שינוי מסוים, פתח את History והשווה את הגרסה הנוכחית לגרסה האחרונה שעבדה.
5. אם קשה לבודד את השגיאה, Remix מהגרסה היציבה האחרונה והחל מחדש שינויים בהדרגה.

שגיאות שמזכירות את App Viewer, סקריפט ההפעלה, Publish, רשומת deploy, או קבצים פנימיים של חבילת צד שלישי עשויות להצביע על בעיית פלטפורמה. כלול את הודעת השגיאה המלאה כאשר אתה פונה ל-Support.

ה-build נשאר בתהליך

בדוק את ה-Terminal לפעילות המשימה הנוכחית לפני ניסיון חוזר. אם המשימה או ה-build עדיין פועלים, המתן לסיומם. אם הוא נשאר בתהליך לאחר שהניסיון הנוכחי מסתיים, תעד את הסטטוס, חותמת הזמן, קישור הפרויקט וכל פרטי שגיאה גלויים, ואז דווח על הבעיה.

כאשר Preview או App Viewer לא נטענים

מסך טעינה או תצוגה מקדימה לא מגיבה

תחילה בדוק אם רק App Viewer המוטמע מושפע, או שגם כתובת ה-URL של Preview והאתר שפורסם מושפעים.

1. אשר אם המשימה או ה-build הנוכחיים עדיין פועלים.
2. בחר Reload App Viewer פעם אחת.
3. פתח את Preview בלשונית חדשה בדפדפן.
4. בדוק את אותה כתובת URL בחלון Incognito.
5. אם הגרסה האחרונה הידועה כתקינה נטענת, השווה אותה לשינוי האחרון שהכניס את הבעיה.

אם המוצר מדווח במפורש על יתרת Cloud לא מספקת & AI או על אפליקציה מושעית, פתח את Settings → Cloud & AI ובדוק את הסטטוס הזה. אל תטען יתרה רק על סמך מסך ריק.

תצוגה מקדימה ריקה או לא מלאה

בדוק אם המסך הריק משפיע על כל האפליקציה או רק על עמוד או רכיב אחד. אם רק אזור אחד מושפע, השתמש בבורר העמודים כדי לפתוח את אותו עמוד ישירות וחזור על מסלול המשתמש הקטן ביותר שמגיע אליו. אם כל התצוגה המקדימה ריקה, חזור לתוצאת ה-build ופתור את שגיאת ה-build או זמן הריצה הראשונה לפני בדיקה נוספת.

תעד כל שגיאת Console או Network בלי לשתף cookies, tokens או ערכים סודיים. אם הבעיה נמשכת, כלול את פרטי השגיאה המנוקים בדוח שלך.

Preview מציג גרסה ישנה יותר

Preview והאתר שפורסם הם ערוצים נפרדים. ודא שהשינויים האחרונים נשמרו ושה-build האחרון הושלם לפני רענון התצוגה המקדימה. פתח מחדש את Preview לאחר שה-build הושלם. אם הוא עדיין מציג תוכן ישן יותר, השווה את הגרסה הנוכחית לגרסה האחרונה הידועה כתקינה ב- History.

כאשר התצוגה המקדימה נראית שגויה

אינטראקציות או ניווט לא עובדים

עמוד שמוצג אינו זהה לעמוד שעובד. פתח כל קישור ניווט חשוב, לחץ על הכפתורים הראשיים, שלח את הטפסים המרכזיים, ועבור על מסלול המשתמש הראשי מההתחלה ועד הסוף. כאשר אינטראקציה אחת נכשלת, תעד את הפעולה המדויקת שבה התוצאה הצפויה נעצרת ובדוק את המסלול הזה שוב לאחר כל תיקון.

פריסת המובייל שבורה

1. השתמש במתג המכשיר שבסרגל הכלים של App Viewer כדי לעבור לתצוגת מובייל.
2. בחר את האלמנט השבור במצב Design כאשר הוא זמין.
3. תאר את פריסת המובייל הצפויה ומה אסור שישתנה.
4. החל שינוי אחד, ואז אמת את תצוגות הדסקטופ והמובייל וכן מצבי טעינה, ריק, hover ושגיאה.

תמונות או נכסים אחרים חסרים

1. פתח את מקטע Files ואשר שהקובץ שאליו מפנים אכן קיים.
2. בדוק שהנתיב, שם הקובץ והפורמט תואמים להפניה שבה האפליקציה משתמשת.
3. אם הנכס הועבר או שונה שמו לאחרונה, שחזר את ההפניה או עדכן אותה במכוון.
4. בחר Reload App Viewer ובדוק שוב את העמוד המושפע.

ה-Agent שינה את האלמנט הלא נכון או שבר אזור אחר

1. פתח History ו- Remix מהגרסה היציבה האחרונה.
2. השתמש במצב Design כדי למקד לאלמנט המדויק כאשר הוא זמין.
3. ציין מה אסור שישתנה ובצע שינוי אחד לכל prompt.
4. אמת את התוצאה לפני שתמשיך לשינוי הבא.

דווח על בעיה

דווח על הבעיה כאשר Resolve אינו זמין, הבעיה נשארת לאחר ניסיון Resolve שהושלם, ה-Preview לא מגיב אבל Project chat עדיין עובד, או שהתנהגות בלתי צפויה נמשכת לאחר שה-Agent חקר את הבעיה.

פתח את Feedback מתוך Project chat

1. פתח את Project chat המושפע ומצא את הודעת ה-Agent הרלוונטית האחרונה.
2. בחר ... (אפשרויות נוספות), ואז בחר Feedback.
3. ב-messenger של התמיכה, בחר Send us a message ושלח את הדוח בשיחה הקיימת כאשר כבר קיימת אחת.

לתהליך המלא של Issue Report, ראה Report an Issue.

כלול מספיק פרטים כדי לשחזר את הבעיה

• סיכום הבעיה. תאר את הבעיה במשפט אחד או שניים.
• קישור לפרויקט או לצ'אט. כלול את כתובת ה-URL שבה הבעיה התרחשה.
• תאריך ושעה. כלול את אזור הזמן שלך.
• שלבים לשחזור. רשום את הפעולות המדויקות לפי הסדר.
• תוצאה צפויה ותוצאה בפועל. ציין מה היה אמור לקרות ומה קרה במקום זאת.
• מה כבר ניסית. ציין אם Resolve הופיע, מה קרה לאחר שסיים, והאם רענון או Remix שינו את התוצאה.
• דפדפן ומכשיר. כלול את הדפדפן, מערכת ההפעלה וסוג המכשיר.
• ראיות. צרף צילום מסך או הקלטה ואת פרטי ה-Issue Report או ה-Console הגלויים והרלוונטיים.

הסר סיסמאות, מפתחות API, אסימוני אימות, cookies, פרטי תשלום ונתונים אישיים או סודיים לא קשורים לפני שיתוף צילומי מסך או יומנים.

לאחר שהבעיה תוקנה

הרץ את מסלול המשתמש הראשי מההתחלה ועד הסוף. בדוק את Preview גם בתצוגת דסקטופ וגם בתצוגת מובייל, פתח כל עמוד מבורר העמודים, ואשר של-Console אין הודעות שגיאה אדומות. אם האפליקציה מוכנה לפרסום, החלף כל תוכן placeholder והשלם את בדיקות הפרסום ב-App Viewer.

שאלות נפוצות

למה App Viewer מציג מסך לבן ריק?

1. אשר אם הבעיה משפיעה רק על App Viewer, על כתובת ה-URL של Preview, או גם על האתר שפורסם.
2. בחר Reload App Viewer פעם אחת, פתח את Preview בלשונית חדשה, ובדוק חלון Incognito.
3. בדוק אם המשימה או ה-build הנוכחיים עדיין פועלים. המתן לסיומם לפני ניסיון חוזר.
4. אם הודעה מפורשת אומרת שיתרת Cloud & AI אינה מספיקה או שהאפליקציה מושעית, פתח את Settings → Cloud & AI ובדוק את היתרה הזו. אל תטען יתרה רק על סמך מסך ריק.
5. תעד כל שגיאת Console או Network בלי לשתף cookies, tokens או ערכים סודיים.

אם המסך נשאר ריק, פנה ל-Support עם קישור הצ'אט, כתובת ה-URL המלאה של Viewer, השעה ואזור הזמן, הסביבות המושפעות, צילום מסך ופרטי שגיאה מנוקים.