STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO
Desenvolver módulos nativos
Por que um módulo nativo precisa do Core
Um manifesto titan.* descreve um módulo integrado ao host: controladores, rotas, serviços, permissões agrupadas, navegação, esquema de dados e dependências. Seu ponto de entrada frequentemente registra serviços em vez de ser uma função independente.
Módulos como o MDM usam sessão, autorização, conexão PDO, migrações e canais WebSocket do Titan. Executar php service.php fora desse contexto não equivale a executar o plugin. O Studio usa o núcleo licenciado para fornecer esse contexto localmente.
Estrutura recomendada do workspace
Abra a árvore que contém os módulos e preserve os diretórios irmãos necessários às dependências:
plugins/native/
mdm/
manifest.json
service.php
index.php
compat/
downloads/
manifest.json
...
O resolvedor lê dependencies pelo ID do manifesto. Se titan.mdm requer titan.downloads, a pasta desse segundo módulo precisa estar disponível no catálogo local. Não é necessário instalar todos os plugins na extensão.
Fluxo de trabalho
- Abra o
manifest.jsondo módulo que deseja melhorar. - Execute Carregar módulo nativo no Titan local. Abrir preview faz esse encaminhamento automaticamente para módulos nativos.
- A extensão prepara o Core, resolve o grafo de dependências e copia os fontes necessários para a árvore de desenvolvimento.
- A primeira rota declarada do módulo abre no painel. Use a navegação do próprio Titan para percorrer as demais telas autorizadas.
- Edite os arquivos originais no workspace e salve. O Studio sincroniza as cópias e atualiza o painel.
- Consulte os logs de PHP e do worker para investigar falhas. As migrações e consultas usam apenas o banco local.
- Execute os testes do repositório e revise o diff antes de planejar a atualização do ambiente de homologação.
O que é copiado
A cópia preserva o código do módulo e seus recursos. Diretórios como .git, node_modules, uploads e dados de usuários não são usados como carga inicial. Segredos em arquivos .env, chaves .secret, logs e dumps SQL não acompanham essa cópia.
Links simbólicos dentro do módulo são recusados para evitar que uma seleção local atravesse para diretórios não previstos. Se o seu projeto depende deles, organize os fontes dentro da raiz do módulo ou prepare explicitamente uma árvore de desenvolvimento sem links para dados operacionais.
O carregamento tem limites de quantidade e tamanho de arquivos. Um projeto que exceda os limites deve reduzir artefatos gerados ou dependências desnecessárias em sua árvore, não remover verificações de confinamento.
Contratos existentes
O Studio não reescreve IDs de módulo, permissões, rotas ou APIs móveis. Os adaptadores de compatibilidade são usados na cópia local. Se um manifesto antigo não tiver nome de exibição, o Studio infere esse nome apenas para o host de desenvolvimento.
Dependência ausente e dependência circular interrompem o carregamento. Um módulo pode abrir uma tela e ainda depender de outro serviço para uma ação específica. Revise libraries, serviceProvider, controladores e os contratos efetivamente usados pelo código.
Banco vazio não é ambiente homologado
O host começa sem dispositivos, pedidos, documentos ou contas reais. Algumas telas exibem estados vazios; isso é diferente de uma demonstração HTML com dados inventados. O controlador real está rodando, mas consulta uma base local nova.
Integrações com ERP, dispositivos Android, emissão de documentos e assinaturas precisam de fixtures ou serviços de homologação próprios. Não aponte os testes para dispositivos ou dados operacionais para preencher a interface.
Testar uma atualização existente
Crie uma branch no repositório, registre o comportamento anterior, desenvolva a alteração e execute os testes de contrato. Quando precisar testar migrações, use um conjunto sanitizado de dados de desenvolvimento preparado por um procedimento explícito, fora do VSIX.
A extensão não faz deploy, não reinicia workers operacionais e não publica o módulo automaticamente. O FEX Builder para plugins externos não deve ser usado para converter silenciosamente o formato de um manifesto nativo.