Felsökning för build och förhandsvisning

När en build misslyckas eller din förhandsvisning inte läses in, börja med det första synliga felet och följ återställningsvägen för det symptomet. Den här sidan täcker App Viewer, Preview, buildfel och stegen du ska ta innan du rapporterar ett problem.

Börja här

När en Agent har slutfört en uppgift läser App Viewer in din app. Terminal visar uppgiftsaktivitet och fel, medan verktygsfältet i App Viewer ger dig en kontroll för Reload App Viewer, en växling för enhetsvy, ett alternativ för att öppna förhandsvisningen i en ny flik och Console.

1. Spara den senaste ändringen och vänta tills den aktuella uppgiften eller builden är klar.
2. Välj Reload App Viewer en gång om förhandsvisningen verkar inaktuell eller stannar på en laddningsskärm.
3. Öppna förhandsvisningen i en ny flik om den inbäddade App Viewer har hängt sig eller inte svarar.
4. Öppna Console och kopiera det första synliga felet. Spara projektlänken och tiden för felet.

När builden misslyckas

Prova Resolve först

När Atoms upptäcker ett buildproblem visas en avisering om Issue Report i det nedre vänstra hörnet. Om aviseringen innehåller Resolve, börja med ett reparationsförsök innan du gör något annat.

1. Välj Resolve och vänta tills det aktuella försöket är klart.
2. Välj inte Resolve igen medan det körs.
3. Om försöket inte slutförs, notera den synliga statusen och fortsätt med rapporteringsstegen nedan. Starta inte ett nytt Resolve-försök.
4. När försöket är klart, kontrollera den uppdaterade förhandsvisningen. Om den inte uppdateras, uppdatera webbläsaren en gång.
5. Upprepa åtgärden som orsakade problemet. Om problemet kvarstår, expandera Issue Report och fortsätt med rapporteringsstegen nedan.

Buildfel eller saknat beroende

Om panelen Preview visar ett buildfel, en röd felbanner eller ett meddelande om ett saknat paket, använd det exakta meddelandet för att begränsa nästa steg.

1. Öppna Console och kopiera hela felmeddelandet som visas där.
2. Om Resolve är tillgängligt, använd det en gång och vänta tills försöket är klart.
3. Om det inte finns någon knapp för Resolve, klistra in det exakta felet i Project chat och be Agent att åtgärda det buildfelet.
4. Om felet började efter en specifik ändring, öppna History och jämför den aktuella versionen med den senaste fungerande versionen.
5. Om felet är svårt att isolera, gör en Remix från den senaste stabila versionen och återapplicera ändringar stegvis.

Fel som nämner App Viewer, startskriptet, Publish, en deploy-post eller interna filer i ett tredjepartspaket kan tyda på ett plattformsproblem. Inkludera hela felmeddelandet när du kontaktar Support.

Builden förblir pågående

Kontrollera Terminal för aktuell uppgiftsaktivitet innan du försöker igen. Om uppgiften eller builden fortfarande körs, vänta tills den är klar. Om den fortfarande är pågående efter att det aktuella försöket har avslutats, notera status, tidsstämpel, projektlänk och alla synliga feldetaljer och rapportera sedan problemet.

När Preview eller App Viewer inte läses in

Laddningsskärm eller förhandsvisning som inte svarar

Kontrollera först om bara den inbäddade App Viewer påverkas, eller om även Preview-URL:en och den publicerade webbplatsen påverkas.

1. Bekräfta om den aktuella uppgiften eller builden fortfarande körs.
2. Välj Reload App Viewer en gång.
3. Öppna Preview i en ny webbläsarflik.
4. Testa samma URL i ett inkognitofönster.
5. Om den senast kända fungerande versionen läses in, jämför den med den senaste ändringen som introducerade problemet.

Om produkten uttryckligen rapporterar otillräckligt Cloud & AI-saldo eller en pausad app, öppna Settings → Cloud & AI och granska den statusen. Fyll inte på enbart baserat på en tom skärm.

Tom eller ofullständig förhandsvisning

Kontrollera om den tomma skärmen påverkar hela appen eller bara en sida eller komponent. Om bara ett område påverkas, använd sidväljaren för att öppna den sidan direkt och upprepa den minsta användarresa som når dit. Om hela förhandsvisningen är tom, gå tillbaka till buildresultatet och lös det första build- eller runtime-felet innan du testar igen.

Notera eventuella fel i Console eller Network utan att dela cookies, tokens eller hemliga värden. Om problemet fortsätter, inkludera de rensade feldetaljerna i din rapport.

Preview visar en äldre version

Preview och den publicerade webbplatsen är separata kanaler. Se till att de senaste ändringarna har sparats och att den senaste builden har slutförts innan du uppdaterar förhandsvisningen. Öppna Preview igen efter att builden har slutförts. Om den fortfarande visar äldre innehåll, jämför den aktuella versionen med den senast kända fungerande versionen i History.

När förhandsvisningen ser fel ut

Interaktioner eller navigering fungerar inte

En sida som renderas är inte samma sak som en sida som fungerar. Öppna varje viktig navigeringslänk, tryck på de primära knapparna, skicka in de viktigaste formulären och följ den huvudsakliga användarresan från början till slut. När en interaktion misslyckas, notera den exakta åtgärden där det förväntade resultatet upphör och testa den vägen igen efter varje korrigering.

Mobil layout är trasig

1. Använd enhetsväxlingen i verktygsfältet i App Viewer för att byta till mobilvy.
2. Välj det trasiga elementet i Design mode när det är tillgängligt.
3. Beskriv den förväntade mobila layouten och vad som inte får ändras.
4. Gör en ändring och verifiera sedan desktop- och mobilvyer samt laddnings-, tomma-, hover- och feltillstånd.

Bilder eller andra resurser saknas

1. Öppna avsnittet Files och bekräfta att den refererade filen finns.
2. Kontrollera att sökvägen, filnamnet och formatet matchar referensen som appen använder.
3. Om resursen nyligen flyttades eller bytte namn, återställ referensen eller uppdatera den medvetet.
4. Välj Reload App Viewer och testa den påverkade sidan igen.

Agent ändrade fel element eller förstörde ett annat område

1. Öppna History och gör en Remix från den senaste stabila versionen.
2. Använd Design mode för att rikta in dig på det exakta elementet när det är tillgängligt.
3. Ange vad som inte får ändras och gör en ändring per prompt.
4. Verifiera resultatet innan du fortsätter till nästa ändring.

Rapportera ett problem

Rapportera problemet när Resolve inte är tillgängligt, problemet kvarstår efter ett slutfört Resolve-försök, Preview inte svarar men Project chat fortfarande fungerar, eller oväntat beteende fortsätter efter att Agent har undersökt det.

Öppna Feedback från Project chat

1. Öppna den berörda Project chat och hitta det senaste relevanta meddelandet från Agent.
2. Välj ... (fler alternativ) och välj sedan Feedback.
3. I supportmeddelandetjänsten väljer du Send us a message och skickar rapporten i den befintliga konversationen om en sådan redan finns.

För det fullständiga flödet för Issue Report, se Report an Issue.

Inkludera tillräckligt med detaljer för att återskapa problemet

• Sammanfattning av problemet. Beskriv problemet i en eller två meningar.
• Projekt- eller chattlänk. Inkludera URL:en där problemet uppstod.
• Datum och tid. Inkludera din tidszon.
• Steg för att återskapa. Lista de exakta åtgärderna i ordning.
• Förväntat resultat och faktiskt resultat. Ange vad som borde ha hänt och vad som hände i stället.
• Vad du redan har provat. Ange om Resolve visades, vad som hände efter att det slutfördes och om uppdatering eller Remix ändrade resultatet.
• Webbläsare och enhet. Inkludera webbläsare, operativsystem och enhetstyp.
• Bevis. Bifoga en skärmbild eller inspelning samt relevanta synliga detaljer från Issue Report eller Console.

Ta bort lösenord, API-nycklar, autentiseringstokens, cookies, betalningsuppgifter och orelaterade personliga eller konfidentiella data innan du delar skärmbilder eller loggar.

Efter att problemet har åtgärdats

Kör den huvudsakliga användarresan från början till slut. Kontrollera Preview i både desktop- och mobilvyer, öppna varje sida från sidväljaren och bekräfta att Console inte har några röda felmeddelanden. Om appen är redo att publiceras, ersätt allt platshållarinnehåll och slutför publiceringskontrollerna i App Viewer.

Vanliga frågor