appcore-sdk

ID estável da documentação: ACR-028.

Release publicada: appcore-sdk 1.0.0-rc.2.

appcore-sdk é a fachada para aplicações. Ele oferece uma superfície pequena e orientada a manifestos enquanto crates especializados continuam responsáveis por storage, scheduling, sync, AI, documentos e deployment.

Ele substitui o appcore-bin, agora aposentado, sem manter o antigo host ou a CLI do Runtime.

Migração do appcore-bin

A versão final de appcore-bin no crates.io é apenas um aviso de aposentadoria. Aplicações novas devem depender diretamente de appcore-sdk. Aplicações existentes mantêm seus manifests e código de negócio, trocam os imports de appcore_bin e deixam providers, listeners, workers e shutdown com o executável de deployment.

Quando usar

• ao iniciar uma aplicação AppCore externa com os três artefatos;
• ao implementar Application e registrar commands, events, queries, decisions, states, handlers ou tasks;
• ao usar defaults locais canônicos antes de fornecer manifests V1 explícitos;
• ao ativar namespaces de capabilities sem compor manualmente um host Runtime.

Ele não abre listener implicitamente, escolhe providers, resolve secrets nem controla o lifecycle do processo. A composição do deployment continua explícita.

Contratos principais

• run e App fornecem o menor contexto local validado;
• Application define os hooks de registro pertencentes à aplicação;
• manifest reexporta os contratos canônicos de manifest V1;
• namespaces protegidos por features expõem contratos de API, deployment, scheduler, storage, sync, AI e FileMaker;
• App::logging configura o pipeline limitado de appcore-log.

Comece pelo tutorial da primeira aplicação e pelo guia em inglês, guia em português ou guia em francês. Depois execute o exemplo básico e o exemplo intermediário.