Gå til indhold
Bekræftet

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

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

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.

Hvad der faktisk når skyen i dag

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.