Instalează și creează un proiect
Generează un proiect Xuda CLI cu o singură comandă, apoi află la ce folosește fiecare fișier generat.
Înainte de a începe
Calea CLI cere Node.js 18.17.0 sau mai nou, adică pragul minim declarat de xuda-cli.
Nimic altceva: xuda-cli în sine depinde de trei pachete (express, socket.io, chokidar),
iar generatorul care creează un proiect nou nu are dependențe proprii. Dezvoltarea locală
nu apelează niciodată o metodă limitată de plan, deci construirea unei aplicații astfel nu costă nimic.
Generează o aplicație nouă
Vezi ce a scris create-xuda-cli
Generatorul scrie un package.json care declară deja @xuda.io/xuda-framework-plugin-tailwind
și @xuda.io/xuda-dbs-plugin-xuda ca dependențe și xuda-cli ca dependență de dezvoltare, un
xuda.config.js, App.xu, index.html, un folder components/ și un prim
node_modules/.project_data/globals.json. Pune, de asemenea, un ghid README.md generat în douăsprezece
foldere: cele unsprezece foldere sursă tipizate plus unul pentru data/ în sine, fiecare putând fi eliminat mai târziu.
Deschide aplicația
npm run dev afișează URL-ul pe care ascultă, implicit http://localhost:3000. index.html este
servit ca shell, iar App.xu se montează automat în #app, pentru că configurația generată
setează entry: 'index.html' și nicio altă componentă nu revendică acel element. App.xu se compilează întotdeauna
la id-ul de program app.
Editează și salvează
Editează App.xu și salvează. Watcher-ul recompilează proiectul, regenerează documentele de runtime și
trimite o reîncărcare printr-un canal socket.io, așa că browserul se actualizează singur.
Curăță ghidurile de foldere când nu mai ai nevoie de ele
Aceasta șterge doar fișierele README pe care le-a generat generatorul (urmărite printr-un marcaj intern). Orice README scris de tine este lăsat în pace, iar comanda raportează separat numărul celor șterse, sărite și lipsă.
Modelul mental: trei straturi
Dacă xuda.config.js setează entry: 'index.html', shell-ul HTML este servit primul, iar App.xu se montează
în #app, dacă acel element nu a fost deja revendicat de altceva. Dacă entry lipsește, xuda-cli
folosește implicit id-ul de program app, nu un fișier HTML.
Împărțirea recomandată: păstrează index.html ca shell al paginii, păstrează App.xu ca ecran rădăcină și adaugă
ecranele de funcționalități în components/.
Structura proiectului
Vezi Limbajul .xu pentru ce aparține fiecărui folder și cum folderul în care se află un fișier îi decide tipul de unitate.
xuda.config.js
Setarea lui build_id face obligatorie și api_key și vizează o cale de build la distanță care încă nu are
implementare în spate, așa că proiectul va eșua la încărcare în loc să se construiască la distanță.
Tot restul despre comenzi, moduri SSR și sincronizarea cu cloud-ul se află în Referința CLI.
Documente de runtime generate
xuda-cli compilează întotdeauna documentele de runtime în node_modules/.project_data/, un globals.json plus
un fișier pentru fiecare program. Fișierele vechi de acolo sunt șterse la fiecare compilare. Tratează-l ca output de build: fișierele
.xu și .json5 pe care le scrii sunt sursa de adevăr.
Poți vedea un folder project_data/ sau un folder .project_data/ în rădăcină în materiale mai vechi. Acestea sunt
căi legacy, doar pentru import, păstrate pentru migrare, niciodată un loc în care să scrii.