Simone
fa648a78db
I link andavano a 7zip-19.00/, 7zip-25.01/, 7zip-26.00/: nomi ereditati dal monorepo di partenza e mai esistiti qui. Le versioni stanno in versions/, submodule popolati (git submodule status) con il loro README.md. Corretti README.md e README_IT.md.
159 lines
5.9 KiB
Markdown
159 lines
5.9 KiB
Markdown
# Nsis7z NSIS Plugin
|
|
|
|
## STATO (2026-08-14)
|
|
|
|
Versione corrente: **2.3.0** (file `VERSION`, coerente con `CHANGELOG.md`).
|
|
Il numero è il risultato di un consolidamento: il 2026-05-03 il progetto era
|
|
salito rapidamente a 2.3.1→2.3.4 nello stesso giorno, poi richiuso in un
|
|
unico rilascio **2.3.0** (commit `bc02b8b`, "consolidate release as v2.3.0")
|
|
che raccoglie tutte le fix di quella giornata in una sola voce di changelog —
|
|
non un rollback funzionale.
|
|
|
|
Ultimo commit funzionale: **f4cd9b9** (2026-05-03), fix ai binari
|
|
`nsis7z.dll` per amd64/x86-ansi/x86-unicode. Da allora un solo commit,
|
|
**615d47e** (2026-08-14), di sola manutenzione (`.gitignore` per gli archivi
|
|
di release costruiti in locale) — nessun lavoro applicativo dopo maggio.
|
|
|
|
**Prossimo passo:** non risulta un TODO/NOTE in questo repo con aperti
|
|
tracciati; `CHANGELOG.md` ha una voce `[Unreleased]` vuota, quindi nessuna
|
|
modifica in attesa di release.
|
|
|
|
**2026-08-22 — tabella delle versioni ripuntata.** I tre link di *Available Versions*
|
|
andavano a `7zip-19.00/`, `7zip-25.01/`, `7zip-26.00/`: nomi ereditati dal monorepo di
|
|
partenza (`chore: initial commit`, 29/04) e **mai esistiti in questo repo**. Le versioni
|
|
stanno in `versions/19.00`, `versions/25.01`, `versions/26.00` — le ultime due sono
|
|
submodule **popolati** (`git submodule status`), con il loro `README.md` al posto giusto.
|
|
Link corretti anche in `README_IT.md`. ⚠️ Da decidere: c'è anche il submodule
|
|
**`versions/26.01`**, che la tabella non nomina.
|
|
|
|
NSIS plugin for extracting 7z, ZIP and NSIS archives.
|
|
|
|
---
|
|
|
|
## Available Versions
|
|
|
|
| Version | 7-Zip | Formats | Notes |
|
|
|---------|-------|---------|-------|
|
|
| [19.00](versions/19.00/README.md) | 7-Zip 19.00 | 7z, LZMA, XZ, Split | Original updated version |
|
|
| [25.01](versions/25.01/README.md) | 7-Zip 25.01 | 7z, ZIP, LZMA, XZ, Split, **NSIS** | With NSIS archive support |
|
|
| [**26.00**](versions/26.00/README.md) | 7-Zip 26.00 | 7z, ZIP, LZMA, XZ, Split, **NSIS** | **Recommended** |
|
|
|
|
## Supported Architectures
|
|
|
|
| Architecture | Description |
|
|
|--------------|-------------|
|
|
| x86-ansi | 32-bit ANSI (legacy) |
|
|
| x86-unicode | 32-bit Unicode |
|
|
| **amd64-unicode** | 64-bit Unicode |
|
|
|
|
## Quick Start
|
|
|
|
```nsis
|
|
!addplugindir "plugins\x86-unicode"
|
|
|
|
Section
|
|
; Simple extraction (7z, ZIP, NSIS)
|
|
Nsis7z::Extract "$EXEDIR\data.7z"
|
|
|
|
; With progress text in label
|
|
Nsis7z::ExtractWithDetails "$EXEDIR\data.7z" "Installing %s..."
|
|
|
|
; With callback to show files in listbox
|
|
GetFunctionAddress $0 MyExtractCallback
|
|
Nsis7z::ExtractWithFileCallback "$EXEDIR\data.7z" $0
|
|
SectionEnd
|
|
|
|
Function MyExtractCallback
|
|
Pop $0 ; completedSize
|
|
Pop $1 ; totalSize
|
|
Pop $2 ; fileName
|
|
DetailPrint "$2"
|
|
FunctionEnd
|
|
```
|
|
|
|
## Build Scripts
|
|
|
|
The repo includes a single unified `build_plugin.py` script that replaces the previous per-version scripts.
|
|
|
|
### Build
|
|
|
|
```powershell
|
|
# Recommended: 7-Zip 26.00 with auto-detected toolset
|
|
python build_plugin.py
|
|
|
|
# Select 7-Zip version (19.00 | 25.01 | 26.00)
|
|
python build_plugin.py --7zip-version 25.01
|
|
|
|
# Specific toolset (2022|2026|auto)
|
|
python build_plugin.py --toolset 2022
|
|
|
|
# Linux host path (cross-build with MinGW-w64, 26.00)
|
|
python build_plugin.py --host linux
|
|
|
|
# Print version and exit
|
|
python build_plugin.py --version
|
|
```
|
|
|
|
Linux notes:
|
|
- Local Linux path currently supports `--7zip-version 26.00`.
|
|
- Requires MinGW-w64 toolchains (`x86_64-w64-mingw32-*` and `i686-w64-mingw32-*`) and `make`.
|
|
|
|
## Repository Structure
|
|
|
|
```
|
|
nsis-plugin-ns7zip/
|
|
├── build_plugin.py # Unified build script (all versions)
|
|
├── build_zstd.cmd # Build script for 7-zip-zstd variant
|
|
├── rebuild_nsis7z1900-src.ps1 # Rebuilds 19.00 sources
|
|
├── versions/
|
|
│ ├── 19.00/ # 7-Zip 19.00 modified
|
|
│ ├── 25.01/ # 7-Zip 25.01 modified (ZIP + NSIS handler)
|
|
│ ├── 26.00/ # 7-Zip 26.00 modified (ZIP + NSIS handler)
|
|
│ └── 7-zip-zstd/ # 7-Zip zstd fork (submodule)
|
|
├── plugins/ # Compiled DLLs output
|
|
├── tools/
|
|
│ ├── fix_vcxproj.py # Project file patcher
|
|
│ ├── update_gitea_releases.py # Backfill Gitea release bodies (one-shot)
|
|
│ ├── release-notes/ # Per-version Markdown snippets
|
|
│ ├── linux/ # Linux-specific build helpers
|
|
│ └── legacy/ # Old per-version build scripts
|
|
└── .github/workflows/
|
|
├── build.yml # CI: Windows + Linux matrix build
|
|
└── release.yml # Release: build artifacts + publish to GitHub & Gitea
|
|
```
|
|
|
|
## CI / Release Workflow
|
|
|
|
- **build.yml** — runs on every push/PR; builds all three configs on Windows (MSBuild) and Linux (MinGW-w64) in parallel.
|
|
- **release.yml** — triggered by a `v*` tag push; builds and packages artifacts, creates a GitHub Release with the relevant CHANGELOG section as body, and updates the corresponding Gitea release body via API (`GITEA_TOKEN` secret required).
|
|
|
|
## Changes from Original
|
|
|
|
### NSIS Archive Handler (25.01, 26.00)
|
|
Added support for extracting `.exe` archives created with NSIS (not present in the original plugin):
|
|
- `Archive\Nsis\NsisHandler.cpp/h`
|
|
- `Archive\Nsis\NsisIn.cpp/h`
|
|
- `Archive\Nsis\NsisDecode.cpp/h`
|
|
- `Archive\Nsis\NsisRegister.cpp`
|
|
- `Compress\BZip2Decoder.cpp/h` (required by NsisDecode)
|
|
- `Compress\BZip2Crc.cpp`
|
|
|
|
### Bug Fixes (25.01, 26.00)
|
|
- **Divide-by-zero**: added guard `if (totalSize == 0) return 0` in `GetPercentComplete`
|
|
- **ExtractWithFileCallback**: NSIS callback triggered only on filename change (avoids crash with `totalSize = UINT64_MAX` on first `SetTotal` call)
|
|
|
|
## License
|
|
|
|
- **7-Zip**: LGPL 2.1 + BSD 3-clause
|
|
- **NSIS Plugin**: Afrow UK
|
|
|
|
## Credits
|
|
|
|
- Igor Pavlov (7-Zip)
|
|
- Afrow UK (Original plugin)
|
|
- Simone (x64 support, VS2022/VS2026, ZIP, NSIS handler, ExtractWithFileCallback)
|
|
|
|
---
|
|
|
|
*See [README_IT.md](README_IT.md) for the Italian version.*
|