129 lines
3.4 KiB
Markdown
129 lines
3.4 KiB
Markdown
# BoxPacker3D - Installer Information
|
|
|
|
## 🎯 Máte 3 možnosti!
|
|
|
|
Tento projekt podporuje **tri spôsoby** vytvorenia inštalátora:
|
|
|
|
1. **WiX Toolset** (.wxs) - **ODPORÚČANÉ** - Kompletný, ready-to-build
|
|
2. **Visual Studio Installer Projects** (.vdproj) - GUI, jednoduchý
|
|
3. **Inno Setup** (.iss) - Najmenší, EXE formát
|
|
|
|
### 📖 **Podrobné porovnanie:** `INSTALLER_OPTIONS_COMPARISON.md`
|
|
|
|
---
|
|
|
|
## ⚡ Odporúčanie: WiX Toolset
|
|
|
|
**Prečo WiX?**
|
|
- ✅ **Kompletný** - `BoxPacker3D.wxs` je ready-to-build (všetky súbory definované)
|
|
- ✅ **Textový** - Git-friendly, dá sa verzovať
|
|
- ✅ **MSI výstup** - Profesionálny Windows formát
|
|
- ✅ **Build skript** - Jednoduchý `build-wix.bat`
|
|
|
|
### 🚀 Rýchly štart s WiX
|
|
|
|
1. **Stiahnite WiX Toolset:**
|
|
- https://wixtoolset.org/releases/
|
|
- Verzia 3.11 alebo novšia
|
|
|
|
2. **Build MSI:**
|
|
```batch
|
|
build-wix.bat
|
|
```
|
|
|
|
3. **Výstup:**
|
|
```
|
|
bin\BoxPacker3D.msi
|
|
```
|
|
|
|
Hotovo! 🎉
|
|
|
|
---
|
|
|
|
## 📦 Možnosť 2: Visual Studio Installer Projects
|
|
|
|
**Súbory:**
|
|
- `BoxPacker3D.Setup.vdproj` - Setup projekt (kostra - treba dotvoriť v GUI)
|
|
- `BoxPacker3D_WithSetup.sln` - Solution so Setup projektom
|
|
- `VISUAL_STUDIO_INSTALLER_GUIDE.md` - Podrobný 12-krokový návod
|
|
|
|
**Použitie:**
|
|
1. Otvorte `BoxPacker3D_WithSetup.sln` vo VS 2017
|
|
2. Nainštalujte rozšírenie "Microsoft Visual Studio Installer Projects"
|
|
3. V Setup projekte pridajte súbory cez GUI (Project Output)
|
|
4. Build → MSI v `BoxPacker3D.Setup\Release\`
|
|
|
|
**Výhody:**
|
|
- GUI drag & drop
|
|
- Integrované do VS
|
|
- Jednoduchý upgrade
|
|
|
|
**Nevýhody:**
|
|
- Binárny `.vdproj` (nie Git-friendly)
|
|
- Treba dotvoriť v GUI
|
|
- Potrebuje Visual Studio
|
|
|
|
---
|
|
|
|
## 🎨 Možnosť 3: Inno Setup
|
|
|
|
**Súbory (premenované na .OLD):**
|
|
- `installer.iss.OLD` → Odstráňte `.OLD` príponu
|
|
- `build-installer-inno.bat.OLD` → Odstráňte `.OLD` príponu
|
|
- `INSTALLER_README_INNO.md.OLD` → Návod
|
|
|
|
**Použitie:**
|
|
1. Odstráňte `.OLD` zo súborov
|
|
2. Stiahnite [Inno Setup](https://jrsoftware.org/isdl.php)
|
|
3. Otvorte `installer.iss` v Inno Setup Compiler
|
|
4. Build → EXE v `installer\BoxPacker3D_Setup.exe`
|
|
|
|
**Výhody:**
|
|
- Najmenšie súbory
|
|
- EXE formát
|
|
- Flexibilné skripty
|
|
|
|
**Nevýhody:**
|
|
- EXE namiesto MSI
|
|
- Samostatný nástroj
|
|
|
|
---
|
|
|
|
## 📊 Rýchle porovnanie
|
|
|
|
| Feature | WiX | VS Installer | Inno Setup |
|
|
|---------|-----|--------------|------------|
|
|
| **Výstup** | MSI | MSI | EXE |
|
|
| **Ready to build** | ✅ Áno | ❌ Nie* | ✅ Áno |
|
|
| **Git-friendly** | ✅ Áno | ❌ Nie | ✅ Áno |
|
|
| **GUI** | ❌ Nie | ✅ Áno | ⚠️ Čiastočný |
|
|
| **Komplexnosť** | Stredná | Ľahká | Ľahká |
|
|
|
|
*Kostra je vytvorená, ale súbory treba pridať cez GUI
|
|
|
|
---
|
|
|
|
## 🔧 Build Tools v projekte
|
|
|
|
- **build-wix.bat** - Build MSI cez WiX Toolset
|
|
- **build-vstudio.bat** - Build aplikácie (príprava pre installer)
|
|
- **build-installer-inno.bat.OLD** - Build EXE cez Inno Setup (odstráňte .OLD)
|
|
|
|
---
|
|
|
|
## 📖 Dokumentácia
|
|
|
|
- **INSTALLER_OPTIONS_COMPARISON.md** - Podrobné porovnanie všetkých 3 možností
|
|
- **VISUAL_STUDIO_INSTALLER_GUIDE.md** - 12-krokový návod pre VS Installer Projects
|
|
- **INSTALLER_README_INNO.md.OLD** - Návod pre Inno Setup
|
|
|
|
---
|
|
|
|
## ❓ Ktorú si vybrať?
|
|
|
|
- **Chcem najrýchlejší štart** → **WiX** (spustite `build-wix.bat`)
|
|
- **Mám otvorené VS 2017** → **VS Installer Projects** (GUI pohodlie)
|
|
- **Chcem najmenšie súbory** → **Inno Setup** (EXE formát)
|
|
|
|
Všetky tri fungujú dobre! Záleží len na vašich preferenciách. 🎉
|