Files
LinedanceAfspiller/linedance-app/BUILD.md
2026-04-15 16:30:03 +02:00

95 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# LineDance Player — Windows Build Guide
## Forudsætninger
Installer følgende på din Windows-maskine:
1. **Python 3.11+**
https://www.python.org/downloads/
✅ Sæt flueben ved "Add Python to PATH"
2. **VLC** (64-bit)
https://www.videolan.org/vlc/
Kræves både til udvikling og til slutbrugere
3. **NSIS 3.x**
https://nsis.sourceforge.io/Download
Bruges til at bygge `.exe` installationsprogrammet
---
## Første gang: Opsæt miljø
```bat
cd linedance-app
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
```
---
## Byg installer
```bat
build.bat
```
Det gør automatisk:
1. PyInstaller → `dist\LineDancePlayer\` (hele programmet)
2. NSIS → `dist\LineDancePlayer-Setup.exe` (installer til brugerne)
Tager 2-5 minutter første gang.
---
## Upload til server
```bat
scp dist\LineDancePlayer-Setup.exe bruger@linedanceplayer.dk:/opt/docker/linedanceafspiller/linedance-api/web/public/download/
```
Filen er tilgængelig på:
`https://linedanceplayer.dk/download/LineDancePlayer-Setup.exe`
---
## Ikoner (valgfrit men anbefalet)
Placer disse filer i `installer\` mappen:
| Fil | Størrelse | Beskrivelse |
|-----|-----------|-------------|
| `icon.ico` | 256×256 | Program-ikon (Windows .ico format) |
| `welcome.bmp` | 164×314 | Velkomst-billede i installer |
| `header.bmp` | 150×57 | Header-billede i installer |
Uden ikoner bygges der med standard NSIS-udseende.
---
## Fejlfinding
**PyInstaller fejler med "module not found"**
Tilføj modulet til `hiddenimports` i `build_windows.spec`
**VLC ikke fundet ved kørsel**
Sørg for at VLC er installeret som 64-bit — samme arkitektur som Python
**NSIS fejler**
Kør `makensis /V4 installer.nsi` for detaljeret output
---
## Versionsnummer
Opdater versionsnummeret i `installer.nsi`:
```nsis
!define APP_VERSION "1.0.1"
```
Og i `app.html` på hjemmesiden:
```html
<div class="version" id="win-version">Version 1.0.1 · 64-bit</div>
```