Simone
119 lines
4.1 KiB
Markdown
119 lines
4.1 KiB
Markdown
# 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)*
|