first commit
This commit is contained in:
@@ -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.
|
||||||
Reference in New Issue
Block a user