153 lines
2.5 KiB
Markdown
153 lines
2.5 KiB
Markdown
# 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
|
|
```
|
|
|
|
Optional per CI:
|
|
- Workflow: `.gitea/workflows/build-standalone-release.yml`
|
|
- Trigger: Tag-Push `v*`
|
|
- Ergebnis: Plattform-Artefakte als CI-Artefakte
|
|
|
|
---
|
|
|
|
## 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
|
|
```
|