Hibakeresés

Probléma-alapú tartalomjegyzék. Nyisd meg azt az oldalt, amelyik a tüneteddel egyezik.

Akkor használd, ha

Valami hibázik, és gyorsan be akarod határolni.

Mit látsz?

Semmi sem jelenik meg

• Az oldal betölt, de a canvas üres, vagy a hely teljesen kong.
• A DevTools konzolon van hiba vagy 404, néha viszont semmi.

→ Nem töltődik be az animáció (404, CORS, WASM, CSP, fájlútvonal hibák)

Renderelődik, de a méret vagy az élesség rossz

• Az animáció rossz méretben, nyújtottan, összepréselve vagy levágva jelenik meg.
• Pixeles, homályos vagy alacsony felbontású Retina / 4K kijelzőn.
• Ablakméret-változtatáskor villog vagy ugrik a méret.

→ Rossz méret vagy homályos (canvas CSS, DPR, resizeDrawingSurfaceToCanvas)

Lejátszódik, de nem reagál az interakciókra

• A hover / klikk nem csinál semmit.
• Egy animáción belüli gomb láthatóan lenyomódik, de a kódod nem kapja meg az eseményt.
• A stateMachineInputs(...) üres tömböt ad.

→ State machine nem működik (rossz nevek, rossz artboard, rossz input típus)

Egyetlen animáció jól megy, de a több-animációs oldal elszáll

• Az első néhány animáció jó, a többi feketébe vált.
• A konzolon WebGL context lost figyelmeztetés.
• A memória nő, ahogy mész az animációkkal teli oldalak között.

→ Több animáció egy oldalon (offscreen renderer, cleanup, WebGL context limit)

Gyorstriázs checklist

Mielőtt bármelyik fenti oldalt megnyitnád, fuss végig ezeken:

1. Nyisd meg a böngésző DevTools konzolját. Van hiba? Készíts képet.
2. Nyisd meg a Network fület. A .riv kérés 200-zal jön vissza? Van CORS-figyelmeztetés?
3. Ellenőrizd a neveket. Nyisd meg a handoff.md-et, és vesd össze betűről betűre a kódoddal — a kis- / nagybetűt is.
4. Ellenőrizd a runtime-ot. A Lupian-csomagokhoz a @rive-app/webgl2 az alapértelmezett biztonságos választás.
5. Próbáld ki a fájlt a demo.lupian.studio-on. Ha ott megy, a baj a te oldaladon van, nem a fájlban.

Ha elakadsz, ezt küldd a Lupiannak

• A tünet (egy mondatban).
• Az oldal URL-jét vagy a repót.
• Konzol + Network képeket.
• A kapott handoff.md-et.
• A teljes lista: Kérj segítséget a Lupiantól.