Siirry sisältöön
Tarkistettu

CLI-viite

Jokainen xuda-cli-komento, jokainen xuda.config.js-kenttä ja se, mitä pilvisynkronointi voi tehdä nykyisin.

xuda-cli on kolme komentoa ja ohje. Mikään niistä ei ota lippuja: ylimääräinen argumentti on kova virhe, ja kaikki asetukset ovat tiedostossa xuda.config.js.

Komennot

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

dev ajaa sovelluksen ilman pilviyhteyttä: se vastaa itse muutamaan paikalliseen päätepisteeseen, jotta sovellus saa kaiken tarvitsemansa, ja tässä eristetyssä tilassa se käsittelee paikallisesti myös neljä taulun luku- ja kirjoitustoimintoa. Kaikki muu välitetään eteenpäin, kun API-avain on määritetty, ja hylätään selkeällä viestillä, kun sitä ei ole.

xuda.config.js

Palvelinpuolen renderöinti

Aseta ssr arvoon first_page, jos haluat renderöidä sisäänkäyntiohjelman palvelimella ja siirtää sen jälkeen ohjat asiakkaalle, tai full, jos haluat renderöidä sovelluksen palvelimella ja hydratoida sen asiakaspuolella. Jätä arvoon none, jos renderöinti tapahtuu kokonaan selaimessa.

Aseta tila

Muokkaa ssr-arvoa tiedostossa xuda.config.js.

Käynnistä dev uudelleen

npm run dev täytyy käynnistää uudelleen SSR-muutoksen jälkeen.

Varmista payload

CLI renderöi sisäänkäyntiohjelman merkkijonoksi eristetyssä kontekstissa, lisää merkinnän kuoreen ja antaa asiakkaalle renderöintipayloadin, josta jatkaa.

API-avaimet

Avaa hallintapaneelissa Kehittäjät ja sen API-avaimet-välilehti ja paina Luo avain. Nimeä avain, rajoita tarvittaessa Sallitut verkkotunnukset ja valitse käyttötila.

Avain, jolla on oikea käyttöoikeus, voi kutsua sovellusdatan metodeja suoraan HTTP:n kautta jo nyt: dbs_read, dbs_create, dbs_update ja dbs_delete. Katso pyynnön muoto kohdasta JavaScript-kehys.

Pilvisynkronointi

sync:n tarkoitus on hakea pilviprojektin dokumentit paikallisiksi lähdetiedostoiksi ja työntää paikalliset muutokset takaisin. Se ajaa ensin ehtotarkistuksen, joka varmistaa, että neljä alustan metodia on kutsuttavissa:

get_app_system_api_methods, get_app_api_keys, get_project_docs, update_app_info_doc_to_db_couch.

Kaksi näistä on hallintapaneelin istuntometodeja, jotka eivät suunnitellusti koskaan näy tarkistuksen lukemassa katalogiluettelossa, ja kaksi muuta ei ole rekisteröity kutsuttaviksi alustan metodeiksi lainkaan, joten tarkistus ei mene läpi nykyisellä metodikatalogilla. Lisäksi kaikki, mikä CLI:ssä tarvitsee api_key:n, myös ylävirtaan välitys ja sync itse, lataa levyltä alustamoduuleja, joita CLI:n julkaistu npm-asennus ei sisällä.

Mikä oikeasti yltää pilveen nykyisin

Käsittele dev:iä paikallisena työkaluketjuna ja käytä Studiota viedäksesi projektityön pilviprojektiin. Mikään tästä ei vaikuta paikalliseen kehitykseen: dev, live reload, SSR ja liitännäiset toimivat ilman pilviyhteyttä.

Kun sync ajaa koko sarjansa, se: varmistaa, että sovellus tarjoaa vaaditut CPI-metodit, varmistaa, että nykyinen API-avain voi käyttää niitä, lataa etädokumentit kansioon node_modules/.project_data/, luo puuttuvat paikalliset lähdetiedostot näistä dokumenteista (olemassa olevia paikallisia tiedostoja ei koskaan ylikirjoiteta), kääntää paikallisen lähteen uudelleen kansioon node_modules/.project_data/ ja lataa muuttuneet dokumentit takaisin pilveen.

Vianmääritys

Paketit ja rajat

Kehys itsessään on ilmainen: paikallinen kehitys kummalla tahansa kirjoitustavalla ei koskaan kutsu pakettirajoitettua metodia, CLI-paketit on julkaistu avoimesti npm:ssä ja API-avaimet ovat ilmaisia käyttötilasta riippumatta. Tilin paketti ostaa julkaisun, joka ei ole käytettävissä Ilmaisessa paketissa vaan Pro-paketista ylöspäin.