33 lines
3.6 KiB
Markdown
33 lines
3.6 KiB
Markdown
|
# BLOCKLINE Installer
|
||
|
|
|
||
|
|
## Pakete und Bedienung
|
||
|
|
- `dist/BLOCKLINE-Setup.exe`: eigenständiger Windows-x64-Installer mit eingebetteten Spieldateien, dunkler Oberfläche, Ordnerauswahl und optionalem Desktop-Link. Nach der Installation startet **Jetzt spielen** die installierte Spielversion.
|
||
|
|
- `dist/BLOCKLINE-Mac.zip`: entpacken, `Install-Mac.command` öffnen. Native macOS-Dialoge begleiten die Installation; Download und Import erscheinen im Terminal. Fertige App: `~/Applications/BLOCKLINE.app`. Alternativ `Start-Game.command` für portablen Start.
|
||
|
|
|
||
|
|
Beide Pakete laden Godot 4.5 stable von godotengine/godot-builds auf GitHub, prüfen eine fest hinterlegte SHA-512-Prüfsumme, entpacken und importieren Ressourcen. Spieler benötigen kein Python, kein vorinstalliertes Godot und kein Konto. Anschließend offline spielbar. Windows-Ziel: Windows 10/11 x64 mit .NET Framework; Mac-Ziel: macOS 11+, Intel/Apple Silicon, Compatibility-Renderer.
|
||
|
|
|
||
|
|
## Offline
|
||
|
|
Originale `Godot_v4.5-stable_win64.exe.zip` neben Setup.exe bzw. `Godot_v4.5-stable_macos.universal.zip` neben Install-Mac.command legen. Nicht vorher entpacken; dieselbe Prüfsumme wird kontrolliert.
|
||
|
|
|
||
|
|
Offizielle Downloads: https://godotengine.org/download/archive/4.5-stable/ . Godot-Lizenz: https://godotengine.org/license/ . Lizenztexte und Asset-Credits liegen den Paketen bei.
|
||
|
|
|
||
|
|
## Build
|
||
|
|
`./installer/Build-Installers.ps1 -Python python`
|
||
|
|
|
||
|
|
Benötigt Windows, Python 3 und den .NET-Framework-C#-Compiler. Paketinhalt stammt aus dem aktuellen Arbeitsordner. Engine, Git-Historie und Caches werden nicht verpackt. `dist/` ist ignoriert: Installer als Release-Dateien weitergeben, nicht per git add -f einchecken. BUILD-INFO.json dokumentiert Dateihashes.
|
||
|
|
|
||
|
|
## Implementierung
|
||
|
|
Vollständiger Code: Setup.cs (UI, Installation), EngineBootstrap.cs (Download, SHA-512, Entpacken), package.py (Payload/ZIP und Unix-Dateirechte), macos/engine.sh, install.sh, launch.sh, app-launch.sh sowie Info.plist. Der vorhandene Windows-Starter nutzt EngineBootstrap ebenfalls; --offline und --verify laden nichts herunter.
|
||
|
|
|
||
|
|
## Wartung und Grenzen
|
||
|
|
Ohne Administratorrechte. Vorhandene Ziele werden nicht überschrieben: anderen Ordner wählen oder alte Mac-App im Finder umbenennen. Windows aktiviert erst nach erfolgreichem Import das Ziel. Mac-Stagingdateien bleiben bei Fehlern zur Diagnose erhalten. Persönliche Einstellungen bleiben in Godots Benutzerverzeichnis.
|
||
|
|
|
||
|
|
Setup und Mac-App sind nicht signiert/notarisiert. SmartScreen bzw. Gatekeeper kann Benutzerbestätigung verlangen. Keine Sicherheitseinstellungen oder Quarantäneattribute werden automatisch deaktiviert. Öffentliche Mac-Verteilung mit Signatur/Notarisierung benötigt einen Mac und ein Apple-Developer-Zertifikat. Deinstallation: Spiel beenden, Installationsordner/App und Desktop-Link entfernen; persönliche Einstellungen bleiben erhalten.
|
||
|
|
|
||
|
|
## Prüfstand
|
||
|
|
Windows-Setup gebaut und grafisch geprüft. Offizielle Windows-/Mac-Archive tatsächlich heruntergeladen und gegen offizielle SHA-512-Werte geprüft. Installation ohne vorhandene Engine aus lokalem Originalarchiv einschließlich Import bestanden; installierter Starter mit --local --verify bestanden.
|
||
|
|
|
||
|
|
Direkter .NET-Download scheitert in dieser eingeschränkten Testumgebung an Schannel-Anmeldeinformationen; kein behaupteter erfolgreicher Online-End-to-End-Test. Mac-Shell-Syntax, plist, Archiv-Dateirechte, Inhalt und Universal-Binary geprüft. **Echter Mac-Installations-, Grafik- und LAN-Test steht aus.**
|
||
|
|
|
||
|
|
Manuell: Neuinstallation, Downloadabbruch und Wiederholung, falsches Offlinearchiv, Start ohne Internet, Pfad mit Leerzeichen, Windows/Mac-LAN testen. Spielversionen im LAN müssen übereinstimmen.
|