Referința CLI
Fiecare comandă xuda-cli, fiecare câmp din xuda.config.js și ce poate face astăzi sincronizarea cu cloud-ul.
xuda-cli înseamnă trei comenzi, plus ajutorul. Niciuna nu primește vreun flag: orice argument în plus este o
eroare fatală, iar fiecare setare se află în xuda.config.js.
Comenzi
dev rulează aplicația fără nicio conexiune la cloud: răspunde singur la câteva endpoint-uri locale,
astfel încât aplicația să aibă tot ce îi trebuie, iar în acest mod izolat gestionează local și cele patru operații de citire
și scriere pe tabele. Orice altceva este redirecționat în amonte când este configurată o cheie API și
refuzat cu un mesaj clar când nu este.
xuda.config.js
Randare pe server
Setează ssr la first_page ca să randezi pe server programul de intrare și să predai apoi controlul clientului,
sau la full ca să randezi pe server aplicația și s-o hidratezi pe client. Lasă-l la none ca să randezi totul
în browser.
Setează modul
Editează ssr în xuda.config.js.
Repornește dev
npm run dev trebuie repornit după o schimbare de SSR.
Confirmă payload-ul
CLI randează programul de intrare într-un șir de text într-un context izolat, injectează markup-ul în shell și îi dă clientului un payload de randare de la care să continue.
Chei API
Deschide Dezvoltatori, apoi fila Chei API din tabloul de bord și apasă Creează cheie. Dă un nume cheii, restricționează opțional Domenii permise și alege un mod de acces.
O cheie cu accesul potrivit poate apela astăzi direct, prin HTTP, metodele de date ale aplicației: dbs_read,
dbs_create, dbs_update și dbs_delete. Vezi JavaScript
Framework pentru forma cererii.
Sincronizarea cu cloud-ul
Scopul lui sync este să aducă documentele unui proiect din cloud în fișiere sursă locale și să trimită înapoi
modificările locale. Rulează o verificare prealabilă care confirmă că patru metode ale platformei pot fi apelate înainte de
a face orice altceva:
get_app_system_api_methods, get_app_api_keys, get_project_docs,
update_app_info_doc_to_db_couch.
Două dintre ele sunt metode de sesiune a tabloului de bord, care prin design nu apar niciodată în lista catalogului pe care o
citește verificarea, iar celelalte două nu sunt înregistrate deloc ca metode apelabile ale platformei, așa că verificarea
nu trece față de catalogul curent de metode. Separat, tot ce are nevoie de api_key în
CLI, inclusiv redirecționarea în amonte și sync în sine, încarcă de pe disc module ale platformei pe care o
instalare npm publicată a CLI nu le include.
Tratează dev ca setul de unelte local și folosește Studio ca să duci munca de proiect în proiectul din cloud. Nimic
din toate acestea nu afectează dezvoltarea locală: dev, reîncărcarea live, SSR și plugin-urile funcționează toate fără nicio
conexiune la cloud.
Când sync își rulează secvența completă, el: verifică dacă aplicația expune metodele CPI necesare,
verifică dacă cheia API curentă le poate folosi, descarcă documentele de la distanță în
node_modules/.project_data/, creează fișierele sursă locale lipsă din acele documente (fișierele locale existente
nu sunt niciodată suprascrise), recompilează sursa locală înapoi în node_modules/.project_data/ și
încarcă în cloud documentele modificate.
Depanare
Planuri și limite
Framework-ul în sine este gratuit: dezvoltarea locală pe oricare dintre căile de creare nu apelează niciodată o metodă limitată de plan, pachetele CLI sunt publicate liber pe npm, iar cheile API sunt gratuite indiferent de modul de acces. Ce aduce un plan de cont este implementarea, care nu este disponibilă în planul gratuit și este disponibilă de la Pro în sus.