Differences

This shows you the differences between two versions of the page.

--- rocrailonastick-de [2020/12/23 00:21] – [Windows] rainerk
+++ rocrailonastick-de [2024/03/14 00:33] (current) – rainerk
@@ Line 1: / Line 1: @@
-====== Rocrail ZIP ======
 [[:german|{{  :rocrail-logo-35.png}}]][[:rocrailonastick-de|{{ :icons:de.png}}]][[:rocrailonastick-en|{{ :icons:uk.png}}]] [[:rocrailonastick-fr|{{ :icons:fr.png}}]] [[:rocrailonastick-nl|{{ :icons:nl.png}}]]
+====== Rocrail ZIP ======
   * [[:download-int|Download]] | **[[:rocrailonastick-de|Rocrail ZIP]]** | [[win-changetozip-de|Umstieg auf ZIP-Installer unter Windows]]
+    * [[:defender-exclusion-de|Defender Ausschluss]]
  \\
@@ Line 22: / Line 23: @@
   - Ggf. müssen in den Rocview- und Rocrail-Eigenschaften vorhandene Pfad-Angaben an geänderte Speicherorte angepasst werden.
  \\
+===== Anleitungsvideos =====
+  * [[https://www.youtube.com/embed/Up4niKGJBl8|Niederländisch]]
 ===== Entpacken und Starten =====
+==== macOS ====
+Den richtigen Installer für den eigenen Mac auswählen:
+|< >|
+^ CPU ^ Installer ZIP ^ Hinweis ^
+| Intel | Catalina, Sierra, ElCapitan, Leopard | Das Catalina-Build laüft auch auf neueren macOS-Intel-Versionen. |
+| Apple Silicon M1/M2/M3 | Sonoma |
+  - Doppel-Klick auf die ZIP-Datei um sie zu entpacken.
+  - Die Rocrail.app zum eigenen Anwendungs-Ordner verschieben oder kopieren. ( /Users/<username>/Applications )
+Nach jedem Download sind aus Sicherheitsgründen folgende Schritte notwendig:
+  - Das Rocrail.app-Kontextmenü im Finder und "Öffnen" auswählen.
+  - Auf "Öffen" klicken, nachdem das Popup mit "Sind Sie sicher, dass Sie es öffnen möchten?".
+|  {{:mac:macos-open-rocrail-1.jpg?240}}  |  {{:mac:macos-open-rocrail-2.jpg?240}}  |  {{:mac:macos-open-rocrail-3.jpg?240}}  |
+| Nach Download wird der erste Doppel-Klick blockiert. | Im Finder das Kontext-Menü öffnen und "Öffnen" auswählen. | Bestätigen, um die Anwendung zu öffnen. |
+Alternativ die Security verwenden:\\
+{{:mac:macos-security-openanyway.png?240}}\\
+ \\
 ==== Windows ====
 | Hilfe zum Umstieg von einer klassischen Installation auf die Installation mit einer ZIP-Datei: **[[:win-changetozip-de|Umstieg auf ZIP-Installer]]** Schritt für Schritt erklärt |
@@ Line 31: / Line 56: @@
  \\
 ==== Linux ====
-Werden die Zip-Dateien erstmalig verwendet, muss die Abhängigkeit **wxWidgets** installiert werden. Dies ist in der Befehls-Datei **installwx.sh** enthalten. \\
 Das ZIP-Archiv einfach in das **home**-Verzeichnis entpacken (__nicht in das **system**-Verzeichnis kopieren__) und mit einem Doppelklick die Skriptdatei **desktoplink.sh** aufrufen, die eine Verknüpfung auf dem Desktop einrichtet. \\
   * Hinweis: **[[linux:gnome-zip-de|Rocrail-ZIP-Installieren unter Gnome]]**
+=== Builds ===
+Mit dieser Tabelle prüfen, welcher Build mit der Ziel-Linux-Distribution kompatibel ist:
+|< >|
+^ Build ^ Kompatibel mit ^ Architektur ^
+| Debian 11 | Debian 12, LMDE 5, Mint 20, Manjaro LTS, Ubuntu 20, Ubuntu 22, openSUSE 15 | i386, AMD64, x86_64 |
 === Terminal ===
@@ Line 44: / Line 74: @@
 ./desktoplink.sh
 </code>
+<html><!--
 Wenn die wxWidgets-Bibliothek jetzt noch nicht installiert ist:
 <code>
 ./installwx.sh
 </code>
+--></html>
+===Zugriff Serielle Geräte===
+Benutzer zur Gruppe **''dialout''** hinzufügen: **[[:faq-de#benutzerzugriff_auf_serielle_geraete_linuxx|FAQ]]** \\
 ===Gnome Desktop===
@@ Line 60: / Line 95: @@
 Das Rocview Desktop-Symbol sieht zunächst wie ein Textdokument aus. \\
 Durch Klicken mit der rechten Maustaste auf dieses Symbol das Kontextmenü öffnen und "Allow Launching (Start zulassen)" aktivieren. \\
+ \\
+===Taskleiste===
+Um Rocview im Taskleistenbereich anheften zu können, muss die Datei Rocview.desktop in das Anwendungsverzeichnis kopiert werden:
+<code>
+sudo cp ~/Desktop/Rocview.desktop /usr/share/applications
+</code>
+Im Startmenü nach Rocview suchen und starten. Jetzt kann das Rocrail-Symbol auf der Taskleiste angeheftet werden.\\
+{{:install:cinnemon-rocview-panel.jpg|Cinnamon}}\\
+**Hinweis:** Auf einigen Systemen hat das Desktop-Verzeichnis einen anderen Namen wie //Schreibtisch//. (Abhängig von der ausgewählten Sprache.)\\
  \\
 ====Raspberry Pi====
-Siehe: __**[[:download-int#raspberry_pi|PiOS]]**__ \\
+  * __**[[:raspi:install:rpi-install-de|Grafische Installation für Anfänger.]]**__ (empfohlen)\\
+  * __**[[:download-int#Terminal-Installation|Terminal-Installation für Experten.]]**__ \\
+=== Builds ===
+Mit dieser Tabelle prüfen, welcher Build mit der Ziel-Linux-Distribution kompatibel ist:
+|< >|
+^ Build ^ Kompatibel mit ^ Architektur ^ Hersteller ^
+| PiOS11 | Ubuntu 20, Ubuntu 22, Manjaro, Armbian 22 | ARMHF, ARM64 | Raspberry Pi, Odroid |
  \\
 ===== Update =====
+====macOS====
+  - Aktuelles ZIP-Archiv herunterladen.
+  - Doppel-Klick auf die ZIP-Datei um sie zu entpacken.
+  - Die Rocrail.app zum eigenen Anwendungs-Ordner verschieben oder kopieren. ( /Users/<username>/Applications )
+  - Für Öffnen der Anwendung siehe [[#macos|Entpacken und Starten macOS]]
+ \\
+====Windows====
 **Wichtiger Hinweis:** \\
 Damit ein Update die Dateien nicht überschreibt, die evtl. für eigene Zwecke modifiziert wurden (Bilder, SVG, Decspecs usw.), müssen die Dateien in einem separaten Verzeichnis gespeichert oder die Dateinamen geändert werden.
   - Ein aktuelles ZIP-Archiv herunterladen.
-  - Neues ZIP in den Ordner kopieren oder verschieben, wo sich der Rocrail-Ordner befindet. (nicht in den Rocrail-Ordner!)
+  - Das ZIP-Archiv mit allen Verzeichnissen und Dateien in das Rocrail-Verzeichnis extrahieren.
-  - Alle Dateien extrahieren.
   - Die folgende Abfrage "Dateien im Ziel ersetzen" bestätigen: \\ {{:install:stick-overwrite-de.png?350}}
-==== Erweiterte Update-Option ====
+=== Erweiterte Update-Option ===
-|  Nur für erfahrene Benutzer mit ausreichenden Windows-Kenntnissen!  |
+|< >|
+| :!: Nur für erfahrene Benutzer mit ausreichenden Windows-Kenntnissen  |
   - Ein aktuelles ZIP-Archiv herunterladen.
-  - Neues ZIP in den Ordner kopieren oder verschieben, wo sich der Rocrail-Ordner befindet. (nicht in den Rocrail-Ordner!)
+  - Nur das **bin**-Verzeichnis aus dem ZIP-Archiv in das Rocrail-Verzeichnis extrahieren.\\ //Damit werden nur Rocview, Rocrail-Server und Bibliotheken aktualisiert.//
-  - Nur das **bin**-Verzeichnis extrahieren, damit werden nur Rocview, Rocrail-Server und Bibliotheken aktualisiert.
   - Die folgende Abfrage "Dateien im Ziel ersetzen" bestätigen: \\ {{:install:stick-overwrite-de.png?350}}
-  * **Wichtiger Hinweis:** \\ Da auch Dateien in anderen Verzeichnissen (svg, decpecs, …) unregelmäßig aktualisiert und erweitert werden, wird dringend empfohlen, öfter auch komplette Updates auszuführen.
+  * **Wichtiger Hinweis:** \\ Da auch Dateien in anderen Verzeichnissen (svg, decpecs, …) unregelmäßig aktualisiert und erweitert werden, wird dringend empfohlen, öfter auch **[[#update|komplette Updates]]** auszuführen.
  \\
@@ Line 94: / Line 155: @@
  \\
 ===== Verzeichnisstruktur =====
+====Windows / Linux====
 <code>
 Rocrail
@@ Line 102: / Line 164: @@
 ├───revision-xxxxx.info (Revisions-Nummer und die letzen 500+-Revisionen)
 ├───desktoplink.sh      (Linux   -- Icon auf dem Desktop)
-├───installwx.sh        (Linux   -- wxWidget installieren)
 ├───rocrail.png         (Linux   -- Rocrail-Icon)
 ├───rocview.sh          (Linux   -- Rocview und Server)
 ├───rocrail.sh          (Linux   -- Nur Server)
-├───web                 (Rocweb-System)
+├───startrocrail.sh     (Linux   -- Skript für verwendung mit crontab; Kopieren oder symlink nach ~)
+├───initdefault.sh      (Linux   -- Initialisieren des Standardarbeitsbereichs mit symbolischen Links zu: svg, web, images, decspec)
+├───update.sh           (Linux   -- Rocrail-Update durch Server-Monitor)
+├───sysupdate.sh        (Linux   -- OS-Update durch Server-Monitor)
+├───default             (Standardmäßige leerer Arbeitsbereich im Fall von crontab und/oder Server-Monitor)
+├───web                 (Rocweb-Daten)
 ├───wikidemo            (alternativer Demo-Arbeitsbereich)
 |   └───plan.xml        (Wiki-Demo-Plan)
 ├───demo                (Standard-Demo-Arbeitsbereich)
 |   └───plan.xml        (größerer Plan mit Schattenbahnhof)
-├───bin                 (Client/Server/Bibliotheken - exe u. dll)
+├───bin                 (Ausführbare Dateien und Bibliotheken)
 ├───decspecs            (RocPro-Decoder-Daten)
 ├───stylesheets         (Doku-Formate)
 ├───images              (Bild-/Symbol-Dateien Loks, Wagen, ...)
 └───svg                 (Themen-Verzeichnisse)
-    ├───userthemes.zip
-    ├───americanthemes.zip
     └───themes
         ├───Accessories
+        ├───CTC
         ├───Roads
         ├───SLIM
@@ Line 125: / Line 190: @@
         └───SpDrS60
 </code>
   * **Hinweis:** Die einzelnen **[[http://rocrail.net/software/rocrail-snapshot/|"Rocrail ZIP"-Archive]]** enthalten nur die für das jeweilige Betriebsystem relevanten Teile der obigen Verzeichnisstruktur
+====macOS====
+<code>
+Rocrail.app
+└───Contents
+    ├───_CodeSignature            (Optional code signing with Apple Developer ID)
+    ├───Frameworks                (Libraries *.dylib)
+    ├───MacOS
+    |   ├───Run
+    |   ├───rocrail
+    |   └───rocview
+    ├───Resources
+    |   ├───Rocrail.icns
+    |   ├───data
+    |   |  ├───decspecs            (Rocpro decoder specification)
+    |   |  ├───stylesheets         (Docu formats)
+    |   |  ├───images              (Pictures: Symbols, Locs, Wagon, ...)
+    |   |  ├───web                 (Rocweb data)
+    |   |  └───svg                 (Scalable Vector Graphics)
+    |   |     └───themes
+    |   |        ├───Accessories
+    |   |        ├───CTC
+    |   |        ├───Roads
+    |   |        ├───SLIM
+    |   |        ├───SLIM-COLOR
+    |   |        └───SpDrS60
+    |   └───demo
+    |   |  └───plan.xml
+    |   └───wikidemo
+    |      └───plan.xml
+    └───Info.plist
+</code>
+Der Run-Befehl erzeugt die folgende lokale Verzeichnis-Struktur:
+<code>
+~/rocrail
+├───decspecs
+├───images
+├───stylesheets
+├───svg
+├───web
+├───wikidemo      (Wiki plan)
+└───plan.xml      (Demo plan)
+</code>
+Neuere Dateien in der **''Rocrail.app''** überschreiben die existierenden Dateien im **''~/rocrail''**-Verzeichnis mit Ausnahme der **''~/rocrail/plan.xml''**.\\
+  * Lokale Benutzer-SVGs in eigenem Verzeichnis speichern.
+  * Einen separaten Arbeitsbereich für die eigene **''plan.xml''** verwenden.
+ \\
+=====Fehlerbehebung unter Linux=====
+====Wayland====
+Für den Wayland-Window-Manager gelten folgende Einschränkungen:
+   * Rocview kann seine internen Fenster nicht korrekt wiederherstellen, wenn die Option für die vertikale Werkzeugleiste aktiviert ist.
+   * Das Wiederherstellen von Fenster- und Dialogpositionen ist nicht möglich.
+===Lösung===
+Die Exec-Zeile in der Desktop-Datei ändern auf:
+<code>Exec=env GDK_BACKEND=x11 ....</code>
+====Serieller Gerätezugriff====
+Den Benutzer zur **dialout**-Gruppe hinzufügen; siehe: **[[faq-de#benutzerzugriff_auf_serielle_geraete_linux|Häufige Fragen]]** \\