Add standalone build and packaging workflow docs/scripts

BUILD_STANDALONE.md

@@ -0,0 +1,147 @@
+# Standalone Builds (Linux, macOS, Windows)
+
+Diese Anleitung erstellt eigenständige Anwendungen mit **PyInstaller** auf dem jeweiligen Zielbetriebssystem.
+
+## Wichtig
+
+- Builds müssen **nativ pro OS** erstellt werden (kein Cross-Compile mit diesen Skripten).
+- Verwenden Sie eine aktive und funktionierende `.venv` im Projektordner.
+- Die GUI wird aus `gui_wxpython.py` gebaut.
+
+---
+
+## Release auf einen Blick
+
+### Linux
+
+```bash
+./build/build_linux.sh
+./build/package_linux.sh
+```
+
+### macOS
+
+```bash
+./build/build_macos.sh
+./build/package_macos.sh
+```
+
+### Windows
+
+```cmd
+build\build_windows.cmd
+build\package_windows.cmd
+```
+
+---
+
+## Empfohlene Release-Reihenfolge
+
+1. Version erhöhen (z. B. `version.txt` und Changelog)
+2. Pro Zielplattform Build + Packaging ausführen
+3. Artefakte im `release/`-Ordner prüfen
+4. Git-Commit erstellen und Tag setzen (z. B. `v1.2.0`)
+5. Tag und Branch pushen
+6. Release-Artefakte auf der Release-Seite hochladen
+
+Beispiel Git-Workflow:
+
+```bash
+git add -A
+git commit -m "Release x.y.z"
+git tag -a vx.y.z -m "vx.y.z"
+git push origin main
+git push origin vx.y.z
+```
+
+---
+
+## Linux
+
+```bash
+chmod +x build/build_linux.sh
+./build/build_linux.sh
+```
+
+Ergebnis:
+- `dist/PDFtoICS/` (Ordner mit ausführbarer Datei)
+
+Optional als Release-Archiv (`.tar.gz`) verpacken:
+
+```bash
+chmod +x build/package_linux.sh
+./build/package_linux.sh
+```
+
+Ergebnis:
+- `release/PDFtoICS-linux-v<VERSION>.tar.gz`
+
+---
+
+## macOS
+
+```bash
+chmod +x build/build_macos.sh
+./build/build_macos.sh
+```
+
+Ergebnis:
+- `dist/PDFtoICS.app`
+
+Hinweis:
+- Für öffentliche Verteilung ist Code-Signing/Notarisierung empfohlen.
+
+Optional als Release-Archiv (`.zip`) verpacken:
+
+```bash
+chmod +x build/package_macos.sh
+./build/package_macos.sh
+```
+
+Ergebnis:
+- `release/PDFtoICS-macos-v<VERSION>.zip`
+
+---
+
+## Windows
+
+Starten Sie unter Windows:
+
+```cmd
+build\build_windows.cmd
+```
+
+Ergebnis:
+- `dist\PDFtoICS\PDFtoICS.exe`
+
+Hinweis:
+- Für weniger SmartScreen-Warnungen ist Signierung empfohlen.
+
+Optional als Release-Archiv (`.zip`) verpacken:
+
+```cmd
+build\package_windows.cmd
+```
+
+Ergebnis:
+- `release\PDFtoICS-windows-v<VERSION>.zip`
+
+---
+
+## Clean Build
+
+PyInstaller erstellt `build/` und `dist/` sowie eine `.spec` Datei im Projektverzeichnis.
+
+Optionales Aufräumen:
+
+```bash
+rm -rf build dist *.spec
+```
+
+Unter Windows:
+
+```cmd
+rmdir /s /q build
+rmdir /s /q dist
+del /q *.spec
+```