commit fc0a7f6d029f7dd89beec9ea60d02810e93375f7 Author: Per Hoener Date: Mon Oct 26 19:06:12 2026 +0100 first commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..50966c0 --- /dev/null +++ b/README.md @@ -0,0 +1,86 @@ +# Siemens LOGO! Soft Comfort V8.4.x – macOS Installer + +Reproduzierbarer **lokaler Installer** für die aus dem Installationsmedium bereits entpackte Anwendung **LOGO! Soft Comfort V8.4.1**. Er wurde aus einem auf Apple Silicon erfolgreich erprobten Ablauf abgeleitet: **Intel-Java 11 + Rosetta 2**, komplette `Mac/Application`-Struktur und eigener macOS-Starter. + +**Wichtig:** Dieses Repository enthält **keine Siemens-Programmdateien**, keine Lizenz und keinen Download der Siemens-Software. Für die Installation muss der **vollständige Originalordner `LOGOCOMFORT`** aus einer berechtigten, vertrauenswürdigen Quelle separat lokal verfügbar sein. Es wird nicht der ältere, fehleranfällige `start.command`- oder `Setup.app`-Installer aufgerufen. Unterstützung unter neueren macOS-Versionen ist nicht garantiert. + +## Ordneraufbau + +```text +Downloads/ +├── LOGOCOMFORT/ # separat vom eigenen Server heruntergeladen +│ └── Mac/ +│ └── Application/ +│ ├── LOGOComfort.app +│ └── lib/ +└── logo-soft-comfort-macos/ # dieses Gitea-Repository + ├── install.sh + ├── install.command + ├── check.sh + ├── uninstall.sh + └── README.md +``` + +Die übrigen Dateien im originalen `LOGOCOMFORT`-Ordner dürfen bleiben; der Installer benötigt für die Direktinstallation nur `Mac/Application` inklusive aller zugehörigen Ressourcen und Unterordner. + +## Installation – lokal, mit einem Befehl + +1. Das Repository aus Gitea herunterladen/klonen. +2. Den vollständigen **`LOGOCOMFORT`-Ordner** vom eigenen Server lokal herunterladen/entpacken, etwa nach `~/Downloads/LOGOCOMFORT`. +3. Terminal öffnen und aus dem Repository heraus ausführen: + +```bash +cd "$HOME/Downloads/logo-soft-comfort-macos" +bash install.sh "$HOME/Downloads/LOGOCOMFORT" +``` + +Alternativ `install.command` per Doppelklick starten, sofern der `LOGOCOMFORT`-Ordner neben dem Repository oder in `~/Downloads` liegt und macOS die lokale Skriptdatei ausführt. + +Bei fehlendem Rosetta 2 oder Java 11 **(Intel/x86_64)** fragt der Installer ausdrücklich nach, ob die Komponenten installiert werden sollen. Für Java 11 verwendet er den **offiziellen Amazon-Corretto-Download**, prüft den SHA-256-Hash und die macOS-Paketsignatur und ruft danach den macOS-Paketinstaller auf. Für notwendige Systemänderungen ist ein Administratorpasswort erforderlich. Bereits vorhandenes Java 27 wird **nicht verändert**. + +**Offizieller Java-11-Download (Intel x64):** +https://corretto.aws/downloads/latest/amazon-corretto-11-x64-macos-jdk.pkg + +### Installationsergebnis + +- Programmdateien unter `~/Applications/LOGOComfort/` +- Starter unter `/Applications/LOGO! Soft Comfort starten.app` +- Startskript unter `~/Applications/LOGOComfort/launch-logo.sh` +- Startprotokoll unter `~/Library/Logs/LOGOComfort.log` + +**Den Starter** (nicht die originale `LOGOComfort.app`) aus `/Applications` ins Dock ziehen. Er setzt bei jedem Start automatisch `JAVA_HOME` auf ein installiertes Java 11 für Intel und `JAVA_VERSION=11`. + +## Prüfung + +```bash +bash check.sh +``` + +Das Skript prüft Dateien, Bibliotheken, Java 11, Rosetta/Intel-Ausführung und den Starter. Den **tatsächlichen GUI-Start** danach per Doppelklick kontrollieren. Bei Problemen das Log `~/Library/Logs/LOGOComfort.log` auswerten. + +## Erneute Installation oder Aktualisierung + +Standardmäßig werden vorhandene funktionierende Programmdateien **nicht überschrieben**. Um sie bewusst aus einer neuen lokalen Quelle zu ersetzen: + +```bash +bash install.sh "$HOME/Downloads/LOGOCOMFORT" --replace +``` + +Eine vorhandene Installation wird vorher als `~/Applications/LOGOComfort.backup.JJJJMMTT-HHMMSS` gesichert. Das Backup wird **nicht automatisch gelöscht**. + +## Deinstallation + +```bash +bash uninstall.sh +``` + +Entfernt nach ausdrücklicher Bestätigung nur die selbst installierten LOGO-Programmdateien und den Starter. **Java 11, Rosetta 2, Projektdateien und der lokale Siemens-Installationsordner** bleiben erhalten. + +## Sicherheit / Hinweise + +- Die Quellsoftware muss aus einer **vertrauenswürdigen und lizenzrechtlich zulässigen** Siemens-Quelle kommen. Der Installer entfernt beim Kopieren bestimmte macOS-Metadaten (`ditto --norsrc`), wie beim funktionierenden manuellen Ablauf. Dadurch kann sich die Gatekeeper-Prüfung anders verhalten. Herkunft und Integrität der Siemens-Dateien vorher prüfen. +- Der generierte AppleScript-Starter wird lokal ad-hoc-signiert; dies ist **keine Siemens-Signatur**. +- Das Repository `.gitignore` schließt `LOGOCOMFORT/` aus, um versehentliche Veröffentlichung der proprietären Installationsdateien zu vermeiden. Vor dem Push `git status` prüfen, besonders bei umbenannten Siemens-Ordnern. +- `--replace` nicht verwenden, solange LOGO! läuft. +- Die Java-11-Installer-URL zeigt auf die aktuelle gepatchte **11.x**-Version; ein späteres Herstellerupdate kann das Verhalten ändern. +- Die Netzwerkanbindung zur LOGO!-Hardware sowie Benutzerberechtigungen müssen nach der Installation separat geprüft werden.