Projetos de referência do SDK
Os dois projetos consultam o contrato usado na distribuição de versões do TrustedMDM e do Coletor. Cada exemplo recebe um cliente do SDK, consulta downloads.release_manifest e compara a versão publicada com os dados de um dispositivo. As demonstrações locais usam respostas sintéticas e exercitam o protocolo JSON sem precisar de conta, credenciais ou banco do Titan Continuum.
Escolha um ponto de partida
| Projeto | Use para praticar | Caminho no ZIP |
|---|---|---|
| PHP | Injeção de dependência, consulta de versões e relatório de compatibilidade Android | examples/php/ |
| TypeScript | Validação de respostas, tipagem de resultados e decisão de atualização por dispositivo | examples/typescript/ |
| Kit de interface | Apresentar status, métricas, filtros e detalhes em uma página de plugin | design/ |
Abra o README.md de cada projeto para executar os testes, conferir os cenários e localizar os arquivos que entram no FEX. O guia do kit de interface explica como transportar estilos, componentes e comportamentos para o próprio plugin. O guia de desenvolvimento cobre a integração com o núcleo.
Execute os exemplos isoladamente
Na raiz do SDK extraído, confira o ambiente e execute a demonstração em PHP:
php tools/titan-sdk.php doctor php
php examples/php/demo.php
Para TypeScript, compile primeiro a biblioteca. Depois instale as dependências locais do projeto e rode os testes:
cd typescript
npm install
npm run build
cd ../examples/typescript
npm ci
npm test
npm run demo -- mdm
Aplique o fluxo ao seu plugin
- Declare
titan.downloadscomo dependência edownloads.read_releasecomo permissão no manifesto. - Receba o
Clientdo host pelo ponto de entrada do seu plugin. O host vincula a identidade e a autorização à chamada. - Informe
mdmoucoletorpara selecionar o aplicativo. Leia a referência de Downloads para ver a finalidade da operação. - Trate
release: nullcomo ausência de versão ativa. Trate uma falha de permissão ou de transporte como erro da consulta. - Compare
versionCodecom o código instalado eminSdkcom a API Android do dispositivo. Confirme o nome do pacote antes da comparação. Useversionpara exibição. - Apresente a decisão ao operador e teste uma resposta malformada, um aplicativo diferente, uma versão suspensa e um dispositivo incompatível.
Cliente tipado de versões
O ReleaseCatalog é uma biblioteca auxiliar incluída no SDK. Use-a quando quiser validar o resultado antes de acessar os campos. Ela preserva os erros do cliente e rejeita manifesto com pacote, digest, caminho ou campos numéricos inválidos. O esquema JSON do manifesto descreve o resultado da operação.
use Forge\ReleaseCatalog;
$release = (new ReleaseCatalog($client))->get('mdm');
echo $release === null ? 'Sem versão ativa' : $release['version'];
import { ReleaseCatalog } from '@zerotrusted/forge-sdk';
const release = await new ReleaseCatalog(client).get('mdm');
console.log(release?.version ?? 'Sem versão ativa');
Empacote a biblioteca ou o código compilado que seu ponto de entrada usa, conforme o runtime do seu projeto. No PHP, use o autoload do Composer ou carregue o arquivo da biblioteca explicitamente. No TypeScript, mantenha a resolução de dependências funcionando no FEX extraído.
Integre a interface a dados autorizados
Use o kit para desenhar os estados de carregamento, lista vazia, falha e versão ativa. Resolva a permissão antes da consulta no controlador. Converta a resposta em dados de apresentação no servidor, formate e escape os valores textuais e reserve aria-live para atualizações de estado da interface.
Os projetos de referência fazem consultas. Distribuição e instalação de APKs pertencem ao fluxo gerenciado pelo Titan. O SHA-256 do manifesto serve para conferir a integridade dos bytes. A assinatura Android continua sendo verificada na instalação do APK.
Confira o pacote antes de entregar
Use validate para conferir o projeto e os arquivos de distribuição, pack para criar o FEX assinado e verify para checar o conteúdo com a chave pública do publicador. Use inspect para conferir a versão, o runtime, as permissões e os arquivos incluídos. Separe fixtures, código de teste, dependências de desenvolvimento e a chave privada dos arquivos distribuídos.
A referência da CLI detalha os argumentos, o limite do pacote e os códigos de saída. O fluxo de catálogo permite verificar, revisar e selecionar o pacote. A execução externa em produção depende do supervisor e da configuração de canais do host.