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

  1. Declare titan.downloads como dependência e downloads.read_release como permissão no manifesto.
  2. Receba o Client do host pelo ponto de entrada do seu plugin. O host vincula a identidade e a autorização à chamada.
  3. Informe mdm ou coletor para selecionar o aplicativo. Leia a referência de Downloads para ver a finalidade da operação.
  4. Trate release: null como ausência de versão ativa. Trate uma falha de permissão ou de transporte como erro da consulta.
  5. Compare versionCode com o código instalado e minSdk com a API Android do dispositivo. Confirme o nome do pacote antes da comparação. Use version para exibição.
  6. 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.