Atoms
Felsökning

Bygg- och förhandsgranskningsfelsökning

När en build misslyckas eller din förhandsgranskning inte laddas, börja med det första synliga felet och arbeta dig igenom återställningsvägen för det symptomet. Den här sidan täcker Preview, build-fel och stegen att ta innan du rapporterar ett problem.

Börja här

När en Agent har slutfört en uppgift laddar Preview din app. Använd verktygsfältet i Preview för att uppdatera appen, växla enhetsvyer eller öppna den i en ny flik. Öppna More → Terminal för att granska uppgiftsaktivitet och fel. Kontrollera Console för fel från appen som körs.

  1. Spara den senaste ändringen och vänta tills den aktuella uppgiften eller builden är klar.
  2. Använd uppdateringskontrollen i Preview en gång om förhandsgranskningen verkar inaktuell eller stannar på en laddningsskärm.
  3. Öppna förhandsgranskningen i en ny flik om den inbäddade förhandsgranskningen 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 build-problem visas en avisering om Issue Report i det nedre vänstra hörnet. Om aviseringen innehåller Resolve, starta 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örhandsgranskningen. 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.

Build-fel eller saknat beroende

Om panelen Preview visar ett build-fel, en röd felbanner eller ett meddelande om ett saknat paket, använd det exakta meddelandet för att avgöra 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 Resolve-knapp, klistra in det exakta felet i projektchatten och be Agent att åtgärda det build-felet.
  4. Om felet började efter en specifik ändring, öppna History och jämför den aktuella versionen med den senast fungerande versionen.
  5. Om felet är svårt att isolera, Remix från den senaste stabila versionen och återapplicera ändringar stegvis.

Fel som nämner förhandsgranskningskomponenten, startskriptet, Publish, en distributionspost eller interna filer i ett tredjepartspaket kan tyda på ett plattformsproblem. Inkludera hela felmeddelandet när du kontaktar Support.

Builden förblir pågår

Öppna More → Terminal för att kontrollera aktuell uppgiftsaktivitet innan du försöker igen. Om uppgiften eller builden fortfarande körs, vänta tills den är klar. Om den fortfarande pågår 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 inte laddas

Laddningsskärm eller förhandsgranskning som inte svarar

Kontrollera först om endast den inbäddade förhandsgranskningen 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. Använd uppdateringskontrollen i Preview en gång.
  3. Öppna Preview i en ny webbläsarflik.
  4. Testa samma URL i ett inkognitofönster.
  5. Om den senast fungerande versionen laddas, 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örhandsgranskning

Kontrollera om den tomma skärmen påverkar hela appen eller bara en sida eller komponent. Om endast 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örhandsgranskningen är tom, gå tillbaka till build-resultatet och lös det första build- eller körtidsfelet innan du testar igen.

Notera eventuella Console- eller Network-fel utan att dela cookies, tokens eller hemliga värden. Om problemet fortsätter, inkludera de sanerade 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örhandsgranskningen. Öppna Preview igen när builden är klar. Om den fortfarande visar äldre innehåll, jämför den aktuella versionen med den senast fungerande versionen i History.

När förhandsgranskningen 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äxlaren i verktygsfältet i Preview för att växla till mobilvy.
  2. I Preview öppnar du designverktygsfältet, väljer Select element och klickar på elementet med den trasiga layouten.
  3. Beskriv den förväntade mobillayouten och vad som inte får ändras.
  4. Tillämpa en ändring och verifiera sedan desktop- och mobilvyer samt laddnings-, tomma-, hover- och feltillstånd.

Bilder eller andra resurser saknas

  1. Öppna Code och kontrollera filträdet för den refererade filen.
  2. Kontrollera att sökvägen, filnamnet och formatet matchar referensen som används av appen.
  3. Om resursen nyligen flyttades eller bytte namn, återställ referensen eller uppdatera den medvetet.
  4. Uppdatera Preview och testa den påverkade sidan igen.

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

  1. Öppna History och Remix från den senaste stabila versionen.
  2. I Preview väljer du Select element i designverktygsfältet och klickar på elementet du vill ändra.
  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 projektchatten fortfarande fungerar, eller oväntat beteende fortsätter efter att Agent har undersökt det.

Öppna Feedback från projektchatten

  1. Öppna den berörda projektchatten och hitta det senaste relevanta meddelandet från Agent.
  2. Välj ... (fler alternativ) och välj sedan Feedback.
  3. I supportmeddelandet 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

  • Problemsammanfattning. 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 och 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.

När problemet är åtgärdat

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 öppna Publish för att slutföra publiceringskontrollerna.

FAQ

Varför visar Preview en tom vit skärm?
  1. Bekräfta om problemet endast påverkar den inbäddade förhandsgranskningen, Preview-URL:en eller även den publicerade webbplatsen.
  2. Uppdatera Preview en gång, öppna Preview i en ny flik och testa ett inkognitofönster.
  3. Kontrollera om den aktuella uppgiften eller builden fortfarande körs. Vänta tills den är klar innan du försöker igen.
  4. Om ett uttryckligt meddelande säger att Cloud & AI-saldot är otillräckligt eller att appen är pausad, öppna Settings → Cloud & AI och granska det saldot. Fyll inte på enbart baserat på en tom skärm.
  5. Notera eventuella Console- eller Network-fel utan att dela cookies, tokens eller hemliga värden.

Om skärmen förblir tom, kontakta Support med chattlänken, fullständig Preview-URL, tid och tidszon, påverkade miljöer, skärmbild och sanerade feldetaljer.

Var den här sidan hjälpsam?

Relaterade artiklar