Hopp til innholdet
Bekreftet

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

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

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.

Hva som faktisk når skyen i dag

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.