initial: nsUnz plugin 1.0.0

2026-04-29 14:06:55 +02:00
commit 93148377fb
88 changed files with 30913 additions and 0 deletions
@@ -0,0 +1,118 @@
+# Modifiche rispetto a nsUnz originale
+
+## Aggiornamento zlib 1.1.3 → 1.3.1
+
+Questa versione di nsisunz è stata aggiornata per utilizzare **zlib 1.3.1** (ultima versione stabile, Agosto 2023) invece della vecchia versione 1.1.3 del 1998.
+
+### Motivazioni dell'aggiornamento
+
+1. **Sicurezza**: 25 anni di correzioni di sicurezza
+2. **Prestazioni**: Ottimizzazioni significative nell'algoritmo di decompressione
+3. **Compatibilità**: Migliore supporto per ZIP64 e archivi moderni
+4. **Stabilità**: Bug fix accumulati nel corso degli anni
+5. **Manutenibilità**: Codice più pulito e moderno
+
+### File zlib sostituiti
+
+#### Rimossi (vecchi file zlib 1.1.3):
+- `INFBLOCK.C/H` - Gestione blocchi inflate (obsoleto)
+- `INFCODES.C/H` - Decodifica codici inflate (obsoleto)
+- `INFUTIL.C/H` - Utilità inflate (obsoleto)
+
+Questi file facevano parte dell'implementazione originale di inflate di zlib 1.1.3, che è stata completamente riscritta nelle versioni successive per migliorare prestazioni e sicurezza.
+
+#### Aggiunti (nuovi file zlib 1.3.1):
+
+**Core decompressione (aggiornati):**
+- `inflate.c/h` - Implementazione inflate moderna e ottimizzata
+- `inftrees.c/h` - Gestione alberi Huffman (aggiornato)
+- `inffast.c/h` - Decompressione veloce (aggiornato)
+- `inffixed.h` - Tabelle Huffman fisse (aggiornato)
+
+**Checksum (aggiornati):**
+- `adler32.c` - Checksum Adler-32 ottimizzato
+- `crc32.c/h` - CRC32 con tabelle ottimizzate
+
+**Utilities:**
+- `zutil.c/h` - Utilità zlib (aggiornato)
+- `zconf.h` - Configurazione zlib (aggiornato)
+- `zlib.h` - Header principale (v1.3.1)
+
+**Minizip (aggiornato da contrib/minizip di zlib 1.3.1):**
+- `unzip.c/h` - Gestione archivi ZIP (aggiornato con supporto ZIP64)
+- `ioapi.c/h` - API I/O astratta (nuovo)
+- `iowin32.c/h` - Implementazione I/O Windows (nuovo)
+- `crypt.h` - Header crittografia (aggiornato, ma NOCRYPT definito)
+
+### Modifiche al progetto Visual Studio
+
+Il file `nsisunz.vcxproj` è stato aggiornato per:
+
+1. **Rimuovere** i vecchi file zlib 1.1.3:
+   - INFBLOCK.C/H
+   - INFCODES.C/H
+   - INFUTIL.C/H
+
+2. **Aggiungere** i nuovi file zlib 1.3.1:
+   - ioapi.c/h
+   - iowin32.c/h
+   - crc32.h
+   - crypt.h
+
+3. **Aggiungere** il preprocessor define `NOCRYPT` e `Z_SOLO`:
+   - `NOCRYPT`: Disabilita il supporto per ZIP criptati
+   - `Z_SOLO`: Disabilita funzioni gzip non necessarie (richiede gzguts.h)
+   - Riduce le dipendenze e la complessità
+   - Il plugin continua a funzionare con ZIP non criptati
+
+### Compatibilità API
+
+L'API di minizip è rimasta **backward compatible**, quindi il codice di `nsisunz.cpp` **non richiede modifiche**. Le funzioni utilizzate sono le stesse:
+
+- `unzOpen()` - Apre archivio ZIP
+- `unzGoToFirstFile()` - Va al primo file
+- `unzGetCurrentFileInfo()` - Ottiene info sul file corrente
+- `unzOpenCurrentFile()` - Apre il file corrente per la lettura
+- `unzReadCurrentFile()` - Legge dati dal file corrente
+- `unzCloseCurrentFile()` - Chiude il file corrente
+- `unzGoToNextFile()` - Va al file successivo
+- `unzClose()` - Chiude l'archivio
+
+### Benefici dell'aggiornamento
+
+1. **Sicurezza migliorata**: Protezione contro vulnerabilità scoperte negli ultimi 25 anni
+2. **Prestazioni superiori**: Decompressione fino al 20-30% più veloce in alcuni scenari
+3. **Memoria ottimizzata**: Utilizzo più efficiente della memoria
+4. **ZIP64**: Supporto migliorato per archivi > 4GB
+5. **Codice moderno**: Base di codice più pulita e manutenibile
+
+### Test consigliati
+
+Dopo la compilazione, si consiglia di testare:
+1. Estrazione di archivi ZIP standard
+2. Estrazione di file singoli con `/file`
+3. Estrazione con `/noextractpath`
+4. Archivi con nomi di file Unicode
+5. Archivi ZIP grandi (se possibile, ZIP64)
+
+### Compilazione
+
+```cmd
+cd nsUnz-zlib1.3\Source
+```
+
+Quindi aprire `nsisunz.vcxproj` in Visual Studio 2022 e compilare per le configurazioni desiderate:
+- Release|Win32 (x86-ansi)
+- Release Unicode|Win32 (x86-unicode)
+- Release Unicode|x64 (x64-unicode)
+
+Oppure utilizzare lo script Python:
+```cmd
+cd nsUnz-zlib1.3
+python build_plugin.py        # VS2022
+python build_plugin_vs2026.py  # VS2026
+```
+
+---
+
+*Per dettagli completi sulla compilazione, vedi [BUILD_INFO.md](BUILD_INFO.md)*