Ugrás a tartalomhoz
Ellenőrizve

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

bash
npm create xuda-cli@latest my-app
cd my-app
npm install
npm run dev

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

bash
npm run clean:readmes

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

my-app/  package.json  xuda.config.js  index.html  App.xu
components/ globals/ data/ get/ set/ batch/ apis/ scripts/ alerts/ tables/ routes/ ai-agents/
node_modules/ .project_data/

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

js
module.exports = {
  entry: 'index.html',
  port: 3000,
  ssr: 'none',
  api_key: '',
  build_id: '',
};
Hagyja beállítatlanul a build_id-t

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.