Ir para o conteúdo

federated-experiment-packager

Papel

Biblioteca e CLIs Java para gerar e ler os três formatos de pacote usados por fluxos distintos do HDT-AF. Os pacotes de código de experimento, dados de replay e plugin Android têm manifestos e validações diferentes.

Formatos

Formato Conteúdo e consumidor
.hdtpkg.zip Código/configuração de experimento; implantado pelo federated-rest-api e executado no processo isolado de experimento.
.hdtsim.zip Dados e metadados de simulação; lido pelo federated-simulator.
.hdtclient.zip Plugin DEX de cliente, manifesto, checksums e assinatura Ed25519; validado pelo serviço/API e pelo runtime Android.

As classes ExperimentPackage*, SimulationDataPackage* e ClientPackage* contêm descritores, readers/writers e CLIs. Os formatos compartilham utilitários ZIP/checksum de federated-common, mas não são intercambiáveis. A assinatura Ed25519 descrita para pacote cliente não deve ser generalizada aos outros formatos.

Fluxo arquitetural

Entrada: código/configuração, CSV/particionamento ou DEX/manifesto/chave de assinatura, conforme o CLI. Saída: ZIP validado com manifesto e integridade verificável. REST API valida uploads; o cliente Android valida novamente seu pacote antes de carregar o plugin; o simulador lê pacote de dados. Dados de treino brutos continuam locais ao participante.

Build e comandos

Módulo Maven, JDK 25:

mvn -pl modules/federated-experiment-packager -am test
sh scripts/package-experiment.sh --help
sh scripts/package-simulation-data.sh --help
sh scripts/package-federated-client.sh --help

Os scripts são executados na raiz do workspace. Consulte guia de empacotamento e inventário.

Documentação relacionada