Preskočiť na obsah
Overené

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

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

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.

Čo sa dnes skutočne dostane do cloudu

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.