En esta sección
Configuración de la aplicación
defineApplication: identidad, rol predeterminado, variables y metadatos del marketplace.Roles y permisos
defineRole: declara qué pueden leer y escribir las funciones lógicas de tu app.Hooks de instalación
definePreInstallLogicFunction, definePostInstallLogicFunction y defineUninstallLogicFunction: hacen copias de seguridad de los datos, cargan valores predeterminados, validan actualizaciones y limpian durante la desinstalación.Cómo se relacionan las piezas
- Application es el punto de entrada. Cada app tiene exactamente una llamada a
defineApplication(), y apunta a un Role como su valor predeterminado. - El Role controla qué pueden leer y escribir las funciones lógicas y los componentes de interfaz de la app. Sigue el principio de privilegios mínimos: concede solo los permisos que tu código realmente necesita.
- Los hooks de instalación se ejecutan durante la instalación o la actualización: el hook de preinstalación antes de la migración de metadatos (para poder rechazar una actualización arriesgada) y el hook de postinstalación después de la migración (para poder cargar datos predeterminados con el nuevo esquema). El hook de desinstalación se ejecuta justo antes de que se elimine la aplicación, por lo que puede limpiar recursos externos mientras los datos de la aplicación siguen siendo legibles.
Los hooks de instalación comparten el entorno de ejecución de la función lógica: misma firma del handler, mismas variables de entorno, mismo cliente de API tipado, pero se declaran con sus propias funciones de definición y viven fuera del modelo de triggers habitual (HTTP, cron, eventos de base de datos).