ZZBlocks 0.4.30 TEST - Installer per tutti gli utenti del laboratorio

INSTALLAZIONE
1. Estrarre tutto lo ZIP in una cartella.
2. Chiudere ZZBlocks in tutti gli account Windows connessi.
3. Avviare ZZBlocks_Setup_0.4.30_TEST_Online_Windows_x64.exe.
4. Fornire le credenziali amministrative quando Windows le richiede.
5. Lasciare selezionata l'icona sul desktop per tutti gli utenti.
6. Attendere download, verifica ed estrazione degli strumenti.
7. Chiudere l'installer e accedere con l'account normale dell'alunno.

Servono Windows 10/11 a 64 bit, circa 9 GB liberi e Internet durante
l'installazione. Il setup scarica circa 1,8 GB per UNO, Mega ed ESP32.
La finestra mostra i pacchetti che sta preparando. Una connessione lenta
puo' richiedere parecchio tempo. Non chiudere l'installer durante i download.
Gli archivi completati vengono conservati per poter riprovare se necessario.

UTILIZZO DA PARTE DEGLI ALUNNI
Il programma si trova in C:\Program Files\ZZBlocks.
Le icone sul desktop pubblico e nel menu Start sono visibili a tutti,
anche agli account creati successivamente. L'avvio normale non richiede
credenziali amministrative. Python e Arduino CLI sono inclusi.
Gli strumenti preparati dall'amministratore sono condivisi: gli alunni
non devono scaricarli o prepararli nuovamente per ogni account.

L'editor si apre nel browser. Lasciare aperta la finestra di avvio;
chiuderla termina il servizio locale e le eventuali compilazioni in corso.
Per il monitor seriale usare Chrome o Edge e autorizzare la scheda.

PRIMA PROVA SU UN PC PILOTA
Accedere con un account senza privilegi amministrativi. Aprire ZZBlocks,
controllare gli strumenti per UNO, Mega ed ESP32, aprire LED lampeggiante
e provare compilazione e caricamento sulla scheda. Verificare il monitor
seriale. Ripetere l'avvio da un secondo account e controllare che le copie
di recupero dei progetti rimangano separate.

La prima compilazione resta piu' lenta: la cache e' personale e dipende
da scheda e progetto. I download iniziali degli strumenti non si ripetono.
La copia iniziale degli indici CLI nel profilo puo' richiedere qualche istante.

DATI E AGGIORNAMENTI
Core, compilatori e librerie esterne sono nel percorso protetto shared-tools.
Stato Arduino CLI, indici, cache e recuperi restano in %LOCALAPPDATA%\ZZBlocks
per ciascun utente. Un collegamento NTFS permette di leggere i pacchetti
comuni senza copiarli integralmente per ogni account. Se piu' persone usano
lo stesso account Windows, condividono i dati di quell'account.
Salvare i progetti come .ZZBlocks nel percorso personale previsto dalla scuola.

Per aggiornare o riparare eseguire di nuovo il setup come amministratore,
dopo aver chiuso ZZBlocks in tutti gli account. I pacchetti gia' scaricati
si trovano in C:\Program Files\ZZBlocks\installer-cache. Il setup verifica
i checksum e riutilizza i download completati. La cache occupa circa 1,8 GB;
conservarla facilita una riparazione senza ripetere i download.

Per installare sugli altri PC della scuola usare lo stesso installer.
Un amministratore puo' copiare preventivamente il contenuto di installer-cache
nel medesimo percorso del nuovo PC: il setup riutilizzera' gli archivi validi
senza riscaricarli. Questa copia serve solo per velocizzare la distribuzione.
L'installazione normale con Internet non richiede questa operazione.

La disinstallazione rimuove programma, strumenti comuni e cache del setup.
Conserva i file nei profili e i progetti esportati. Non e' necessario concedere
agli alunni permessi di scrittura in Program Files.

DRIVER E DISTRIBUZIONE
Il setup non installa driver USB. L'amministratore deve predisporre il driver
appropriato se Windows non riconosce la scheda del laboratorio.
Per una distribuzione gestita e' disponibile l'opzione /S; il comando deve
essere gia' eseguito in un contesto amministrativo. Provare prima il setup
interattivo sul PC pilota.

STATO TEST
Eseguibili Windows compilati, archivi verificati e prove software superate.
Non e' stata eseguita l'installazione su Windows reale con UAC, permessi NTFS
e account alunno, ne' il caricamento USB da questo pacchetto.
Il setup TEST non ha una firma digitale Authenticode.
