Εγκατάσταση και δημιουργία έργου
Στήστε ένα έργο Xuda CLI με μία εντολή και μάθετε σε τι χρησιμεύει κάθε αρχείο που δημιουργείται.
Πριν ξεκινήσετε
Ο δρόμος του CLI χρειάζεται Node.js 18.17.0 ή νεότερο, που είναι το ελάχιστο όριο που δηλώνει το xuda-cli.
Τίποτα άλλο: το ίδιο το xuda-cli εξαρτάται από τρία πακέτα (express, socket.io, chokidar),
και ο scaffolder που δημιουργεί ένα νέο έργο δεν έχει δικές του εξαρτήσεις. Η τοπική ανάπτυξη
δεν καλεί ποτέ μέθοδο που απαιτεί πλάνο, οπότε η δημιουργία μιας εφαρμογής με αυτόν τον τρόπο δεν κοστίζει τίποτα.
Στήστε μια νέα εφαρμογή
Δείτε τι έγραψε το create-xuda-cli
Ο scaffolder γράφει ένα package.json που δηλώνει ήδη τα @xuda.io/xuda-framework-plugin-tailwind
και @xuda.io/xuda-dbs-plugin-xuda ως εξαρτήσεις και το xuda-cli ως εξάρτηση ανάπτυξης, ένα
xuda.config.js, App.xu, index.html, έναν φάκελο components/ και ένα πρώτο
node_modules/.project_data/globals.json. Τοποθετεί επίσης έναν οδηγό README.md σε δώδεκα
φακέλους: τους έντεκα τυποποιημένους φακέλους πηγαίου κώδικα συν έναν για τον ίδιο τον data/, καθένας από τους οποίους μπορεί να αφαιρεθεί αργότερα.
Ανοίξτε την εφαρμογή
Το npm run dev εκτυπώνει το URL στο οποίο ακούει, http://localhost:3000 από προεπιλογή. Το index.html σερβίρεται
ως το κέλυφος και το App.xu προσαρτάται αυτόματα στο #app, επειδή η ρύθμιση που δημιουργήθηκε
ορίζει entry: 'index.html' και κανένα άλλο στοιχείο δεν διεκδικεί αυτό το στοιχείο. Το App.xu μεταγλωττίζεται πάντα στο
αναγνωριστικό προγράμματος app.
Επεξεργαστείτε και αποθηκεύστε
Επεξεργαστείτε το App.xu και αποθηκεύστε. Ο watcher μεταγλωττίζει ξανά το έργο, αναδημιουργεί τα έγγραφα εκτέλεσης και
στέλνει ένα reload μέσω καναλιού socket.io, ώστε ο browser να ανανεώνεται μόνος του.
Καθαρίστε τους οδηγούς φακέλων όταν δεν τους χρειάζεστε πια
Αυτό διαγράφει μόνο τα αρχεία README που δημιούργησε ο scaffolder (παρακολουθούνται με έναν εσωτερικό δείκτη). Κάθε README που γράψατε εσείς μένει ανέγγιχτο, και η εντολή αναφέρει χωριστά τους αριθμούς αφαιρεθέντων, παραλειφθέντων και ελλειπόντων.
Το νοητικό μοντέλο: τρία επίπεδα
Αν το xuda.config.js ορίζει entry: 'index.html', το κέλυφος HTML σερβίρεται πρώτο και το App.xu προσαρτάται
στο #app, εκτός αν κάτι άλλο έχει ήδη διεκδικήσει αυτό το στοιχείο. Αν το entry παραλείπεται, το xuda-cli
χρησιμοποιεί ως προεπιλογή το αναγνωριστικό προγράμματος app αντί για αρχείο HTML.
Προτεινόμενος διαχωρισμός: κρατήστε το index.html ως κέλυφος σελίδας, το App.xu ως βασική οθόνη και προσθέστε
οθόνες λειτουργιών κάτω από το components/.
Η διάταξη του έργου
Δείτε το Η γλώσσα .xu για το τι ανήκει σε κάθε φάκελο και πώς ο φάκελος όπου βρίσκεται ένα αρχείο καθορίζει τον τύπο της μονάδας του.
xuda.config.js
Η ρύθμιση του build_id κάνει επίσης υποχρεωτικό το api_key, και στοχεύει μια απομακρυσμένη διαδρομή build που δεν έχει ακόμη
υλοποίηση, οπότε το έργο θα αποτύχει να φορτωθεί αντί να κάνει build απομακρυσμένα.
Όλα τα υπόλοιπα για τις εντολές, τις λειτουργίες SSR και τον συγχρονισμό με το cloud βρίσκονται στο Αναφορά CLI.
Παραγόμενα έγγραφα εκτέλεσης
Το xuda-cli μεταγλωττίζει πάντα τα έγγραφα εκτέλεσης στο node_modules/.project_data/, ένα globals.json συν
ένα αρχείο ανά πρόγραμμα. Τα παλιά αρχεία εκεί διαγράφονται σε κάθε μεταγλώττιση. Αντιμετωπίστε το ως αποτέλεσμα build: τα
αρχεία .xu και .json5 που γράφετε είναι η πηγή αλήθειας.
Μπορεί να δείτε έναν φάκελο project_data/ ή έναν φάκελο .project_data/ στη ρίζα σε παλαιότερο υλικό. Είναι
παλιές διαδρομές μόνο για εισαγωγή, που διατηρούνται για μετάβαση, ποτέ μέρος για να γράψετε.