Nesta secção
Configuração da aplicação
defineApplication — identidade, função predefinida, variáveis, metadados do marketplace.Funções e Permissões
defineRole — declara o que as funções de lógica da sua aplicação podem ler e escrever.Hooks de instalação
definePreInstallLogicFunction, definePostInstallLogicFunction e defineUninstallLogicFunction — criam cópias de segurança dos dados, inicializam valores predefinidos, validam atualizações e fazem a limpeza na remoção.Como as peças se relacionam
- A Aplicação é o ponto de entrada. Cada aplicação tem exatamente uma chamada
defineApplication(), e esta aponta para uma Função como predefinida. - A Função controla o que as funções de lógica e os componentes de front-end da aplicação podem ler e escrever. Siga o princípio do menor privilégio: conceda apenas as permissões de que o seu código realmente necessita.
- Os Hooks de instalação são executados durante a instalação ou atualização — a pré-instalação antes da migração de metadados (para que possa recusar uma atualização arriscada) e a pós-instalação após a migração (para que possa inicializar dados predefinidos com base no novo esquema). O hook de desinstalação é executado imediatamente antes de o app ser removido, para que ele possa limpar recursos externos enquanto os dados do app ainda são legíveis.
Os hooks de instalação partilham o ambiente de execução de função de lógica — a mesma assinatura de handler, as mesmas variáveis de ambiente, o mesmo cliente de API tipado — mas são declarados com as suas próprias funções “define” e vivem fora do modelo de disparo normal (HTTP, cron, eventos de base de dados).