Die CLI-Referenz
Jeder xuda-cli-Befehl, jedes Feld von xuda.config.js und was die Cloud-Synchronisierung heute kann.
xuda-cli besteht aus drei Befehlen plus Hilfe. Keiner davon nimmt ein Flag: Jedes zusätzliche Argument ist ein harter Fehler, und jede Einstellung steht in xuda.config.js.
Befehle
dev führt die App ganz ohne Cloud-Verbindung aus: Es beantwortet eine Handvoll lokaler Endpunkte selbst, damit die App alles hat, was sie braucht, und in diesem isolierten Modus behandelt es auch die vier Lese- und Schreiboperationen für Tabellen lokal. Alles andere wird upstream weitergeleitet, wenn ein API-Schlüssel konfiguriert ist, und mit einer klaren Meldung abgelehnt, wenn keiner konfiguriert ist.
xuda.config.js
Serverseitiges Rendern
Setze ssr auf first_page, um das Einstiegsprogramm serverseitig zu rendern und von dort an den Client zu übergeben, oder auf full, um die App serverseitig zu rendern und clientseitig zu hydrieren. Lass es bei none, um vollständig im Browser zu rendern.
Den Modus setzen
Bearbeite ssr in xuda.config.js.
Dev neu starten
npm run dev braucht nach einer SSR-Änderung einen Neustart.
Die Nutzlast bestätigen
Die CLI rendert das Einstiegsprogramm in einem Sandbox-Kontext zu einem String, fügt das Markup in die Shell ein und übergibt dem Client eine Render-Nutzlast, ab der er weitermacht.
API-Schlüssel
Öffne im Dashboard Entwickler, dann den Tab API-Schlüssel, und drücke Schlüssel erstellen. Benenne den Schlüssel, schränke optional Erlaubte Domains ein und wähle einen Zugriffsmodus.
Ein Schlüssel mit dem richtigen Zugriff kann die App-Datenmethoden heute direkt über HTTP aufrufen: dbs_read, dbs_create, dbs_update und dbs_delete. Die Form der Anfrage siehst du unter JavaScript Framework.
Cloud-Synchronisierung
Die Absicht von sync ist, die Dokumente eines Cloud-Projekts in lokale Quelldateien zu holen und lokale Änderungen zurückzuschieben. Es führt eine Vorabprüfung aus, die bestätigt, dass vier Plattformmethoden aufrufbar sind, bevor es irgendetwas anderes tut:
get_app_system_api_methods, get_app_api_keys, get_project_docs, update_app_info_doc_to_db_couch.
Zwei davon sind Methoden der Dashboard-Sitzung, die absichtlich nie in der Katalogliste erscheinen, die die Prüfung liest, und die anderen beiden sind überhaupt nicht als aufrufbare Plattformmethoden registriert, die Prüfung besteht gegen den aktuellen Methodenkatalog also nicht. Davon unabhängig lädt alles, was in der CLI api_key braucht, einschließlich des Upstream-Proxyings und sync selbst, Plattformmodule von der Festplatte, die eine veröffentlichte npm-Installation der CLI nicht mitliefert.
Behandle dev als lokale Toolchain und nutze Studio, um Projektarbeit in das Cloud-Projekt zu bringen. Nichts davon betrifft die lokale Entwicklung: dev, Live-Reload, SSR und Plugins funktionieren alle ganz ohne Cloud-Verbindung.
Wenn sync seine volle Sequenz ausführt, tut es Folgendes: Es prüft, ob die App die erforderlichen CPI-Methoden bereitstellt, prüft, ob der aktuelle API-Schlüssel sie nutzen kann, lädt entfernte Dokumente nach node_modules/.project_data/ herunter, erstellt aus diesen Dokumenten fehlende lokale Quelldateien (bestehende lokale Dateien werden nie überschrieben), kompiliert die lokale Quelle zurück nach node_modules/.project_data/ und lädt geänderte Dokumente zurück in die Cloud hoch.
Fehlerbehebung
Tarife und Limits
Das Framework selbst ist kostenlos: Lokale Entwicklung mit beiden Authoring-Wegen ruft nie eine tarifgebundene Methode auf, die CLI-Pakete sind offen auf npm veröffentlicht, und API-Schlüssel sind unabhängig vom Zugriffsmodus kostenlos. Was ein Kontotarif kauft, ist das Deployment, das im Tarif Free nicht verfügbar und ab Pro aufwärts verfügbar ist.