SB-Updater — Guida completa pubblica

1. Cos’è SB-Updater

SB-Updater è il repository centrale Service Beyond per distribuire aggiornamenti software a più applicativi, più canali di rilascio e più server di destinazione, mantenendo manifest JSON, pacchetti ZIP, hash SHA-256 e controllo delle release in un unico pannello.

• gestione multi-progetto
• canali separati per sviluppo, test e produzione
• upload unico della release e riuso su più target
• manifest e check-update pronti per i client

2. Come funziona

1. Il maintainer crea o aggiorna un progetto software.
2. Carica una release ZIP nel repository centrale.
3. Definisce versione, build, note, data e canale.
4. Pubblica la release, aggiornando il manifest del canale.
5. Il client interroga il server updater e verifica la presenza di aggiornamenti.
6. Se disponibile, scarica il pacchetto corretto e procede con l’installazione.

Client app → check update → SB-Updater Server → manifest JSON → download package.zip → installazione

3. Funzionalità principali del server

• creazione e modifica progetti
• archivio release con versioni, build, note e checksum
• canali personalizzabili per ogni progetto
• server destinatari con ambienti separati
• registro installazioni reali
• guida pubblica, resource kit interno e PDF dinamici
• self update protetto del server updater

4. Funzionalità principali del client

• check update verso endpoint centralizzato
• lettura del manifest del progetto e del canale corretto
• download del pacchetto ZIP aggiornato
• verifica hash e analisi differenziale dei file
• installazione e tracciamento nel server updater

5. Applicativi supportati

6. Documentazione e stampa

Le guide HTML e i PDF vengono generati dinamicamente dal sistema. Quando il progetto cresce, la documentazione viene aggiornata insieme alle funzioni e può essere stampata in qualsiasi momento senza dover ricompilare un manuale statico.

7. Integrazione di una nuova applicazione client

1. Registrare il progetto in SB-Updater e annotare lo slug del progetto.
2. Configurare il canale da usare sul client, per esempio dev o stable.
3. Inserire nel client l’URL del manifest o dell’endpoint check-update.
4. Aggiungere una pagina amministrativa per analisi, download e installazione.
5. Attivare il report installazione se si vuole tracciare le installazioni remote.

return [
  'manifest_url' => 'https://dominio.tld/sb-updater/manifests/project-4fd77221/dev.json',
  'project' => 'project-4fd77221',
  'channel' => 'dev',
];

8. FAQ rapida