Installation
Wählen Sie die passende Installationsmethode. Die Links in der Tabelle führen zum jeweiligen Abschnitt dieser Seite.
Paket auswählen
| Betriebssystem | Installationsmethode | Simulationsengine |
|---|---|---|
| Apple Silicon · macOS 27 oder neuer | DMG installieren · Mit Homebrew installieren | ROS 2 und Gazebo nativ · Metal |
| Ubuntu 26.04 · x86-64 | APT-Paketquelle · DEB installieren | Linux-Engine in Docker |
| Windows · x86-64 | Unter Windows installieren | Docker Desktop · WSL2 |
Unter Windows installieren
WSL2 einrichten
Falls WSL noch fehlt, öffnen Sie Terminal oder PowerShell über das Startmenü als Administrator:
wsl --install --no-distribution
Starten Sie den Rechner neu, wenn Sie dazu aufgefordert werden. Führen Sie anschließend in einem neuen Terminal Folgendes aus:
wsl --update
wsl --set-default-version 2
wsl --status
Die Standardversion muss 2 sein. Bei Virtualisierungsfehlern prüfen Sie die Firmware-Einstellungen und die WSL-Installationsanleitung von Microsoft. Docker Desktop verwendet eine eigene WSL2-Umgebung. Eine zusätzliche Ubuntu-Distribution benötigen Sie nur, wenn Sie eine separate ROS-Umgebung einrichten möchten.
Docker Desktop und die App installieren
- Installieren Sie Docker Desktop mit dem WSL2-Backend. Starten Sie Windows bei Bedarf neu.
- Öffnen Sie Docker Desktop und warten Sie, bis die Engine läuft.
- Laden Sie das Windows-Installationsprogramm herunter und folgen Sie den Anweisungen. Bei Der Computer wurde durch Windows geschützt wählen Sie für den offiziellen Download Weitere Informationen → Trotzdem ausführen. Dieses Paket besitzt keine Authenticode-Signatur; die veröffentlichten SHA-256-Prüfsummen kennzeichnen die Datei.
- Öffnen Sie WWW-POSIM im Startmenü. Bestätigen Sie gegebenenfalls dieselbe Warnung erneut. Melden Sie sich an und wählen Sie Simulator starten.
- Der lokale Simulator öffnet sich im Browser. Lesen Sie Den Arbeitsbereich kennenlernen.
Lassen Sie Docker Desktop während der Nutzung geöffnet. Die App lädt automatisch die Images herunter, die zu ihrer Version passen.
DMG installieren
Sie benötigen einen Mac mit Apple Silicon und macOS 27 oder neuer. Prüfen Sie Modell und Version unter Apple-Menü → Über diesen Mac.
- Laden Sie das Mac-DMG herunter.
- Öffnen Sie es und ziehen Sie WWW-POSIM nach Programme.
- Versuchen Sie, die App zu öffnen. Sie besitzt eine Ad-hoc-Signatur und ist nicht von Apple notarisiert.
- Falls macOS den ersten Start blockiert, öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Sicherheit. Wählen Sie neben WWW-POSIM Dennoch öffnen, bestätigen Sie Öffnen und authentifizieren Sie sich bei Bedarf. Siehe Apples Anleitung.
- Melden Sie sich an und wählen Sie Simulator starten. Beim ersten Start werden die Engine-Dateien heruntergeladen, geprüft und entpackt. Das Fenster zeigt den Fortschritt.
- Fahren Sie im Browser mit Den Arbeitsbereich kennenlernen fort.
Unterbrochene Downloads lassen sich fortsetzen. Die Dateien sind in Teile von 512 MiB aufgeteilt; jedes Installationspaket und jeder Teil bleibt unter 2 GiB. ROS-Umgebung und Engine werden außerhalb der App zwischengespeichert. Die native Engine verwendet die GPU über Metal.
Bei Startproblemen hilft Mac-Start wiederherstellen.
Mit Homebrew installieren
Falls Homebrew noch fehlt, folgen Sie zuerst der offiziellen Installation. Installieren Sie dann dieselbe App mit:
brew tap ioes-lab/www-posim
brew trust --cask ioes-lab/www-posim/www-posim
brew install --cask ioes-lab/www-posim/www-posim
brew trust --cask erlaubt das Laden des Casks dieser App aus der angegebenen Paketquelle. Siehe Tap Trust.
Fordert Homebrew packages.arm64_dunno.jws.json an und erhält HTTP 404, erkennt seine Versionstabelle macOS 27 nicht. Aktualisieren Sie Homebrew ohne Paket-API und wiederholen Sie die Installation:
HOMEBREW_NO_INSTALL_FROM_API=1 brew update
HOMEBREW_NO_AUTO_UPDATE=1 brew tap ioes-lab/www-posim
HOMEBREW_NO_AUTO_UPDATE=1 brew trust --cask ioes-lab/www-posim/www-posim
HOMEBREW_NO_AUTO_UPDATE=1 brew install --cask ioes-lab/www-posim/www-posim
Diese Umgebungsvariablen gelten jeweils nur für den nachfolgenden Befehl. Siehe Homebrews Umgebungsoptionen. Falls das Problem bleibt, verwenden Sie DMG installieren.
Öffnen Sie WWW-POSIM mit demselben Konto wie auf der Website. Der Kontoserver wird automatisch verbunden. Beim ersten Start werden die geprüften Engine-Dateien nach Library entpackt. Die Anzeige nennt entpackte Größe, Fortschritt, geschätzte Restzeit und anschließend den Dienststart. Gazebo, ROS 2 und Autopilot laufen auf dem Mac. Ein Updatehinweis unterbricht keine laufende Simulation.
So laden Sie die mitgelieferte Umgebung in ein vorhandenes Terminal:
eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"
Die App enthält den Konnektor, die Standard-ROS-Nachrichten und RViz2. ROS-Terminal öffnen und RViz öffnen verwenden diese Umgebung. Zusätzliche Abhängigkeiten Ihres Algorithmus installieren Sie in einer kompatiblen Umgebung. Siehe ROS-Terminals und Verbindung und Einen lokalen Arbeitsbereich steuern.
Docker unter Ubuntu vorbereiten
Installieren Sie Docker und curl. Melden Sie sich nach dem Hinzufügen Ihres Kontos zur Docker-Gruppe bei Ubuntu ab und wieder an.
sudo apt update
sudo apt install -y docker.io curl
sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"
APT-Paketquelle
Führen Sie Docker unter Ubuntu vorbereiten aus. Binden Sie anschließend die signierte APT-Paketquelle ein und installieren Sie die App:
SERVER=https://www-posim.vercel.app
curl -fSL "$SERVER/guide/packages/apt/www-posim-archive-keyring.gpg" | \
sudo tee /usr/share/keyrings/www-posim-archive-keyring.gpg >/dev/null
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/www-posim-archive-keyring.gpg] $SERVER/guide/packages/apt stable main" | \
sudo tee /etc/apt/sources.list.d/www-posim.list
sudo apt update
sudo apt install www-posim
www-posim
Die App wählt die Engine-Images passend zu ihrer Version. Ihr Konto benötigt Zugriff auf Docker. GPU-Rendering setzt außerdem kompatible Treiber und eine geeignete Container-Laufzeit voraus.
DEB installieren
Das Paket ist für Ubuntu 26.04 auf x86-64-Rechnern vorgesehen. Öffnen Sie mit Strg+Alt+T ein Terminal:
sudo apt update
sudo apt install -y docker.io curl
sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"
mkdir -p ~/Downloads
cd ~/Downloads
curl -fL -o www-posim.deb https://www-posim.vercel.app/guide/packages/latest/linux-amd64.deb
sudo apt install ./www-posim.deb
- Geben Sie bei der
sudo-Abfrage Ihr Passwort ein. Während der Eingabe erscheinen keine Zeichen. - Melden Sie sich bei Ubuntu ab und wieder an, damit Ihr Docker-Zugriff wirksam wird.
- Öffnen Sie WWW-POSIM im Anwendungsmenü oder führen Sie
www-posimaus. - Melden Sie sich an, wählen Sie Simulator starten und folgen Sie Den Arbeitsbereich kennenlernen.
Benötigt Docker Ubuntu 26.04?
Docker Engine unterstützt auch Ubuntu 24.04 und 22.04. Ubuntu und ROS im Container müssen nicht dieselbe Version wie auf dem Host haben. Das veröffentlichte WWW-POSIM-DEB und das Installationsskript sind jedoch auf Ubuntu 26.04 ausgelegt; auch der Launcher benötigt passende Systembibliotheken des Hosts. Dieses DEB wird daher unter 26.04 unterstützt. Docker-Unterstützung für einen älteren Host belegt keine Kompatibilität des WWW-POSIM-Installers. Siehe von Docker unterstützte Ubuntu-Versionen.
Konto bestätigen und beginnen
Registrieren Sie sich auf Installation, öffnen Sie die Bestätigungsnachricht und wählen Sie E-Mail bestätigen. Prüfen Sie gegebenenfalls den Spamordner. Nach bestätigter Anmeldung kann die App das Passwort im Anmeldedatenspeicher des Betriebssystems hinterlegen.
Für Anmeldung und regelmäßige Erneuerung der Nutzungsberechtigung ist Internetzugang nötig. Planen Sie Platz für Engine, Gelände und Modelle ein. Das Speicherlimit Ihres Kontos und der freie Speicherplatz auf Ihrem Rechner sind getrennte Größen. Siehe Konten und Sitzungsdauer.
Python-Projekt erstellen ergänzt Beispiele im gespeicherten Arbeitsordner, anfangs Documents/WWW-POSIM. ROS-Terminal öffnen, Arbeitsordner öffnen und In VS Code öffnen nutzen diesen Ordner. VS Code öffnet ros_vehicle_command.py. Die nächsten Schritte stehen in Einen lokalen Arbeitsbereich steuern.
Grafikgerät auswählen
In den lokalen Einstellungen prüft Grafik → Automatisch (empfohlen) ein tatsächliches EGL-Grafikgerät im Engine-Container. Windows-Systeme mit NVIDIA verwenden WSL D3D12. Ist kein Hardware-Renderer verfügbar, verwendet die App die CPU und zeigt den Grund an.
GPU erforderlich verhindert den Start bei fehlgeschlagener GPU-Prüfung. Software (CPU) wählt CPU-Rendering. Linux mit NVIDIA benötigt kompatible Treiber und das NVIDIA Container Toolkit. Unter Windows installieren Sie den NVIDIA-Treiber in Windows; die Engine nutzt das WSL2-Backend. Die native Mac-Engine verwendet Metal.
ROS-Terminal und RViz der App sind bereits vorbereitet. Eine eigene Ubuntu-Distribution und ROS-Installation benötigen Sie nur für eine manuell eingerichtete Umgebung gemäß ROS-Terminals und Verbindung.
Gazebo Ogre2 rendert die lokale Szene. Ziehen dreht die Beobachterkamera, das Mausrad zoomt. Fehlen Bilder oder werden sie nicht mehr aktualisiert, zeigt die Ansicht einen Wartezustand.
Updates
Das rote Banner zeigt die installierte und die verfügbare Version. Jetzt aktualisieren öffnet im Simulator die Anleitung oder startet im Launcher den geprüften Download. × blendet das Banner in diesem Browser-Tab aus, bis eine neuere Version erscheint.
Beenden Sie die Simulation vor dem Update:
- App: Auf VERSION aktualisieren.
- Homebrew:
brew upgrade --cask www-posim. - APT:
sudo apt update && sudo apt upgrade. - Direktinstallation: aktuelles Paket herunterladen und installieren.
Der Mac-Updater prüft Download und Signatur vor dem Austausch. Passt die vorhandene Engine bereits, lädt er nur App-Dateien. Projekte, Modelle und Geländedaten außerhalb der App bleiben erhalten.
Für einen separaten ROS-Rechner laden Sie das Konnektor-Paket herunter und bereiten eine kompatible ROS-Umgebung gemäß ROS-Terminals und Verbindung vor.
Engine-Images
Die App lädt passende Engine- und Workspace-Images automatisch von Docker Hub. Die Images sind öffentlich; Registry-Anmeldung und manuelle Image-URL entfallen. Die native Mac-Version verwendet geprüfte Teile der Veröffentlichungsdateien statt Docker-Images.
docker.io/ioeslab/www-posim-engine:0.6.15-amd64
docker.io/ioeslab/www-posim-web:0.6.15-amd64
Sie können die Images vorab herunterladen:
docker pull docker.io/ioeslab/www-posim-engine:0.6.15-amd64
docker pull docker.io/ioeslab/www-posim-web:0.6.15-amd64
Mac-Start wiederherstellen
Nach Download oder Austausch der App kann die Startwarnung erneut erscheinen, da diese Distribution nicht von Apple notarisiert ist. Versuchen Sie Dennoch öffnen. Reagiert die Schaltfläche nicht oder bleibt die App ohne Fenster im Dock, muss eventuell der macOS-Validierungsdienst neu gestartet werden.
Beenden Sie WWW-POSIM zuerst. Verwenden Sie Apple-Menü → Sofort beenden nur bei einem blockierten Launcher und wenn keine Simulation läuft. Ein Neustart des Macs mit anschließendem Öffnen der App ist die einfachste Wiederherstellung.
Für die Wiederherstellung ohne Neustart prüfen Sie die Herkunft des offiziellen DMGs und seine veröffentlichte SHA-256-Prüfsumme. Führen Sie shasum -a 256 mit dem DMG-Pfad aus. Eine Ad-hoc-Signatur prüft Dateiintegrität, belegt aber nicht die Identität des Herausgebers.
Speichern Sie die Mac-Wiederherstellungshilfe im Downloads-Ordner:
bash "$HOME/Downloads/recover_macos_launch.command"
Die Standardprüfung kontrolliert App-Identität und Signatur und meldet das Quarantäneattribut. Zum Entsperren:
bash "$HOME/Downloads/recover_macos_launch.command" --repair --restart-validation
Lesen Sie die Abfrage und geben Sie TRUST WWW-POSIM ein, um die App trotz Apples Warnung zuzulassen. Das Hilfsprogramm entfernt die Quarantäne nur von der ausgewählten App, startet den Validierungsdienst neu und fordert den App-Start an. Geben Sie Ihr Mac-Passwort bei Bedarf lokal bei sudo ein. Gatekeeper bleibt aktiv. Prüfen Sie, ob das Fenster tatsächlich erscheint; die Startanforderung allein bestätigt keinen Erfolg.
Verwenden Sie nur --repair, wenn Dennoch öffnen reagiert und kein Dienstneustart nötig ist. Für die Dev-App ergänzen Sie --app "/Applications/WWW-POSIM Dev.app". Dieselbe Hilfe liegt im DMG neben der README und lässt sich mit bash und ihrem Pfad starten.
Für die manuelle Variante beenden Sie die App und prüfen zuerst die Prüfsumme des offiziellen DMGs. Fahren Sie nur fort, wenn die folgende Integritätsprüfung gelingt und Sie der App vertrauen:
codesign --verify --deep --strict "/Applications/WWW-POSIM.app"
xattr -dr com.apple.quarantine "/Applications/WWW-POSIM.app"
sudo /usr/bin/killall -TERM syspolicyd
open -a "/Applications/WWW-POSIM.app"
Ein Neustart des Validierungsdiensts betrifft auch ausstehende Sicherheitsprüfungen anderer Apps; deren Start muss gegebenenfalls wiederholt werden. Falls das nicht hilft, starten Sie den Mac neu. Schlägt die Signaturprüfung fehl, laden Sie einen neuen offiziellen Installer herunter.