Referencia de la CLI
Cada comando de xuda-cli, cada campo de xuda.config.js y lo que puede hacer hoy la sincronización con la nube.
xuda-cli son tres comandos, más la ayuda. Ninguno acepta una opción: cualquier argumento adicional es un error grave, y todos los ajustes viven en xuda.config.js.
Comandos
dev ejecuta la app sin ninguna conexión a la nube: responde él mismo a un puñado de endpoints locales para que la app tenga todo lo que necesita, y en ese modo aislado también gestiona localmente las cuatro operaciones de lectura y escritura de tablas. Cualquier otra cosa se reenvía a origen cuando hay una clave de API configurada, y se rechaza con un mensaje claro cuando no la hay.
xuda.config.js
Renderizado en el servidor
Define ssr como first_page para renderizar en el servidor el programa de entrada y pasar desde ahí al cliente, o como full para renderizar la app en el servidor e hidratarla en el cliente. Déjalo en none para renderizar todo en el navegador.
Define el modo
Edita ssr en xuda.config.js.
Reinicia dev
npm run dev necesita reiniciarse tras un cambio de SSR.
Confirma la carga
La CLI renderiza el programa de entrada a una cadena en un contexto aislado, inyecta el marcado en el shell y entrega al cliente una carga de renderizado desde la que continuar.
Claves de API
Abre Desarrolladores, después la pestaña Claves de API del panel, y pulsa Crear clave. Pon nombre a la clave, restringe opcionalmente los Dominios permitidos y elige un modo de acceso.
Una clave con el acceso adecuado puede llamar hoy directamente por HTTP a los métodos de datos de la app: dbs_read, dbs_create, dbs_update y dbs_delete. Consulta JavaScript Framework para ver la forma de la solicitud.
Sincronización con la nube
La intención de sync es descargar los documentos de un proyecto en la nube a archivos fuente locales y volver a subir los cambios locales. Ejecuta una comprobación previa que confirma que cuatro métodos de la plataforma se pueden llamar antes de hacer nada más:
get_app_system_api_methods, get_app_api_keys, get_project_docs, update_app_info_doc_to_db_couch.
Dos de ellos son métodos de sesión del panel que, por diseño, nunca aparecen en el listado del catálogo que lee la comprobación, y los otros dos no están registrados en absoluto como métodos de plataforma que se puedan llamar, así que la comprobación no se supera con el catálogo de métodos actual. Además, todo lo que necesita api_key en la CLI, incluido el reenvío a origen y el propio sync, carga desde el disco módulos de la plataforma que una instalación publicada de la CLI desde npm no incluye.
Trata dev como la herramienta local y usa Studio para llevar el trabajo del proyecto al proyecto en la nube. Nada de esto afecta al desarrollo local: dev, la recarga en vivo, el SSR y los plugins funcionan sin ninguna conexión a la nube.
Cuando sync ejecuta su secuencia completa, hace lo siguiente: verifica que la app expone los métodos CPI necesarios, verifica que la clave de API actual puede usarlos, descarga los documentos remotos en node_modules/.project_data/, crea los archivos fuente locales que faltan a partir de esos documentos (los archivos locales existentes nunca se sobrescriben), recompila el código fuente local de vuelta en node_modules/.project_data/ y sube a la nube los documentos modificados.
Solución de problemas
Planes y límites
El framework en sí es gratuito: el desarrollo local con cualquiera de los dos caminos de creación nunca llama a un método sujeto a plan, los paquetes de la CLI se publican abiertamente en npm y las claves de API son gratuitas sea cual sea el modo de acceso. Lo que compra un plan de cuenta es el despliegue, que no está disponible en el plan Free y sí desde Pro en adelante.