Files
logo-soft-comfort-macos/README.md
T
2026-10-26 19:06:12 +01:00

87 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.