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
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
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
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
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.