CLI-referansen
Hver xuda-cli-kommando, hvert xuda.config.js-felt, og hva skysynkronisering kan gjøre i dag.
xuda-cli er tre kommandoer, pluss hjelp. Ingen av dem tar et flagg: ethvert ekstra argument gir en
hard feil, og alle innstillinger ligger i xuda.config.js.
Kommandoer
dev kjører appen helt uten skytilkobling: den svarer selv på en håndfull lokale endepunkter, så
appen har alt den trenger, og i den isolerte modusen håndterer den også de fire lese- og
skriveoperasjonene for tabeller lokalt. Alt annet sendes videre oppstrøms når en API-nøkkel er
konfigurert, og avvises med en tydelig melding når ingen er det.
xuda.config.js
Serversidegjengivelse
Sett ssr til first_page for å gjengi inngangsprogrammet på serveren og overlate til klienten
derfra, eller full for å gjengi appen på serveren og hydrere den på klientsiden. La den stå på
none for å gjengi alt i nettleseren.
Sett modusen
Rediger ssr i xuda.config.js.
Start dev på nytt
npm run dev må startes på nytt etter en SSR-endring.
Bekreft nyttelasten
CLI-et gjengir inngangsprogrammet til en streng i en isolert kontekst, setter markupen inn i skallet og gir klienten en gjengivelsesnyttelast å fortsette fra.
API-nøkler
Åpne Utviklere, så fanen API-nøkler i dashbordet, og trykk Opprett nøkkel. Gi nøkkelen et navn, begrens eventuelt Tillatte domener, og velg en tilgangsmodus.
En nøkkel med riktig tilgang kan kalle appdata-metodene direkte over HTTP i dag: dbs_read,
dbs_create, dbs_update og dbs_delete. Se JavaScript-rammeverket
for hvordan forespørselen ser ut.
Skysynkronisering
Meningen med sync er å hente dokumentene til et skyprosjekt ned i lokale kildefiler og sende lokale
endringer tilbake. Den kjører først en forhåndssjekk som bekrefter at fire plattformmetoder kan kalles,
før den gjør noe annet:
get_app_system_api_methods, get_app_api_keys, get_project_docs,
update_app_info_doc_to_db_couch.
To av dem er metoder for dashbordøkter som med vilje aldri vises i katalogoversikten sjekken leser,
og de to andre er ikke registrert som kallbare plattformmetoder i det hele tatt, så sjekken består
ikke mot den nåværende metodekatalogen. Dessuten laster alt i CLI-et som trenger api_key,
inkludert oppstrøms videresending og selve sync, plattformmoduler fra disk som en publisert
npm-installasjon av CLI-et ikke leverer.
Bruk dev som det lokale verktøyet, og bruk Studio for å få prosjektarbeid inn i skyprosjektet.
Ingenting av dette påvirker lokal utvikling: dev, live reload, SSR og plugin-moduler fungerer alle
helt uten skytilkobling.
Når sync kjører hele sekvensen, gjør den dette: sjekker at appen eksponerer de nødvendige
CPI-metodene, sjekker at den gjeldende API-nøkkelen kan bruke dem, laster ned eksterne dokumenter til
node_modules/.project_data/, oppretter manglende lokale kildefiler fra disse dokumentene (eksisterende
lokale filer overskrives aldri), kompilerer lokal kilde på nytt til node_modules/.project_data/, og
laster endrede dokumenter opp til skyen.
Feilsøking
Abonnement og grenser
Selve rammeverket er gratis: lokal utvikling med begge skrivemåtene kaller aldri en metode som er låst bak et abonnement, CLI-pakkene er publisert åpent på npm, og API-nøkler er gratis uansett tilgangsmodus. Det et kontoabonnement kjøper er distribusjon, som ikke er tilgjengelig på Gratisplan og er tilgjengelig fra Pro og oppover.