Αναφορά CLI
Κάθε εντολή του xuda-cli, κάθε πεδίο του xuda.config.js, και τι μπορεί να κάνει σήμερα ο συγχρονισμός με το cloud.
Το xuda-cli είναι τρεις εντολές, συν τη βοήθεια. Καμία δεν δέχεται flag: κάθε επιπλέον όρισμα είναι σοβαρό
σφάλμα, και κάθε ρύθμιση βρίσκεται στο xuda.config.js.
Εντολές
Το dev τρέχει την εφαρμογή χωρίς καμία σύνδεση με το cloud: απαντά μόνο του σε μερικά τοπικά endpoints ώστε
η εφαρμογή να έχει ό,τι χρειάζεται, και σε αυτή την απομονωμένη λειτουργία χειρίζεται επίσης τοπικά τις τέσσερις λειτουργίες ανάγνωσης
και εγγραφής πινάκων. Οτιδήποτε άλλο προωθείται προς τα πάνω (proxy) όταν έχει ρυθμιστεί κλειδί API, και
απορρίπτεται με σαφές μήνυμα όταν δεν έχει.
xuda.config.js
Απόδοση από την πλευρά του διακομιστή
Ορίστε το ssr σε first_page για να αποδοθεί στον διακομιστή το πρόγραμμα εισόδου και να παραδοθεί από εκεί στον client,
ή full για να αποδοθεί η εφαρμογή στον διακομιστή και να υδατωθεί (hydrate) στον client. Αφήστε το στο none για απόδοση εξ ολοκλήρου
στον browser.
Ορίστε τη λειτουργία
Επεξεργαστείτε το ssr στο xuda.config.js.
Κάντε επανεκκίνηση του dev
Το npm run dev χρειάζεται επανεκκίνηση μετά από αλλαγή του SSR.
Επιβεβαιώστε το payload
Το CLI αποδίδει το πρόγραμμα εισόδου σε συμβολοσειρά μέσα σε sandbox, εισάγει το markup στο κέλυφος και δίνει στον client ένα payload απόδοσης από το οποίο συνεχίζει.
Κλειδιά API
Ανοίξτε Προγραμματιστές, μετά την καρτέλα API Keys στο dashboard, και πατήστε Δημιουργία κλειδιού. Ονομάστε το κλειδί, προαιρετικά περιορίστε τους Επιτρεπόμενοι τομείς, και επιλέξτε λειτουργία πρόσβασης.
Ένα κλειδί με τη σωστή πρόσβαση μπορεί να καλεί σήμερα τις μεθόδους δεδομένων της εφαρμογής απευθείας μέσω HTTP: dbs_read,
dbs_create, dbs_update και dbs_delete. Δείτε το JavaScript
Framework για τη μορφή του αιτήματος.
Συγχρονισμός με το cloud
Ο σκοπός του sync είναι να κατεβάζει τα έγγραφα ενός cloud έργου σε τοπικά αρχεία πηγαίου κώδικα και να ανεβάζει τις τοπικές
αλλαγές πίσω. Εκτελεί έναν έλεγχο προϋποθέσεων που επιβεβαιώνει ότι τέσσερις μέθοδοι της πλατφόρμας είναι καλέσιμες πριν
κάνει οτιδήποτε άλλο:
get_app_system_api_methods, get_app_api_keys, get_project_docs,
update_app_info_doc_to_db_couch.
Δύο από αυτές είναι μέθοδοι συνεδρίας dashboard που εκ σχεδιασμού δεν εμφανίζονται ποτέ στον κατάλογο που διαβάζει
ο έλεγχος, και οι άλλες δύο δεν είναι καθόλου καταχωρισμένες ως καλέσιμες μέθοδοι της πλατφόρμας, οπότε ο έλεγχος
δεν περνά με τον τρέχοντα κατάλογο μεθόδων. Επιπλέον, οτιδήποτε χρειάζεται api_key στο
CLI, συμπεριλαμβανομένης της προώθησης προς τα πάνω και του ίδιου του sync, φορτώνει από τον δίσκο modules της πλατφόρμας που μια
δημοσιευμένη εγκατάσταση npm του CLI δεν περιλαμβάνει.
Αντιμετωπίστε το dev ως την τοπική εργαλειοθήκη και χρησιμοποιήστε το Studio για να περάσετε δουλειά έργου στο cloud έργο. Τίποτα
από αυτά δεν επηρεάζει την τοπική ανάπτυξη: το dev, το live reload, το SSR και τα πρόσθετα δουλεύουν όλα χωρίς καμία σύνδεση
με το cloud.
Όταν το sync εκτελεί την πλήρη ακολουθία του, κάνει τα εξής: επαληθεύει ότι η εφαρμογή εκθέτει τις απαιτούμενες μεθόδους CPI,
επαληθεύει ότι το τρέχον κλειδί API μπορεί να τις χρησιμοποιήσει, κατεβάζει τα απομακρυσμένα έγγραφα στο
node_modules/.project_data/, δημιουργεί τα ελλείποντα τοπικά αρχεία πηγαίου κώδικα από αυτά τα έγγραφα (τα υπάρχοντα τοπικά
αρχεία δεν αντικαθίστανται ποτέ), μεταγλωττίζει ξανά τον τοπικό πηγαίο κώδικα στο node_modules/.project_data/, και
ανεβάζει τα αλλαγμένα έγγραφα πίσω στο cloud.
Αντιμετώπιση προβλημάτων
Πλάνα και όρια
Το ίδιο το framework είναι δωρεάν: η τοπική ανάπτυξη με οποιονδήποτε από τους δύο δρόμους συγγραφής δεν καλεί ποτέ μέθοδο που απαιτεί πλάνο, τα πακέτα του CLI δημοσιεύονται ελεύθερα στο npm, και τα κλειδιά API είναι δωρεάν ανεξάρτητα από τη λειτουργία πρόσβασης. Αυτό που προσφέρει ένα πλάνο λογαριασμού είναι η ανάπτυξη, η οποία δεν είναι διαθέσιμη στο Δωρεάν πλάνο και είναι διαθέσιμη από το Pro και πάνω.