Sari la conținut
Verificat

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

bash
xuda-cli dev
xuda-cli sync
xuda-cli clean-readmes
xuda-cli --help

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.

Ce ajunge de fapt în cloud astăzi

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.