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¶
- Guia do componente: 15-experiment-packaging.md
- Inventário do workspace: docs/modules.md