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