CLI-referensen
Varje xuda-cli-kommando, varje xuda.config.js-fält och vad molnsynkronisering kan göra i dag.
xuda-cli är tre kommandon, plus hjälp. Inget av dem tar en flagga: varje extra argument är ett
hårt fel, och alla inställningar finns i xuda.config.js.
Kommandon
dev kör appen helt utan molnanslutning: den besvarar ett fåtal lokala slutpunkter själv så att
appen har allt den behöver, och i det isolerade läget hanterar den också de fyra läs- och
skrivoperationerna för tabeller lokalt. Allt annat skickas vidare uppströms när en API-nyckel är
konfigurerad, och nekas med ett tydligt meddelande när ingen är det.
xuda.config.js
Rendering på serversidan
Sätt ssr till first_page för att rendera startprogrammet på servern och lämna över till klienten
därifrån, eller full för att rendera appen på servern och hydrera den på klienten. Lämna det på
none för att rendera helt i webbläsaren.
Ställ in läget
Redigera ssr i xuda.config.js.
Starta om dev
npm run dev behöver startas om efter en SSR-ändring.
Bekräfta nyttolasten
CLI renderar startprogrammet till en sträng i en sandlådekontext, injicerar markupen i skalet och ger klienten en renderingsnyttolast att fortsätta från.
API-nycklar
Öppna Utvecklare och sedan fliken API-nycklar i instrumentpanelen, och tryck på Skapa nyckel. Namnge nyckeln, begränsa eventuellt Tillåtna domäner och välj ett åtkomstläge.
En nyckel med rätt åtkomst kan anropa appens datametoder direkt över HTTP i dag: dbs_read,
dbs_create, dbs_update och dbs_delete. Se JavaScript
Framework för förfrågans form.
Molnsynkronisering
sync är tänkt att hämta ett molnprojekts dokument till lokala källfiler och skicka tillbaka lokala
ändringar. Den kör en förkontroll som bekräftar att fyra plattformsmetoder går att anropa innan den
gör något annat:
get_app_system_api_methods, get_app_api_keys, get_project_docs,
update_app_info_doc_to_db_couch.
Två av dem är metoder för instrumentpanelens session som av design aldrig visas i den
katalogförteckning som kontrollen läser, och de andra två är inte registrerade som anropbara
plattformsmetoder alls, så kontrollen går inte igenom mot den nuvarande metodkatalogen. Dessutom
laddar allt i CLI som kräver api_key, inklusive uppströmsproxy och sync självt, plattformsmoduler
från disk som en publicerad npm-installation av CLI inte levererar.
Se dev som det lokala verktygspaketet och använd Studio för att få in projektarbete i molnprojektet.
Inget av detta påverkar lokal utveckling: dev, live-omladdning, SSR och plugin fungerar alla helt
utan molnanslutning.
När sync kör hela sin sekvens gör den så här: verifierar att appen exponerar de CPI-metoder som
krävs, verifierar att den nuvarande API-nyckeln kan använda dem, laddar ned fjärrdokument till
node_modules/.project_data/, skapar saknade lokala källfiler från de dokumenten (befintliga lokala
filer skrivs aldrig över), kompilerar om lokal källa tillbaka till node_modules/.project_data/ och
laddar upp ändrade dokument till molnet.
Felsökning
Paket och gränser
Själva ramverket är gratis: lokal utveckling med någon av skrivvägarna anropar aldrig en metod som kräver betalpaket, CLI-paketen är öppet publicerade på npm och API-nycklar är gratis oavsett åtkomstläge. Det ett kontopaket köper är distribution, som inte är tillgänglig i Gratisplan och tillgänglig från Pro och uppåt.