Telepítés és projekt létrehozása
Hozzon létre egy Xuda CLI projektet egyetlen paranccsal, majd ismerje meg, mire való minden generált fájl.
Mielőtt elkezdi
A CLI úthoz Node.js 18.17.0 vagy újabb szükséges, ez az a minimális motorverzió, amelyet az xuda-cli
előír. Más nem kell: maga az xuda-cli három csomagtól függ (express, socket.io, chokidar), az
új projektet létrehozó vázgenerátornak pedig nincsenek saját függőségei. A helyi fejlesztés soha nem
hív csomaghoz kötött metódust, így az alkalmazás így való építése semmibe sem kerül.
Hozzon létre egy új alkalmazást
Nézze meg, mit írt a create-xuda-cli
A vázgenerátor egy package.json fájlt ír, amely már függőségként tartalmazza a
@xuda.io/xuda-framework-plugin-tailwind és a @xuda.io/xuda-dbs-plugin-xuda csomagot, fejlesztői
függőségként pedig az xuda-cli-t, továbbá egy xuda.config.js fájlt, az App.xu és index.html
fájlt, egy components/ mappát és egy első node_modules/.project_data/globals.json fájlt. Tizenkét
mappába egy generált README.md útmutatót is elhelyez: a tizenegy típusos forrásmappába, plusz magába
a data/ mappába, és mindegyik később eltávolítható.
Nyissa meg az alkalmazást
Az npm run dev kiírja az URL-t, amelyen figyel, alapértelmezés szerint http://localhost:3000. Az
index.html mint keret kerül kiszolgálásra, az App.xu pedig automatikusan a #app elembe
csatolódik, mert a generált konfiguráció az entry: 'index.html' értéket állítja be, és más komponens
nem tart igényt arra az elemre. Az App.xu mindig az app programazonosítóra fordul.
Szerkessze és mentse
Szerkessze az App.xu fájlt, és mentse. A figyelő újrafordítja a projektet, újragenerálja a
futásidejű dokumentumokat, és egy socket.io csatornán újratöltést küld, így a böngésző magától
frissül.
Törölje a mappaútmutatókat, ha már nincs rájuk szüksége
Ez csak a vázgenerátor által létrehozott README fájlokat törli (egy belső jelölő alapján követi őket). A saját kezűleg írt README fájlokat érintetlenül hagyja, és a parancs külön jelzi az eltávolított, kihagyott és hiányzó fájlok számát.
A gondolkodási modell: három réteg
Ha az xuda.config.js az entry: 'index.html' értéket állítja be, először a HTML-keret kerül
kiszolgálásra, és az App.xu a #app elembe csatolódik, hacsak valami más nem foglalta le azt az
elemet. Ha az entry hiányzik, az xuda-cli HTML-fájl helyett az app programazonosítót használja
alapértelmezésként.
Ajánlott felosztás: az index.html maradjon az oldalkeret, az App.xu a gyökérképernyő, a funkció-
képernyőket pedig a components/ alá tegye.
A projekt felépítése
A A .xu nyelv oldalon megtudhatja, mi tartozik az egyes mappákba, és hogyan dönti el a fájl mappája az egység típusát.
xuda.config.js
A build_id beállítása az api_key-t is kötelezővé teszi, és egy olyan távoli build-útvonalat céloz,
amely mögött még nincs megvalósítás, így a projekt nem épül távolról, hanem nem fog betöltődni.
A parancsokról, az SSR módokról és a felhőszinkronról minden más a A CLI referenciája oldalon található.
Generált futásidejű dokumentumok
Az xuda-cli a futásidejű dokumentumokat mindig a node_modules/.project_data/ mappába fordítja, egy
globals.json fájllal és programonként egy fájllal. Az ottani elavult fájlok minden fordításkor
törlődnek. Kezelje build-kimenetként: a forrás az Ön által írt .xu és .json5 fájl.
Régebbi anyagokban találkozhat project_data/ mappával vagy gyökér .project_data/ mappával. Ezek
csak importálásra szolgáló, migrációhoz megtartott örökölt útvonalak, soha nem írásra való helyek.