Simone
107 lines
3.3 KiB
Markdown
107 lines
3.3 KiB
Markdown
# nsisunz NSIS Plugin
|
|
|
|
**Versione personale modificata**
|
|
|
|
Basato su [past-due/nsisunz](https://github.com/past-due/nsisunz) - un plugin NSIS per estrarre file da archivi ZIP.
|
|
|
|
---
|
|
|
|
## Descrizione Originale
|
|
|
|
**nsisunz** è un plugin [NSIS](https://en.wikipedia.org/wiki/Nullsoft_Scriptable_Install_System) che permette di estrarre file da archivi ZIP.
|
|
|
|
> **nsisunz** è ideale quando si usa un altro plugin NSIS chiamato _NSISdl_ per scaricare un file ZIP da internet. Si può creare un piccolo installer che permette all'utente di scegliere i componenti da installare e l'installer li scarica.
|
|
|
|
### Origini e Storia
|
|
|
|
- _nsisunz_ è stato originariamente scritto da Saivert (http://saivert.com/)
|
|
- Supporto NSIS Unicode [aggiunto da Gringoloco023](http://portableapps.com/node/21879), Febbraio 2010
|
|
- Ulteriori miglioramenti di past-due, 2018+:
|
|
- Aggiornamento NSIS plugin API a 3.0
|
|
- Aggiornamento [zlib](https://zlib.net) a [1.2.11](https://zlib.net/ChangeLog.txt)
|
|
- Aggiornamento Minizip a 1.1-8
|
|
- Supporto build [CMake](https://cmake.org) (compila sia DLL ANSI che Unicode)
|
|
|
|
## Funzioni
|
|
|
|
### UnzipToLog
|
|
|
|
Estrae i file e mostra il log dettagliato:
|
|
|
|
```nsis
|
|
InitPluginsDir
|
|
; Chiama il plugin. Prima il file ZIP, poi la cartella di destinazione.
|
|
nsisunz::UnzipToLog "$PLUGINSDIR\myzipfile.zip" "$INSTDIR"
|
|
|
|
; Controlla sempre il risultato sullo stack
|
|
Pop $0
|
|
StrCmp $0 "success" ok
|
|
DetailPrint "$0" ; stampa messaggio di errore nel log
|
|
ok:
|
|
```
|
|
|
|
### Unzip
|
|
|
|
Estrazione veloce senza log (preferita per archivi grandi):
|
|
|
|
```nsis
|
|
nsisunz::Unzip "$PLUGINSDIR\myzipfile.zip" "$INSTDIR"
|
|
```
|
|
|
|
## Credits
|
|
|
|
- Basato sul codice di NSIS Zip2Exe - porzioni Copyright © 1999-2001 Miguel Garrido (mgarrido01@hotmail.com)
|
|
- [ZLIB](https://zlib.net) - Copyright © Mark Adler
|
|
- MiniZip - Copyright © 1998-2010 - di Gilles Vollant - versione 1.1 64 bits di Mathias Svensson
|
|
|
|
## Licenza
|
|
|
|
Le condizioni di uso e distribuzione sono le stesse di [zlib](https://en.wikipedia.org/wiki/Zlib_License).
|
|
|
|
---
|
|
|
|
## ⚠️ Differenze nella versione personale
|
|
|
|
Questa versione è basata su [past-due/nsisunz](https://github.com/past-due/nsisunz) con le seguenti modifiche:
|
|
|
|
### Nuova architettura supportata: x64 (amd64-unicode)
|
|
|
|
L'originale supporta:
|
|
- x86-ansi
|
|
- x86-unicode
|
|
|
|
La versione personale aggiunge il supporto per:
|
|
- **amd64-unicode** (x64)
|
|
|
|
### Progetto Visual Studio
|
|
|
|
L'originale usa CMake per la compilazione. La versione personale include progetti Visual Studio:
|
|
- `Source/nsisunz.vcproj` - Progetto VS2008 (legacy)
|
|
- `Source/nsisunz.vcxproj` - Progetto VS2022 (x86-ansi, x86-unicode, amd64-unicode)
|
|
|
|
### File modificati/semplificati
|
|
|
|
La versione personale usa una versione più vecchia e semplificata di zlib:
|
|
- `Source/zlib/` - Libreria zlib semplificata (solo file essenziali per decompressione)
|
|
|
|
Rispetto all'originale GitHub che include:
|
|
- CMakeLists.txt e configurazione CMake completa
|
|
- zlib 1.2.11 completa con tutti i contributi (285 file)
|
|
- Minizip completo
|
|
- Configurazione CI/CD (.github, appveyor)
|
|
|
|
### File aggiunti
|
|
|
|
- `build_plugin.py` - Script Python per compilare il plugin per tutte le architetture
|
|
- `Doc/` - Documentazione (info.rtf, nsisunz_readme.html)
|
|
- `ExDLL/exdll.h` - Header per l'API NSIS extern DLL
|
|
|
|
### Compilazione
|
|
|
|
```cmd
|
|
cd nsUnz
|
|
python build_plugin.py
|
|
```
|
|
|
|
I DLL vengono copiati in `plugins/{platform}/nsisunz.dll`.
|