PumpgunStudios
Dokumentation
Zurück zu den Funktionen
Funktion

Updater und Installationsprogramm

Das Installationsprogramm ermöglicht eine übliche Einrichtung unter Windows, ohne dass Python eingerichtet werden muss.

Installationsprogramm

Das Installationsprogramm installiert die App, optionale Verknüpfungen, einen optionalen Autostart-Eintrag und die Windows-Deinstallationseinträge.

Updater

Der Updater prüft das offizielle GitHub-Repository, zeigt Versionshinweise an, öffnet die Release-Seite und verlangt die separate AmazonMusicRPC_Setup.exe.sha256 -Datei vor der automatischen Installation. Weiterleitungs-Hosts, Asset-Namen, Dateigrößen und der Hash der heruntergeladenen Datei werden geprüft.

Offizielle Builds

Offizielle Artefakte werden nur über einen manuell gestarteten GitHub-Actions-Workflow aus dem aktuellen Release-Branch erstellt. Vor dem Anlegen eines unveröffentlichten Entwurfs zur Prüfung durch die Projektverantwortlichen laufen Tests, eine Prüfung der Abhängigkeiten, ein sauberer eingefrorener Build, kurze Installationsprüfungen, sofern verfügbar ein Defender-Scan sowie die Erstellung einer SBOM und Herkunftsnachweise.

Aus dem Quellcode erstellen

Quellcode, Abhängigkeiten, Symbole und Paketdateien der Windows-App liegen im Repository-Ordner Windows/ Installiere die Abhängigkeiten im Stammverzeichnis des Repositorys und starte die App aus dem Quellcode mit:

pip install -r Windows/requirements.txt

python Windows/main.py

Erstelle die ausführbare Datei mit:

pyinstaller Windows/AmazonMusicRPC.spec --noconfirm --workpath Windows/build --distpath Windows/dist

Erstelle das Installationsprogramm mit Inno Setup:

"%LOCALAPPDATA%\Programs\Inno Setup 6\ISCC.exe" Windows\installer.iss

Das Installationsprogramm wird hier abgelegt: Windows/installer_output/AmazonMusicRPC_Setup.exe . Das Hilfsskript Windows\build.bat führt beide Schritte aus.

Installationsprogramm überprüfen

Führe diesen Befehl in PowerShell aus und vergleiche das Ergebnis mit der passenden AmazonMusicRPC_Setup.exe.sha256 Release-Datei:

Get-FileHash .\AmazonMusicRPC_Setup.exe -Algorithm SHA256

Deinstallation

Bei der Deinstallation entfernt das Installationsprogramm installierte Dateien, Autostart-Einträge, Protokolle, Konfigurationsdaten und Verknüpfungen zum Amazon-Music-Metadatenstarter.

Hinweise zu SmartScreen

Windows kann eine Warnung anzeigen, da das Installationsprogramm nicht signiert ist. Lade es nur von der GitHub-Release-Seite herunter und prüfe nach Möglichkeit die Hashes.