Referencia CLI
Každý príkaz xuda-cli, každé pole xuda.config.js a čo dnes dokáže cloudová synchronizácia.
xuda-cli tvoria tri príkazy a pomocník. Žiadny z nich neprijíma príznak: každý nadbytočný argument
je tvrdá chyba a všetky nastavenia sú v xuda.config.js.
Príkazy
dev spúšťa aplikáciu úplne bez pripojenia ku cloudu: niekoľko lokálnych koncových bodov obslúži sám,
aby aplikácia mala všetko, čo potrebuje, a v tomto izolovanom režime lokálne zvláda aj štyri operácie
čítania a zápisu tabuliek. Všetko ostatné sa pri nastavenom API kľúči preposiela ďalej a bez neho sa
odmietne s jasnou správou.
xuda.config.js
Vykresľovanie na strane servera
Nastavte ssr na first_page, aby sa vstupný program vykreslil na serveri a odtiaľ ho prevzal
klient, alebo na full, aby sa aplikácia vykreslila na serveri a na klientovi sa hydratovala.
Ponechajte none, ak sa má všetko vykresľovať v prehliadači.
Nastavte režim
Upravte ssr v xuda.config.js.
Reštartujte dev
Po zmene SSR treba npm run dev reštartovať.
Skontrolujte dáta
CLI vykreslí vstupný program do reťazca v izolovanom kontexte, vloží značkovanie do shellu a klientovi odovzdá dáta vykreslenia, z ktorých pokračuje.
API kľúče
V dashboarde otvorte Vývojári, potom kartu API kľúče a stlačte Vytvoriť kľúč. Kľúč pomenujte, voliteľne obmedzte Povolené domény a vyberte režim prístupu.
Kľúč s príslušným prístupom môže dnes volať metódy dát aplikácie priamo cez HTTP: dbs_read,
dbs_create, dbs_update a dbs_delete. Tvar požiadavky nájdete v JavaScript
Framework.
Cloudová synchronizácia
Zámerom sync je stiahnuť dokumenty cloudového projektu do lokálnych zdrojových súborov a lokálne
zmeny odoslať späť. Pred čímkoľvek iným vykoná kontrolu predpokladov, ktorá potvrdí, že štyri metódy
platformy sú volateľné:
get_app_system_api_methods, get_app_api_keys, get_project_docs,
update_app_info_doc_to_db_couch.
Dve z nich sú metódy relácie dashboardu, ktoré sa zámerne nikdy neobjavia v zozname katalógu, ktorý
kontrola číta, a ďalšie dve nie sú zaregistrované ako volateľné metódy platformy vôbec, takže
kontrola s aktuálnym katalógom metód neprejde. Okrem toho všetko, čo v CLI potrebuje api_key, vrátane
preposielania ďalej a samotného sync, načítava z disku moduly platformy, ktoré publikovaná
inštalácia CLI z npm neobsahuje.
Berte dev ako lokálny nástroj a prácu na projekte do cloudového projektu dostanete cez Studio.
Nič z toho neovplyvňuje lokálny vývoj: dev, živé prenačítanie, SSR aj pluginy fungujú úplne bez
pripojenia ku cloudu.
Keď sync prebehne celou postupnosťou, urobí toto: overí, že aplikácia sprístupňuje požadované
metódy CPI, overí, že ich môže použiť aktuálny API kľúč, stiahne vzdialené dokumenty do
node_modules/.project_data/, z týchto dokumentov vytvorí chýbajúce lokálne zdrojové súbory
(existujúce lokálne súbory sa nikdy neprepíšu), znova skompiluje lokálny zdroj späť do
node_modules/.project_data/ a zmenené dokumenty nahrá späť do cloudu.
Riešenie problémov
Plány a limity
Samotný framework je zadarmo: lokálny vývoj pri oboch cestách tvorby nikdy nevolá metódu viazanú na plán, balíky CLI sú verejne publikované na npm a API kľúče sú zadarmo bez ohľadu na režim prístupu. Plán účtu kupuje nasadenie, ktoré nie je dostupné v pláne zadarmo a je dostupné od Pro vyššie.