Hopp til innholdet
Bekreftet

Installer og opprett et prosjekt

Sett opp et Xuda CLI-prosjekt med én kommando, og lær hva hver genererte fil brukes til.

Før du starter

CLI-veien trenger Node.js 18.17.0 eller nyere, som er den nedre grensen xuda-cli oppgir. Ikke noe mer: xuda-cli selv avhenger av tre pakker (express, socket.io, chokidar), og verktøyet som setter opp et nytt prosjekt har ingen egne avhengigheter. Lokal utvikling kaller aldri en metode som er låst bak et abonnement, så det koster ingenting å bygge en app på denne måten.

Sett opp en ny app

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

Se hva create-xuda-cli skrev

Verktøyet skriver en package.json som allerede har @xuda.io/xuda-framework-plugin-tailwind og @xuda.io/xuda-dbs-plugin-xuda som avhengigheter og xuda-cli som utviklingsavhengighet, en xuda.config.js, App.xu, index.html, en components/-mappe og en første node_modules/.project_data/globals.json. Det legger også en generert README.md-guide i tolv mapper: de elleve typede kildemappene pluss én for selve data/, og hver av dem kan fjernes senere.

Åpne appen

npm run dev skriver ut URL-en den lytter på, http://localhost:3000 som standard. index.html serveres som skallet og App.xu monteres automatisk i #app, fordi den genererte konfigurasjonen setter entry: 'index.html' og ingen annen komponent gjør krav på det elementet. App.xu kompileres alltid til program-ID-en app.

Rediger og lagre

Rediger App.xu og lagre. Overvåkeren kompilerer prosjektet på nytt, genererer kjøretidsdokumentene på nytt og sender en reload over en socket.io-kanal, så nettleseren oppdaterer seg selv.

Fjern mappeguidene når du ikke trenger dem lenger

bash
npm run clean:readmes

Dette sletter bare README-filene som verktøyet genererte (sporet med en intern markør). Alle README-er du har skrevet selv blir liggende, og kommandoen rapporterer antall fjernede, hoppet over og manglende hver for seg.

Den mentale modellen: tre lag

Hvis xuda.config.js setter entry: 'index.html', serveres HTML-skallet først og App.xu monteres i #app med mindre noe annet allerede har gjort krav på det elementet. Hvis entry utelates, bruker xuda-cli program-ID-en app som standard i stedet for en HTML-fil.

Anbefalt oppdeling: behold index.html som sideskallet, behold App.xu som rot-skjermen, og legg funksjonsskjermer under components/.

Prosjektoppsettet

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/

Se Xu-språket for hva som hører hjemme i hver mappe og hvordan mappen en fil ligger i bestemmer enhetstypen.

xuda.config.js

js
module.exports = {
  entry: 'index.html',
  port: 3000,
  ssr: 'none',
  api_key: '',
  build_id: '',
};
La build_id stå uten verdi

Hvis build_id settes, blir api_key også obligatorisk, og det peker på en ekstern byggevei som ikke har noen implementasjon bak seg ennå, så prosjektet vil feile ved lasting i stedet for å bygge eksternt.

Alt annet om kommandoer, SSR-moduser og skysynkronisering finner du i CLI-referansen.

Genererte kjøretidsdokumenter

xuda-cli kompilerer alltid kjøretidsdokumenter til node_modules/.project_data/, én globals.json pluss én fil per program. Gamle filer der slettes ved hver kompilering. Behandle det som byggeresultat: .xu- og .json5-filene du skriver er sannhetskilden.

Du kan se en project_data/-mappe eller en .project_data/-mappe i roten i eldre materiale. Det er gamle stier som bare er beholdt for import ved migrering, aldri et sted å skrive.