CLI-referencen
Hver xuda-cli-kommando, hvert xuda.config.js-felt og hvad cloud-synkronisering kan i dag.
xuda-cli er tre kommandoer plus hjælp. Ingen af dem tager et flag: ethvert ekstra argument er en
hård fejl, og alle indstillinger ligger i xuda.config.js.
Kommandoer
dev kører appen helt uden forbindelse til skyen: den besvarer selv en håndfuld lokale endpoints,
så appen har det, den skal bruge, og i den isolerede tilstand håndterer den også de fire
tabeloperationer til læsning og skrivning lokalt. Alt andet sendes videre opstrøms, når der er
konfigureret en API-nøgle, og afvises med en tydelig besked, når der ikke er.
xuda.config.js
Server-side rendering
Sæt ssr til first_page for at rendere startprogrammet på serveren og overlade resten til
klienten derfra, eller full for at rendere appen på serveren og hydrere den på klienten. Lad den
stå på none for at rendere helt i browseren.
Sæt tilstanden
Rediger ssr i xuda.config.js.
Genstart dev
npm run dev skal genstartes efter en SSR-ændring.
Bekræft nyttelasten
CLI'en renderer startprogrammet til en streng i en isoleret kontekst, indsætter markup'en i skallen og giver klienten en render-nyttelast at fortsætte fra.
API-nøgler
Åbn Udviklere, så fanen API-nøgler i dashboardet, og tryk på Opret nøgle. Navngiv nøglen, begræns evt. Tilladte domæner, og vælg en adgangstilstand.
En nøgle med den rette adgang kan i dag kalde appens datametoder direkte over HTTP: dbs_read,
dbs_create, dbs_update og dbs_delete. Se JavaScript
Framework for forespørgslens form.
Cloud-synkronisering
sync har til hensigt at hente et cloud-projekts dokumenter ned i lokale kildefiler og skubbe
lokale ændringer tilbage. Den kører et forhåndstjek, der bekræfter, at fire platformmetoder kan
kaldes, før den gør andet:
get_app_system_api_methods, get_app_api_keys, get_project_docs,
update_app_info_doc_to_db_couch.
To af dem er dashboard-sessionsmetoder, som pr. design aldrig optræder i den kataloglisting, tjekket
læser, og de to andre er slet ikke registreret som metoder, der kan kaldes på platformen, så tjekket
består ikke mod det nuværende metodekatalog. Derudover indlæser alt, der kræver api_key i CLI'en,
herunder videresendelse opstrøms og sync selv, platformmoduler fra disken, som en udgivet
npm-installation af CLI'en ikke leverer.
Behandl dev som det lokale værktøj, og brug Studio til at få projektarbejde ind i cloud-projektet.
Intet af dette påvirker lokal udvikling: dev, live reload, SSR og plugins virker alle uden
forbindelse til skyen.
Når sync kører hele sin sekvens, gør den følgende: den bekræfter, at appen udstiller de påkrævede
CPI-metoder, bekræfter, at den nuværende API-nøgle kan bruge dem, downloader eksterne dokumenter til
node_modules/.project_data/, opretter manglende lokale kildefiler ud fra de dokumenter (eksisterende
lokale filer overskrives aldrig), kompilerer lokal kilde igen til node_modules/.project_data/ og
uploader ændrede dokumenter tilbage til skyen.
Fejlfinding
Planer og grænser
Selve frameworket er gratis: lokal udvikling med begge skrivemåder kalder aldrig en metode, der er bundet til en plan, CLI-pakkerne er udgivet åbent på npm, og API-nøgler er gratis uanset adgangstilstand. Det, en kontoplan giver, er udrulning, som ikke er tilgængelig på den Gratis plan og er tilgængelig fra Pro og opefter.