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,106 @@
+# 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`.