Differences

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

--- rocrailonastick-de [2020/05/03 12:18] – [Einführung] 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}}]]
-  * [[:download-int|Download]] | **[[:rocrailonastick-de|Rocrail ZIP]]**
+====== Rocrail ZIP ======
+  * [[:download-int|Download]] | **[[:rocrailonastick-de|Rocrail ZIP]]** | [[win-changetozip-de|Umstieg auf ZIP-Installer unter Windows]]
+    * [[:defender-exclusion-de|Defender Ausschluss]]
  \\
@@ Line 9: / Line 10: @@
 ===== Einführung =====
 //**Rocrail ZIP**// wird als ZIP-Archiv bereitgestellt und kann von der __**[[https://wiki.rocrail.net/rocrail-snapshot/|Daily Build]]**__-Website heruntergeladen werden.\\
-Im Abschnitt **Rocrail ZIP** der Webseite werden täglich aktualisiert drei unterschiedliche ZIP-Archive bereitgestellt:
-  - **''Rocrail-ARMHF.zip''** für Linux
-  - **''Rocrail-WIN32.zip''** als 32bit-Version für Windows
-  - **''Rocrail-WIN64.zip''** als 64bit-Version für Windows
 Rocrail ZIP ermöglicht die "Installation" **((Rocrail ZIP wird nicht im eigentlichen Sinne installiert, sondern lediglich entpackt))** an (fast) jedem beliebigen Ort auf dem Computer: Beispielsweise auf dem Desktop, auf einem zweiten internen Laufwerk usw. Alle von Rocrail benötigten Dateien sind dabei in einem Ordner zusammengefasst, es gibt keine außerhalb dieses Ordners angelegten oder versteckten Dateien (mit Ausnahme des optionalen Desktop-Symbols).
@@ Line 26: / 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 ====
-Das ZIP-Archiv einfach in ein Verzeichnis der Wahl entpacken und mit Doppelklick auf die Skriptdatei **rocview.cmd** Rocview starten. Einen Arbeitsbereich auswählen, um den Rocrail-Server zu starten.
+| 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 |
+Das ZIP-Archiv einfach in ein Verzeichnis der Wahl entpacken und mit Doppelklick auf die Skriptdatei **desktoplink.cmd ((Abhängig von der Windows-Installation wird das **''.cmd''** nicht angezeigt. Siehe: **[[faq-de#windows|Häufige Fragen]]**))** eine Verknüpfung von Rocview auf dem Desktop anlegen. Rocview durch Doppelklick auf das Desktop-Symbol starten. Einen Arbeitsbereich auswählen, um den Rocrail-Server zu starten.
-Beim ersten Start kann eine Sicherheitswarnung des Defenders ausgegeben werden (**{{win:win-defender-de.png?linkonly|Bildschirmfoto}}**). Hier ist zunächst der Text //Weitere Informationen// anzuklicken und danach im erweiterten Dialog (**{{win:win-defender2-de.png?linkonly|Bilschirmfoto}}**) die Schaltfläche //Trotzdem ausführen//.
+Eine ausführliche Installationsanleitung findet sich unter **[[:win-de|Rocrail unter Windows installieren]]**
-Um die zukünftige Verwendung zu vereinfachen, durch Doppelklick auf **desktoplink.cmd** eine Verknüpfung auf dem Desktop einrichten.
+ \\
 ==== 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. \\
-Das ZIP-Archiv einfach in das **home**-Verzeichnis entpacken (__nicht in das **system**-Verzeichnis kopieren__) und mit einem Doppelklick die Skriptdatei **rocview.sh** aufrufen, was Rocview mit den erforderlichen Befehlszeilen-Optionen startet. Nachdem Rocview läuft kann ein Arbeitsbereich aktiviert werden.\\
-Wenn nur der Server gestartet werden soll, dann den Befehl **"bin/rocrail -l bin"** verwenden. Dieser Befehl ist in **rocrail.sh** enthalten.\\
-Um die zukünftige Verwendung zu vereinfachen, durch Doppelklick auf **desktoplink.sh** eine Verknüpfung auf dem Desktop einrichten. \\
   * 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 49: / 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===
+Wenn das Rocview Desktop-Symbol nicht angezeigt wird, ist eine Erweiterung erforderlich. \\
+Dazu ein Terminalfenster öffnen und die folgenden Befehle eingeben:
+<code>
+sudo apt install gnome-tweaks
+sudo apt install gnome-shell-extension-desktop-icons
+gnome-tweaks
+</code>
+Nach dem Öffnen von Gnome Tweaks in der linken Spalte "Extensions (Erweiterungen)" auswählen und "Desktop icons (Desktop-Symbole)" aktivieren. \\
+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====
+  * __**[[: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  |
   - 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 83: / Line 155: @@
  \\
 ===== Verzeichnisstruktur =====
+====Windows / Linux====
 <code>
 Rocrail
@@ Line 88: / Line 161: @@
 ├───rocview.cmd         (Windows -- Rocview und Server)
 ├───readme.txt          (Informationen)
+├───start.html          (Start-Hilfe mit Links zu den stepbystep-xx-Wiki-Seiten)
 ├───revision-xxxxx.info (Revisions-Nummer und die letzen 500+-Revisionen)
 ├───desktoplink.sh      (Linux   -- Icon auf dem Desktop)
-├───installwx.sh        (Linux   -- wxWidget installieren)
-├───rocctrl.png         (Linux   -- Rocrail-Server-Icon)
 ├───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 114: / 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]]** \\