Přeskočit na obsah
Ověřeno

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

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

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á.

Co se dnes skutečně dostane do cloudu

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.