first commit

This commit is contained in:
Per Hoener
2026-10-26 19:06:12 +01:00
commit fc0a7f6d02
+86
View File
@@ -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.