Fehlerbehebung für Build und Vorschau

Wenn ein Build fehlschlägt oder Ihre Vorschau nicht geladen wird, beginnen Sie mit dem ersten sichtbaren Fehler und arbeiten Sie den Wiederherstellungspfad für dieses Symptom durch. Diese Seite behandelt den App-Viewer, die Vorschau, Build-Fehler und die Schritte, die Sie unternehmen sollten, bevor Sie ein Problem melden.

Hier beginnen

Nachdem ein Agent eine Aufgabe abgeschlossen hat, lädt der App-Viewer Ihre App. Das Terminal zeigt Aufgabenaktivitäten und Fehler an, während Ihnen die Symbolleiste des App-Viewers ein Steuerelement zum Neuladen des App-Viewers, einen Wechsel für die Geräteansicht, eine Option zum Öffnen der Vorschau in einem neuen Tab und die Console bietet.

1. Speichern Sie die neueste Änderung und warten Sie, bis die aktuelle Aufgabe oder der aktuelle Build abgeschlossen ist.
2. Wählen Sie App-Viewer neu laden einmal aus, wenn die Vorschau veraltet aussieht oder auf einem Ladebildschirm stehen bleibt.
3. Öffnen Sie die Vorschau in einem neuen Tab, wenn der eingebettete App-Viewer hängen bleibt oder nicht reagiert.
4. Öffnen Sie die Console und kopieren Sie den ersten sichtbaren Fehler. Halten Sie den Projektlink und den Zeitpunkt des Fehlers fest.

Wenn der Build fehlschlägt

Versuchen Sie zuerst Resolve

Wenn Atoms ein Build-Problem erkennt, erscheint unten links eine Benachrichtigung zum Fehlerbericht. Wenn die Benachrichtigung Resolve enthält, starten Sie einen Reparaturversuch, bevor Sie eine andere Aktion ausführen.

1. Wählen Sie Resolve und warten Sie, bis der aktuelle Versuch abgeschlossen ist.
2. Wählen Sie Resolve nicht erneut aus, während es ausgeführt wird.
3. Wenn der Versuch nicht abgeschlossen wird, notieren Sie den sichtbaren Status und fahren Sie mit den unten stehenden Schritten zur Meldung fort. Starten Sie keinen weiteren Resolve-Versuch.
4. Wenn der Versuch abgeschlossen ist, prüfen Sie die aktualisierte Vorschau. Wenn sie nicht aktualisiert wird, aktualisieren Sie den Browser einmal.
5. Wiederholen Sie die Aktion, die das Problem verursacht hat. Wenn das Problem weiterhin besteht, erweitern Sie den Fehlerbericht und fahren Sie mit den unten stehenden Schritten zur Meldung fort.

Build-Fehler oder fehlende Abhängigkeit

Wenn das Vorschau-Panel einen Build-Fehler, ein rotes Fehlerbanner oder eine Meldung über ein fehlendes Paket anzeigt, verwenden Sie die genaue Meldung, um den nächsten Schritt einzugrenzen.

1. Öffnen Sie die Console und kopieren Sie die vollständige Fehlermeldung, die dort sichtbar ist.
2. Wenn Resolve verfügbar ist, verwenden Sie es einmal und warten Sie, bis der Versuch abgeschlossen ist.
3. Wenn es keine Schaltfläche Resolve gibt, fügen Sie den genauen Fehler in den Projekt-Chat ein und bitten Sie den Agent, diesen Build-Fehler zu beheben.
4. Wenn der Fehler nach einer bestimmten Änderung aufgetreten ist, öffnen Sie History und vergleichen Sie die aktuelle Version mit der letzten funktionierenden Version.
5. Wenn der Fehler schwer einzugrenzen ist, Remixen Sie von der letzten stabilen Version aus und wenden Sie Änderungen schrittweise erneut an.

Fehler, in denen App-Viewer, das Startskript, Publish, ein Bereitstellungsdatensatz oder interne Dateien eines Drittanbieterpakets erwähnt werden, können auf ein Plattformproblem hinweisen. Geben Sie die vollständige Fehlermeldung an, wenn Sie den Support kontaktieren.

Build bleibt in Bearbeitung

Prüfen Sie das Terminal auf aktuelle Aufgabenaktivität, bevor Sie es erneut versuchen. Wenn die Aufgabe oder der Build noch läuft, warten Sie, bis er abgeschlossen ist. Wenn der Vorgang nach dem Ende des aktuellen Versuchs weiterhin in Bearbeitung bleibt, notieren Sie den Status, den Zeitstempel, den Projektlink und alle sichtbaren Fehlerdetails und melden Sie dann das Problem.

Wenn die Vorschau oder der App-Viewer nicht geladen wird

Ladebildschirm oder nicht reagierende Vorschau

Prüfen Sie zunächst, ob nur der eingebettete App-Viewer betroffen ist oder ob auch die Vorschau-URL und die veröffentlichte Website betroffen sind.

1. Bestätigen Sie, ob die aktuelle Aufgabe oder der aktuelle Build noch läuft.
2. Wählen Sie einmal App-Viewer neu laden aus.
3. Öffnen Sie die Vorschau in einem neuen Browser-Tab.
4. Testen Sie dieselbe URL in einem Inkognito-Fenster.
5. Wenn die zuletzt bekannte funktionierende Version geladen wird, vergleichen Sie sie mit der letzten Änderung, durch die das Problem eingeführt wurde.

Wenn das Produkt ausdrücklich ein unzureichendes Cloud & AI-Guthaben oder eine ausgesetzte App meldet, öffnen Sie Settings → Cloud & AI und prüfen Sie diesen Status. Laden Sie nicht allein aufgrund eines leeren Bildschirms Guthaben auf.

Leere oder unvollständige Vorschau

Prüfen Sie, ob der leere Bildschirm die gesamte App oder nur eine Seite oder Komponente betrifft. Wenn nur ein Bereich betroffen ist, verwenden Sie die Seitenauswahl, um diese Seite direkt zu öffnen, und wiederholen Sie den kleinsten Nutzerpfad, der dorthin führt. Wenn die gesamte Vorschau leer ist, kehren Sie zum Build-Ergebnis zurück und beheben Sie den ersten Build- oder Laufzeitfehler, bevor Sie erneut testen.

Notieren Sie jeden Console- oder Network-Fehler, ohne Cookies, Token oder geheime Werte weiterzugeben. Wenn das Problem weiterhin besteht, fügen Sie die bereinigten Fehlerdetails Ihrem Bericht hinzu.

Vorschau zeigt eine ältere Version

Vorschau und veröffentlichte Website sind separate Kanäle. Stellen Sie sicher, dass die neuesten Änderungen gespeichert wurden und der neueste Build abgeschlossen ist, bevor Sie die Vorschau aktualisieren. Öffnen Sie die Vorschau nach Abschluss des Builds erneut. Wenn weiterhin ältere Inhalte angezeigt werden, vergleichen Sie die aktuelle Version mit der zuletzt bekannten funktionierenden Version in History.

Wenn die Vorschau falsch aussieht

Interaktionen oder Navigation funktionieren nicht

Eine Seite, die gerendert wird, ist nicht dasselbe wie eine Seite, die funktioniert. Öffnen Sie jeden wichtigen Navigationslink, drücken Sie die primären Schaltflächen, senden Sie die wichtigsten Formulare ab und folgen Sie dem Hauptnutzerpfad von Anfang bis Ende. Wenn eine Interaktion fehlschlägt, notieren Sie die genaue Aktion, bei der das erwartete Ergebnis ausbleibt, und testen Sie diesen Pfad nach jeder Korrektur erneut.

Mobiles Layout ist fehlerhaft

1. Verwenden Sie den Geräteumschalter in der Symbolleiste des App-Viewers, um zur mobilen Ansicht zu wechseln.
2. Wählen Sie das fehlerhafte Element im Designmodus aus, wenn verfügbar.
3. Beschreiben Sie das erwartete mobile Layout und was sich nicht ändern darf.
4. Wenden Sie eine Änderung an und prüfen Sie dann die Desktop- und Mobilansicht sowie Lade-, Leer-, Hover- und Fehlerzustände.

Bilder oder andere Assets fehlen

1. Öffnen Sie den Bereich „Files“ und bestätigen Sie, dass die referenzierte Datei vorhanden ist.
2. Prüfen Sie, ob Pfad, Dateiname und Format mit der von der App verwendeten Referenz übereinstimmen.
3. Wenn das Asset kürzlich verschoben oder umbenannt wurde, stellen Sie die Referenz wieder her oder aktualisieren Sie sie gezielt.
4. Wählen Sie App-Viewer neu laden und testen Sie die betroffene Seite erneut.

Der Agent hat das falsche Element geändert oder einen anderen Bereich beschädigt

1. Öffnen Sie History und Remixen Sie von der letzten stabilen Version aus.
2. Verwenden Sie den Designmodus, um das genaue Element anzusteuern, wenn er verfügbar ist.
3. Geben Sie an, was sich nicht ändern darf, und nehmen Sie pro Prompt nur eine Änderung vor.
4. Prüfen Sie das Ergebnis, bevor Sie mit der nächsten Änderung fortfahren.

Ein Problem melden

Melden Sie das Problem, wenn Resolve nicht verfügbar ist, das Problem nach einem abgeschlossenen Resolve-Versuch weiterhin besteht, die Vorschau nicht reagiert, der Projekt-Chat aber weiterhin funktioniert, oder unerwartetes Verhalten nach der Untersuchung durch den Agent weiterhin auftritt.

Feedback aus dem Projekt-Chat öffnen

1. Öffnen Sie den betroffenen Projekt-Chat und suchen Sie die neueste relevante Nachricht des Agent.
2. Wählen Sie ... (weitere Optionen) und dann Feedback.
3. Wählen Sie im Support-Messenger Send us a message und senden Sie den Bericht in der bestehenden Unterhaltung, wenn bereits eine vorhanden ist.

Den vollständigen Ablauf für den Fehlerbericht finden Sie unter Ein Problem melden.

Geben Sie genügend Details an, um das Problem zu reproduzieren

• Zusammenfassung des Problems. Beschreiben Sie das Problem in ein oder zwei Sätzen.
• Projekt- oder Chat-Link. Geben Sie die URL an, unter der das Problem aufgetreten ist.
• Datum und Uhrzeit. Geben Sie Ihre Zeitzone an.
• Schritte zur Reproduktion. Listen Sie die genauen Aktionen in der richtigen Reihenfolge auf.
• Erwartetes Ergebnis und tatsächliches Ergebnis. Geben Sie an, was hätte passieren sollen und was stattdessen passiert ist.
• Was Sie bereits versucht haben. Geben Sie an, ob Resolve angezeigt wurde, was nach Abschluss passiert ist und ob Aktualisieren oder Remixen das Ergebnis verändert hat.
• Browser und Gerät. Geben Sie Browser, Betriebssystem und Gerätetyp an.
• Nachweise. Fügen Sie einen Screenshot oder eine Aufzeichnung sowie die relevanten sichtbaren Details aus dem Fehlerbericht oder der Console bei.

Entfernen Sie Passwörter, API-Schlüssel, Authentifizierungs-Token, Cookies, Zahlungsdetails und nicht relevante persönliche oder vertrauliche Daten, bevor Sie Screenshots oder Protokolle weitergeben.

Nachdem das Problem behoben wurde

Durchlaufen Sie den Hauptnutzerpfad von Anfang bis Ende. Prüfen Sie die Vorschau sowohl in der Desktop- als auch in der Mobilansicht, öffnen Sie jede Seite über die Seitenauswahl und bestätigen Sie, dass die Console keine roten Fehlermeldungen enthält. Wenn die App zur Veröffentlichung bereit ist, ersetzen Sie alle Platzhalterinhalte und schließen Sie die Veröffentlichungsprüfungen im App-Viewer ab.

FAQ