Sari la conținut
Verificat

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ă

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

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

bash
npm run clean:readmes

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

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/

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

js
module.exports = {
  entry: 'index.html',
  port: 3000,
  ssr: 'none',
  api_key: '',
  build_id: '',
};
Lasă build_id nesetat

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.