Fehlende Pakete werden beim Start nachinstalliert

start.pyw prueft beim Laden, ob alle Pakete vorhanden sind. Fehlt eines,
installiert es requirements.txt in die virtuelle Umgebung nach und zeigt
dabei ein Hinweisfenster. Scheitert das, erscheint eine verstaendliche
Meldung, und der Grund landet im Fehlerlog.

Das liegt bewusst in start.pyw und nicht im Update-Helfer: Der Helfer
stammt aus der alten Fassung, start.pyw aus der neuen. So bekommt auch
ein 3.2-Client spaeter neue Abhaengigkeiten wie Pillow fuer die Akte.

Getestet: leere Umgebung wird eingerichtet, kein sichtbares
Konsolenfenster; nicht installierbares Paket fuehrt zu Meldung und Log.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-09-10 17:59:22 +02:00
parent d2513ea0d1
commit 461fc75963
3 changed files with 151 additions and 26 deletions

View file

@ -55,19 +55,18 @@ Kommt das Akten-Update, fehlt Pillow auf jedem Rechner, der per Updater
aktualisiert — das Programm startet dann nicht mehr, oder bestenfalls ohne
Porträts. Deinen Freunden bliebe nur die Neuinstallation.
**Deshalb gehört diese Fähigkeit in die erste veröffentlichte Fassung**,
also vor den Upload von 3.2:
**Umgesetzt in 3.3**, und zwar in `start.pyw` statt im Update-Helfer:
- Der Update-Helfer führt nach dem Kopieren
`.venv\Scripts\python.exe -m pip install -r requirements.txt` aus.
Achtung: Das laufende Programm läuft unter der *echten* `pythonw.exe`
(Übergabe, Erkenntnis 1), `sys.executable` ist also **nicht** der
venv-Interpreter — der Pfad muss aus dem Programmordner gebildet werden.
- Beim Start prüft das Programm, ob alle Pakete da sind, und meldet
fehlende verständlich, statt abzustürzen.
Das ist klein, aber jede Woche, die 3.2 ohne das draußen ist, macht den
späteren Umstieg teurer.
- `start.pyw` wird bei jedem Update ersetzt und danach als Erstes
ausgeführt. Fehlt beim Laden ein Paket, installiert sie
`requirements.txt` in die virtuelle Umgebung nach und zeigt dabei ein
Hinweisfenster. Weil die *neue* `start.pyw` das erledigt, greift es auch
bei Updates von 3.2 aus — deren Update-Helfer weiß davon nichts, muss es
aber auch nicht.
- Der venv-Interpreter wird aus dem Programmordner gebildet:
`sys.executable` ist die *echte* `pythonw.exe` (Übergabe, Erkenntnis 1).
- Scheitert die Nachinstallation, etwa ohne Internet, erscheint eine
verständliche Meldung statt eines stillen Absturzes.
---
@ -147,7 +146,7 @@ Eine Akte ist ein Ordner mit JSON-Datei und Porträt:
| Stufe | Inhalt | Umfang |
|---|---|---|
| **0** | Updater installiert Pakete nach, Startprüfung auf fehlende Pakete — **vor dem Upload von 3.2** | klein |
| **0** | Fehlende Pakete werden beim Start nachinstalliert — **erledigt in 3.3** | klein |
| **1** | `theme.py` auslagern, Hauptreiter *Funk* / *Akte*, Akte noch leer — Version 3.3 | mittel |
| **2** | Akte vollständig: Liste, Formular, Dokumentansicht, Porträt, Vorbelegungen — Version 4.0 | groß |
| **3** | Teilen: Akte als PNG-Karte für Discord, Export/Import als `.akte`-Datei | mittel |

View file

@ -167,6 +167,12 @@ startet einen Hilfsprozess, der nach Programmende die Dateien ersetzt und
neu startet. Nur `https://` wird akzeptiert. Getestet: manipulierte Datei
wird abgelehnt, Dateiersatz funktioniert, `3.9 < 3.10` korrekt.
**Nachinstallation:** `start.pyw` installiert fehlende Pakete aus
`requirements.txt` beim Start nach, mit Hinweisfenster. Das liegt bewusst
dort und nicht im Update-Helfer: Der Helfer stammt aus der *alten*
Fassung, `start.pyw` aus der neuen. So bekommt auch ein 3.2-Client, dessen
Helfer nichts von neuen Paketen weiß, später etwa Pillow für die Akte.
`installer/HOCHLADEN.txt` ist die Server-Anleitung für den Nutzer und wird
beim Bau nach `dist/server/` kopiert. `dist/server/` wird bei jedem Bau
gelöscht — nichts von Hand dort ablegen.
@ -307,10 +313,11 @@ Bildschirme. Wichtig beim Umsetzen: Was in `ttk` nicht geht (runde Ecken,
Schatten, Verläufe), lässt sich auf einer Zeichenfläche nachbauen — die
Pegelanzeige ist bereits so gelöst.
**Server-Upload steht aus.** HTTPS auf `sva.tyrveil.com` läuft, aber
`version.json` und die Release-Dateien waren beim letzten Stand noch nicht
hochgeladen (HTTP 404). Der erste echte Durchlauf des Updaters gegen den
Server ist daher noch ungetestet.
**Update-Test gegen den Server steht aus.** Online liegt die erste 3.2,
noch unter dem alten Namen `SquadVoiceActivation-3.2.*`, und genau die ist
beim Nutzer installiert (über die 3.1 im selben Ordner). Sobald 3.3
hochgeladen ist, muss dort der Hinweisbalken erscheinen und das Update
samt Umbenennung durchlaufen — der erste echte Durchlauf des Updaters.
**Installer unsigniert.** Empfänger sehen beim ersten Start die
SmartScreen-Warnung. Abhilfe nur per Code-Signing-Zertifikat.

137
start.pyw
View file

@ -1,20 +1,32 @@
"""
Startet das Programm ohne Konsolenfenster.
Hintergrund: Die pythonw.exe innerhalb einer virtuellen Umgebung ist nur
ein Weiterleiter, der intern die Konsolenfassung python.exe nachstartet -
dabei erscheint ein Terminalfenster. Die echte pythonw.exe der
Python-Installation hat dieses Verhalten nicht, kennt aber die Pakete der
virtuellen Umgebung nicht.
Die pythonw.exe innerhalb einer virtuellen Umgebung ist nur ein
Weiterleiter, der intern die Konsolenfassung python.exe nachstartet -
dabei erscheint ein Terminalfenster. Deshalb wird diese Datei mit der
echten pythonw.exe der Python-Installation gestartet und haengt die Pakete
der virtuellen Umgebung selbst in den Suchpfad ein.
Diese Datei wird deshalb mit der echten pythonw.exe gestartet und haengt
die Pakete der virtuellen Umgebung selbst in den Suchpfad ein.
Fehlt nach einem Update ein neu hinzugekommenes Paket, wird es hier
nachinstalliert. Das geschieht bewusst in dieser Datei und nicht im
Update-Helfer: Der Helfer stammt aus der alten Fassung, diese Datei aus
der neuen. Sie wird bei jedem Update ersetzt und danach als Erstes
ausgefuehrt - die Nachinstallation greift also auch bei Updates von einer
Fassung aus, die davon noch nichts wusste.
"""
import importlib
import os
import subprocess
import sys
import threading
import time
from pathlib import Path
ORDNER = Path(__file__).resolve().parent
VENV_PYTHON = ORDNER / ".venv" / "Scripts" / "python.exe"
ANFORDERUNGEN = ORDNER / "requirements.txt"
EIGENE_MODULE = {"squad_manager", "theme", "akte"}
for pfad in (ORDNER / ".venv" / "Lib" / "site-packages", ORDNER):
if pfad.is_dir():
@ -23,6 +35,113 @@ for pfad in (ORDNER / ".venv" / "Lib" / "site-packages", ORDNER):
sys.path.remove(eintrag)
sys.path.insert(0, eintrag)
import squad_manager # noqa: E402
squad_manager.main()
def protokollieren(text):
"""Schreibt ins Fehlerlog. squad_manager ist hier ja gerade nicht ladbar."""
try:
ziel = Path(os.getenv("APPDATA", ".")) / "SquadManager" / "error.log"
ziel.parent.mkdir(parents=True, exist_ok=True)
with open(ziel, "a", encoding="utf-8") as datei:
datei.write(f"\n--- {time.strftime('%Y-%m-%d %H:%M:%S')} start.pyw ---\n{text}\n")
except Exception:
pass
def pakete_nachinstallieren(fehlend):
"""Installiert requirements.txt in die virtuelle Umgebung, mit Hinweisfenster."""
if not (VENV_PYTHON.is_file() and ANFORDERUNGEN.is_file()):
return False, "Laufzeitumgebung oder requirements.txt nicht gefunden"
import tkinter as tk
fenster = tk.Tk()
fenster.title("Squad Manager")
fenster.configure(bg="#151814")
fenster.resizable(False, False)
tk.Label(fenster, text="Neue Bestandteile werden eingerichtet ...",
bg="#151814", fg="#c9cec0",
font=("Segoe UI", 11, "bold")).pack(padx=30, pady=(22, 4))
tk.Label(fenster,
text=f"Fehlt: {fehlend}. Das kann je nach Verbindung eine Minute dauern.",
bg="#151814", fg="#7f8874",
font=("Segoe UI", 9)).pack(padx=30, pady=(0, 22))
fenster.update_idletasks()
fenster.eval("tk::PlaceWindow . center")
ergebnis = {}
def arbeit():
try:
lauf = subprocess.run(
[str(VENV_PYTHON), "-m", "pip", "install",
"--disable-pip-version-check", "--quiet", "-r", str(ANFORDERUNGEN)],
capture_output=True, text=True,
creationflags=0x08000000) # kein Konsolenfenster
ergebnis["ok"] = lauf.returncode == 0
ergebnis["meldung"] = (lauf.stderr or lauf.stdout or "")[-1500:]
except Exception as fehler:
ergebnis["ok"] = False
ergebnis["meldung"] = repr(fehler)
faden = threading.Thread(target=arbeit, daemon=True)
faden.start()
def warten():
if faden.is_alive():
fenster.after(200, warten)
else:
fenster.destroy()
fenster.after(200, warten)
fenster.mainloop()
return ergebnis.get("ok", False), ergebnis.get("meldung", "")
def fehlschlag_melden(fehlend):
import tkinter as tk
from tkinter import messagebox
wurzel = tk.Tk()
wurzel.withdraw()
messagebox.showerror(
"Squad Manager",
f"Für diese Version fehlt der Bestandteil „{fehlend}“, und er konnte "
"nicht automatisch geladen werden.\n\n"
"Bitte die Internetverbindung prüfen und das Programm erneut "
"starten. Hilft das nicht, im Programmordner Fehlersuche.bat "
"ausführen.")
wurzel.destroy()
def programm_laden():
"""Importiert das Hauptprogramm, bei fehlenden Paketen nach Nachinstallation."""
try:
import squad_manager
return squad_manager
except ModuleNotFoundError as fehler:
fehlend = fehler.name
if not fehlend or fehlend.split(".")[0] in EIGENE_MODULE:
raise
ok, meldung = pakete_nachinstallieren(fehlend)
if not ok:
protokollieren(f"Nachinstallation fuer {fehlend} gescheitert:\n{meldung}")
fehlschlag_melden(fehlend)
return None
for name in list(sys.modules):
if name.split(".")[0] in EIGENE_MODULE:
sys.modules.pop(name, None)
importlib.invalidate_caches()
try:
import squad_manager
return squad_manager
except ModuleNotFoundError as fehler:
protokollieren(f"Nach der Nachinstallation fehlt weiterhin {fehler.name}")
fehlschlag_melden(fehler.name or fehlend)
return None
programm = programm_laden()
if programm is not None:
programm.main()