nsis-plugin-nsunz/versions/zlib-1.3/BUILD_INFO.md

nsisunz - Informazioni di Build

⚠️ Nota importante

Visual Studio 2026 Build Tools - Toolset v145

Visual Studio 2026 Build Tools (versione 18.x) utilizza il Platform Toolset v145.

Percorsi di installazione

VS2026 Build Tools installato con Chocolatey si trova in:

• C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools

Toolset

• VS2022: v143
• VS2026: v145

---

File di progetto disponibili

Questo plugin supporta due versioni di Visual Studio:

Visual Studio 2022 (v143)

• File progetto: Source/nsisunz.vcxproj
• Script build: build_plugin.py
• Platform Toolset: v143
• Percorso VS: C:\Program Files\Microsoft Visual Studio\2022\

Visual Studio 2026 (v145)

• File progetto: Source/nsisunz_vs2026.vcxproj
• Script build: build_plugin_vs2026.py
• Platform Toolset: v145
• Percorso VS: C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools

Compilazione

Con Visual Studio 2022

Metodo 1: Script Python

cd nsUnz-zlib1.3
python build_plugin.py

Metodo 2: Visual Studio IDE

1. Apri Source\nsisunz.vcxproj in Visual Studio 2022
2. Seleziona la configurazione (Release, Release Unicode)
3. Seleziona la piattaforma (Win32, x64)
4. Build → Rebuild Solution

Metodo 3: MSBuild diretto

cd nsUnz-zlib1.3\Source
msbuild nsisunz.vcxproj /p:Configuration="Release Unicode" /p:Platform=Win32
msbuild nsisunz.vcxproj /p:Configuration="Release Unicode" /p:Platform=x64
msbuild nsisunz.vcxproj /p:Configuration=Release /p:Platform=Win32

Visual Studio 2026 (FUNZIONANTE)

Metodo 1: Script Python

cd nsUnz-zlib1.3
python build_plugin_vs2026.py

Metodo 2: Visual Studio IDE

1. Apri Source\nsisunz_vs2026.vcxproj in Visual Studio 2026
2. Seleziona la configurazione (Release, Release Unicode)
3. Seleziona la piattaforma (Win32, x64)
4. Build → Rebuild Solution

Metodo 3: MSBuild diretto

cd nsUnz-zlib1.3\Source
msbuild nsisunz_vs2026.vcxproj /p:Configuration="Release Unicode" /p:Platform=Win32
msbuild nsisunz_vs2026.vcxproj /p:Configuration="Release Unicode" /p:Platform=x64
msbuild nsisunz_vs2026.vcxproj /p:Configuration=Release /p:Platform=Win32

Configurazioni Build

Entrambi i progetti supportano le stesse configurazioni:

Nome Config	Configurazione VS	Piattaforma	Output	Destinazione Plugin
x86-ansi	Release	Win32	nsisunz.dll	plugins/x86-ansi/
x86-unicode	Release Unicode	Win32	nsisunz.dll	plugins/x86-unicode/
x64-unicode	Release Unicode	x64	nsisunz.dll	plugins/amd64-unicode/

Opzioni Script Python

Entrambi gli script supportano le stesse opzioni:

# Compila tutte le configurazioni
python build_plugin.py

# Compila solo configurazioni specifiche
python build_plugin.py --configs x86-unicode x64-unicode

# Build incrementale (no rebuild)
python build_plugin.py --no-rebuild

# Build single-thread (no parallel)
python build_plugin.py --no-parallel

# Aumenta verbosità
python build_plugin.py --verbosity minimal

# Non pulire file intermedi
python build_plugin.py --no-clean

# Lista configurazioni disponibili
python build_plugin.py --list

# Pausa alla fine
python build_plugin.py --pause

# Benchmark prestazioni
python build_plugin.py --benchmark --configs x86-unicode

Differenze tra VS2022 e VS2026

Platform Toolset

• VS2022: v143
• VS2026: v145 (versione 18.x Build Tools)

Percorso installazione

• VS2022: C:\Program Files\Microsoft Visual Studio\2022\
• VS2026 Build Tools: C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools

Compatibilità

Entrambe le versioni producono DLL binari compatibili con NSIS. La differenza principale è nel compilatore e nell'ottimizzatore utilizzato.

Quando usare quale versione?

Usa VS2022 se:

• È la tua versione corrente di Visual Studio
• Vuoi stabilità e compatibilità provata
• Stai lavorando in un ambiente di produzione

Usa VS2026 se:

• Hai installato VS2026 Build Tools (choco install visualstudio2026buildtools)
• Vuoi utilizzare il toolset v145
• Vuoi testare il compilatore più recente

Output

Dopo la compilazione, i DLL vengono copiati in:

Launchers/plugins/
├── x86-ansi/nsisunz.dll
├── x86-unicode/nsisunz.dll
└── amd64-unicode/nsisunz.dll

Preprocessor Defines

Entrambi i progetti utilizzano:

• NOCRYPT - Disabilita supporto ZIP criptati
• Z_SOLO - Disabilita funzioni gzip (riduce dipendenze)

Requisiti

Per Visual Studio 2022

• Visual Studio 2022 (Community/Professional/Enterprise)
• Windows SDK 10.0
• Desktop development with C++ workload
• Python 3.6+ (opzionale, per script build)

Per Visual Studio 2026

• Visual Studio 2026 Build Tools (Community/Professional/Enterprise)

  choco install visualstudio2026buildtools
  

• Windows SDK 10.0
• Desktop development with C++ workload
• Python 3.6+ (opzionale, per script build)

Troubleshooting

MSBuild non trovato

Assicurati che Visual Studio sia installato con il workload "Desktop development with C++".

Errore Platform Toolset

Se vedi errori sul toolset, verifica che la versione corretta di Visual Studio sia installata:

• v143 richiede VS2022
• v145 richiede VS2026 Build Tools (versione 18.x)

Errore Z_SOLO / gzguts.h

Questo è già risolto nei progetti. Se vedi questo errore, assicurati che Z_SOLO sia definito nei preprocessor defines.

Note

• Visual Studio 2026 Build Tools (versione 18.x) usa il toolset v145
• Installabile con Chocolatey: choco install visualstudio2026buildtools
• Il percorso di installazione è C:\Program Files (x86)\Microsoft Visual Studio\18\BuildTools
• Entrambi gli script (VS2022 e VS2026) sono completamente funzionanti

---

Aggiornato: Dicembre 2025