Probleemoplossing voor build en preview

Wanneer een build mislukt of je preview niet laadt, begin dan met de eerste zichtbare fout en doorloop het herstelpad voor dat symptoom. Deze pagina behandelt de App Viewer, Preview, buildfouten en de stappen die je moet nemen voordat je een probleem meldt.

Begin hier

Nadat een Agent een taak heeft voltooid, laadt de App Viewer je app. De Terminal toont taakactiviteit en fouten, terwijl de werkbalk van de App Viewer je een besturingselement Reload App Viewer, een schakelaar voor apparaatweergave, een optie om de preview in een nieuw tabblad te openen en de Console geeft.

1. Sla de laatste wijziging op en wacht tot de huidige taak of build is voltooid.
2. Selecteer Reload App Viewer één keer als de preview verouderd lijkt of op een laadscherm blijft staan.
3. Open de preview in een nieuw tabblad als de ingesloten App Viewer vastzit of niet reageert.
4. Open Console en kopieer de eerste zichtbare fout. Bewaar de projectlink en het tijdstip van de storing.

Wanneer de build mislukt

Probeer eerst Resolve

Wanneer Atoms een buildprobleem detecteert, verschijnt er linksonder een melding Probleemrapport. Als de melding Resolve bevat, start dan één herstelpoging voordat je een andere actie onderneemt.

1. Selecteer Resolve en wacht tot de huidige poging is voltooid.
2. Selecteer Resolve niet opnieuw terwijl het wordt uitgevoerd.
3. Als de poging niet wordt voltooid, noteer dan de zichtbare status en ga verder met de onderstaande rapportagestappen. Start geen nieuwe Resolve-poging.
4. Wanneer de poging is voltooid, controleer dan de vernieuwde preview. Als deze niet wordt bijgewerkt, vernieuw de browser dan één keer.
5. Herhaal de actie die het probleem veroorzaakte. Als het probleem blijft bestaan, vouw dan het Probleemrapport uit en ga verder met de onderstaande rapportagestappen.

Buildfout of ontbrekende dependency

Als het paneel Preview een buildfout, een rode foutbanner of een bericht over een ontbrekend pakket toont, gebruik dan het exacte bericht om de volgende stap te bepalen.

1. Open Console en kopieer de volledige foutmelding die daar zichtbaar is.
2. Als Resolve beschikbaar is, gebruik het dan één keer en wacht tot de poging is voltooid.
3. Als er geen knop Resolve is, plak dan de exacte fout in Project chat en vraag de Agent om die buildfout te verhelpen.
4. Als de fout begon na een specifieke wijziging, open dan History en vergelijk de huidige versie met de laatst werkende versie.
5. Als de fout moeilijk te isoleren is, voer dan een Remix uit vanaf de laatste stabiele versie en pas wijzigingen stapsgewijs opnieuw toe.

Fouten waarin App Viewer, het opstartscript, Publish, een deployrecord of de interne bestanden van een pakket van derden worden genoemd, kunnen wijzen op een platformprobleem. Voeg de volledige foutmelding toe wanneer je contact opneemt met Support.

Build blijft in uitvoering

Controleer de Terminal op huidige taakactiviteit voordat je het opnieuw probeert. Als de taak of build nog steeds wordt uitgevoerd, wacht dan tot deze is voltooid. Als deze in uitvoering blijft nadat de huidige poging is beëindigd, noteer dan de status, tijdstempel, projectlink en alle zichtbare foutdetails en meld vervolgens het probleem.

Wanneer de Preview of App Viewer niet laadt

Laadscherm of niet-reagerende preview

Controleer eerst of alleen de ingesloten App Viewer is getroffen, of dat de Preview-URL en de gepubliceerde site ook zijn getroffen.

1. Bevestig of de huidige taak of build nog steeds wordt uitgevoerd.
2. Selecteer Reload App Viewer één keer.
3. Open de Preview in een nieuw browsertabblad.
4. Test dezelfde URL in een Incognito-venster.
5. Als de laatst bekende werkende versie laadt, vergelijk deze dan met de recente wijziging die het probleem heeft veroorzaakt.

Als het product expliciet meldt dat er een onvoldoende Cloud & AI-saldo is of dat de app is opgeschort, open dan Settings → Cloud & AI en controleer die status. Waardeer niet op alleen op basis van een leeg scherm.

Lege of onvolledige preview

Controleer of het lege scherm de hele app treft of slechts één pagina of component. Als slechts één gebied is getroffen, gebruik dan de paginaselector om die pagina direct te openen en herhaal de kleinste gebruikersreis die daarheen leidt. Als de hele preview leeg is, ga dan terug naar het buildresultaat en los de eerste build- of runtimefout op voordat je opnieuw test.

Noteer elke Console- of Network-fout zonder cookies, tokens of geheime waarden te delen. Als het probleem aanhoudt, voeg dan de opgeschoonde foutdetails toe aan je rapport.

Preview toont een oudere versie

Preview en de gepubliceerde site zijn afzonderlijke kanalen. Zorg ervoor dat de laatste wijzigingen zijn opgeslagen en dat de laatste build is voltooid voordat je de preview vernieuwt. Open de Preview opnieuw nadat de build is voltooid. Als nog steeds oudere inhoud wordt getoond, vergelijk dan de huidige versie met de laatst bekende werkende versie in History.

Wanneer de preview er verkeerd uitziet

Interacties of navigatie werken niet

Een pagina die wordt gerenderd is niet hetzelfde als een pagina die werkt. Open elke belangrijke navigatielink, druk op de primaire knoppen, verstuur de belangrijkste formulieren en volg de hoofdgebruikersreis van begin tot eind. Wanneer één interactie mislukt, noteer dan de exacte actie waarbij het verwachte resultaat stopt en test dat pad opnieuw na elke correctie.

Mobiele lay-out is kapot

1. Gebruik de apparaatschakelaar in de werkbalk van de App Viewer om over te schakelen naar mobiele weergave.
2. Selecteer het kapotte element in de Design-modus wanneer beschikbaar.
3. Beschrijf de verwachte mobiele lay-out en wat niet mag veranderen.
4. Pas één wijziging toe en controleer daarna desktop- en mobiele weergaven plus laad-, lege, hover- en foutstatussen.

Afbeeldingen of andere assets ontbreken

1. Open de sectie Files en bevestig dat het bestand waarnaar wordt verwezen bestaat.
2. Controleer of het pad, de bestandsnaam en de indeling overeenkomen met de verwijzing die door de app wordt gebruikt.
3. Als de asset onlangs is verplaatst of hernoemd, herstel dan de verwijzing of werk deze bewust bij.
4. Selecteer Reload App Viewer en test de getroffen pagina opnieuw.

De Agent heeft het verkeerde element gewijzigd of een ander gebied kapotgemaakt

1. Open History en voer een Remix uit vanaf de laatste stabiele versie.
2. Gebruik de Design-modus om het exacte element te targeten wanneer dit beschikbaar is.
3. Geef aan wat niet mag veranderen en voer één wijziging per prompt door.
4. Controleer het resultaat voordat je doorgaat naar de volgende wijziging.

Meld een probleem

Meld het probleem wanneer Resolve niet beschikbaar is, het probleem blijft bestaan na een voltooide Resolve-poging, de Preview niet reageert maar Project chat nog wel werkt, of onverwacht gedrag aanhoudt nadat de Agent onderzoek heeft gedaan.

Open Feedback vanuit Project chat

1. Open de getroffen Project chat en zoek het meest recente relevante bericht van de Agent.
2. Selecteer ... (meer opties) en selecteer vervolgens Feedback.
3. Selecteer in de supportmessenger Send us a message en verstuur het rapport in het bestaande gesprek als dat al bestaat.

Zie voor de volledige flow van Probleemrapport Meld een probleem.

Voeg voldoende details toe om het probleem te reproduceren

• Samenvatting van het probleem. Beschrijf het probleem in één of twee zinnen.
• Project- of chatlink. Voeg de URL toe waar het probleem optrad.
• Datum en tijd. Vermeld je tijdzone.
• Stappen om te reproduceren. Som de exacte acties in volgorde op.
• Verwacht resultaat en daadwerkelijk resultaat. Geef aan wat had moeten gebeuren en wat er in plaats daarvan gebeurde.
• Wat je al hebt geprobeerd. Geef aan of Resolve verscheen, wat er gebeurde nadat het was voltooid en of vernieuwen of Remix het resultaat veranderde.
• Browser en apparaat. Vermeld de browser, het besturingssysteem en het apparaattype.
• Bewijs. Voeg een screenshot of opname toe en de relevante zichtbare details van Probleemrapport of Console.

Verwijder wachtwoorden, API-sleutels, authenticatietokens, cookies, betaalgegevens en niet-gerelateerde persoonlijke of vertrouwelijke gegevens voordat je screenshots of logs deelt.

Nadat het probleem is opgelost

Doorloop de hoofdgebruikersreis van begin tot eind. Controleer de Preview in zowel desktop- als mobiele weergave, open elke pagina vanuit de paginaselector en bevestig dat de Console geen rode foutmeldingen bevat. Als de app klaar is om te publiceren, vervang dan eventuele tijdelijke inhoud en voltooi de publicatiecontroles in de App Viewer.

FAQ