Hoppa till innehållet
Verifierad

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

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

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.

Vad som faktiskt når molnet i dag

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.