İçeriğe geç
Doğrulandı

Kurulum ve proje oluşturma

Tek bir komutla Xuda CLI projesi oluşturun, ardından üretilen her dosyanın ne işe yaradığını öğrenin.

Başlamadan önce

CLI yolu, xuda-cli'nin bildirdiği motor alt sınırı olan Node.js 18.17.0 veya daha yenisini gerektirir. Başka bir şey gerekmez: xuda-cli'nin kendisi üç pakete (express, socket.io, chokidar) bağlıdır ve yeni bir proje oluşturan iskele aracının kendi bağımlılığı yoktur. Yerel geliştirme hiçbir zaman plana bağlı bir yöntemi çağırmaz; bu yüzden uygulamayı bu şekilde oluşturmanın maliyeti yoktur.

Yeni bir uygulama iskeleti oluşturun

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

create-xuda-cli'nin ne yazdığına bakın

İskele aracı; @xuda.io/xuda-framework-plugin-tailwind ve @xuda.io/xuda-dbs-plugin-xuda paketlerini bağımlılık, xuda-cli'yi geliştirme bağımlılığı olarak zaten bildiren bir package.json, bir xuda.config.js, App.xu, index.html, bir components/ klasörü ve ilk node_modules/.project_data/globals.json dosyasını yazar. Ayrıca on iki klasöre üretilmiş bir README.md kılavuzu bırakır: on bir türlü kaynak klasörü ve data/ klasörünün kendisi; her biri sonradan kaldırılabilir.

Uygulamayı açın

npm run dev, dinlediği URL'yi yazdırır; varsayılan olarak http://localhost:3000. index.html kabuk olarak sunulur ve App.xu, iskelesi oluşturulan yapılandırma entry: 'index.html' ayarını yaptığı ve başka hiçbir bileşen bu öğeyi sahiplenmediği için #app içine otomatik olarak bağlanır. App.xu her zaman app program kimliğine derlenir.

Düzenleyin ve kaydedin

App.xu dosyasını düzenleyip kaydedin. İzleyici projeyi yeniden derler, çalışma zamanı belgelerini yeniden üretir ve bir socket.io kanalı üzerinden yenileme gönderir; böylece tarayıcı kendini yeniler.

İhtiyacınız kalmayınca klasör kılavuzlarını temizleyin

bash
npm run clean:readmes

Bu yalnızca iskele aracının ürettiği README dosyalarını siler (bir iç işaretle izlenirler). Kendi yazdığınız hiçbir README'ye dokunulmaz ve komut silinen, atlanan ve eksik sayılarını ayrı ayrı bildirir.

Zihinsel model: üç katman

xuda.config.js içinde entry: 'index.html' ayarlıysa önce HTML kabuğu sunulur ve başka bir şey o öğeyi zaten sahiplenmediyse App.xu, #app içine bağlanır. entry belirtilmezse xuda-cli, HTML dosyası yerine varsayılan olarak app program kimliğini kullanır.

Önerilen bölünme: index.html sayfa kabuğu olarak kalsın, App.xu kök ekran olarak kalsın ve özellik ekranlarını components/ altına ekleyin.

Proje düzeni

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/

Her klasöre nelerin ait olduğunu ve bir dosyanın bulunduğu klasörün birim türünü nasıl belirlediğini görmek için .xu dili sayfasına bakın.

xuda.config.js

js
module.exports = {
  entry: 'index.html',
  port: 3000,
  ssr: 'none',
  api_key: '',
  build_id: '',
};
build_id ayarsız kalsın

build_id ayarlamak api_key değerini de zorunlu kılar ve arkasında henüz bir uygulama bulunmayan uzak bir derleme yolunu hedefler; bu yüzden proje uzaktan derlenmek yerine yüklenemez.

Komutlar, SSR modları ve bulut eşitleme ile ilgili diğer her şey CLI başvurusu sayfasındadır.

Üretilen çalışma zamanı belgeleri

xuda-cli, çalışma zamanı belgelerini her zaman node_modules/.project_data/ içine derler: bir globals.json ve her program için bir dosya. Buradaki eski dosyalar her derlemede silinir. Bunu derleme çıktısı olarak değerlendirin: gerçeğin kaynağı sizin yazdığınız .xu ve .json5 dosyalarıdır.

Eski kaynaklarda bir project_data/ klasörü ya da kökte bir .project_data/ klasörü görebilirsiniz. Bunlar yalnızca taşıma için tutulan, salt içe aktarma yollarıdır; asla yazılacak bir yer değildir.