Reference CLI
Každý příkaz xuda-cli, každé pole xuda.config.js a co dnes cloudová synchronizace umí.
xuda-cli jsou tři příkazy plus nápověda. Žádný z nich nepřijímá přepínač: jakýkoli nadbytečný
argument je tvrdá chyba a každé nastavení žije v xuda.config.js.
Příkazy
dev spouští aplikaci zcela bez cloudového připojení: několik lokálních koncových bodů obslouží
sám, aby aplikace měla vše, co potřebuje, a v tomto izolovaném režimu také lokálně obsluhuje
čtyři operace čtení a zápisu tabulek. Cokoli jiného se předává dál, pokud je nastaven klíč API,
a pokud není, odmítne se s jasnou zprávou.
xuda.config.js
Vykreslování na straně serveru
Nastavte ssr na first_page, aby se vstupní program vykreslil na serveru a klient pak navázal,
nebo na full, aby se aplikace vykreslila na serveru a na klientu hydratovala. Nechte none, aby
se vše vykreslovalo v prohlížeči.
Nastavte režim
Upravte ssr v xuda.config.js.
Restartujte dev
Po změně SSR je třeba npm run dev restartovat.
Ověřte obsah
CLI vykreslí vstupní program do řetězce v izolovaném kontextu, vloží markup do obalu a klientovi předá obsah vykreslení, od kterého bude pokračovat.
Klíče API
V přehledu otevřete Vývojáři, pak záložku Klíče API a stiskněte Vytvořit klíč. Klíč pojmenujte, volitelně omezte Povolené domény a vyberte režim přístupu.
Klíč s odpovídajícím přístupem může dnes volat metody dat aplikace přímo přes HTTP: dbs_read,
dbs_create, dbs_update a dbs_delete. Tvar požadavku viz
Framework JavaScript.
Cloudová synchronizace
Záměrem sync je stáhnout dokumenty cloudového projektu do lokálních zdrojových souborů a lokální
změny odeslat zpět. Spustí kontrolu předpokladů, která před čímkoli dalším potvrdí, že lze volat
čtyři metody platformy:
get_app_system_api_methods, get_app_api_keys, get_project_docs,
update_app_info_doc_to_db_couch.
Dvě z nich jsou metody relace přehledu, které se záměrně nikdy neobjevují ve výpisu katalogu, který
kontrola čte, a další dvě nejsou vůbec zaregistrovány jako volatelné metody platformy, takže
kontrola proti aktuálnímu katalogu metod neprojde. Navíc cokoli, co v CLI potřebuje api_key,
včetně předávání dál a samotného sync, načítá z disku moduly platformy, které publikovaná
instalace CLI z npm nedodává.
Berte dev jako lokální sadu nástrojů a práci na projektu dostávejte do cloudového projektu
přes Studio. Nic z toho neovlivňuje lokální vývoj: dev, živé znovunačítání, SSR i pluginy
fungují zcela bez cloudového připojení.
Když sync proběhne celou svou posloupností, provede: ověří, že aplikace zpřístupňuje požadované
metody CPI, ověří, že je aktuální klíč API může používat, stáhne vzdálené dokumenty do
node_modules/.project_data/, z těchto dokumentů vytvoří chybějící lokální zdrojové soubory
(existující lokální soubory se nikdy nepřepisují), znovu zkompiluje lokální zdroj zpět do
node_modules/.project_data/ a nahraje změněné dokumenty zpět do cloudu.
Řešení potíží
Tarify a limity
Samotný framework je zdarma: lokální vývoj na kterékoli cestě psaní nikdy nevolá metodu omezenou tarifem, balíčky CLI jsou veřejně publikovány na npm a klíče API jsou zdarma bez ohledu na režim přístupu. Tarif účtu se kupuje kvůli nasazení, které v plánu zdarma není k dispozici a je dostupné od tarifu Pro výše.