WWW-POSIM v0.6.16Documentation du simulateur
Menu de la documentation
WWW-POSIM / Documentation du simulateur

Installation

Choisissez la méthode adaptée à votre système. Les liens du tableau renvoient aux instructions de cette page.

Choisir un paquet

Système d’exploitation Méthode d’installation Moteur de simulation
Apple Silicon · macOS 27 ou version ultérieure Installer depuis un DMG · Installer avec Homebrew ROS 2 et Gazebo natifs · Metal
Ubuntu 26.04 · x86-64 Dépôt APT · Installer depuis un DEB Moteur Linux dans Docker
Windows · x86-64 Installer sous Windows Docker Desktop · WSL2

Sommes de contrôle SHA-256

Installer sous Windows

Configurer WSL2

Si WSL n’est pas installé, ouvrez Terminal ou PowerShell en tant qu’administrateur depuis le menu Démarrer, puis exécutez :

wsl --install --no-distribution

Redémarrez si Windows vous le demande, puis ouvrez un nouveau terminal :

wsl --update
wsl --set-default-version 2
wsl --status

Vérifiez que la version par défaut est 2. En cas d’erreur de virtualisation, vérifiez les réglages du micrologiciel et consultez le guide d’installation de WSL de Microsoft. Docker Desktop dispose de son propre environnement WSL2. L’application n’exige pas de distribution Ubuntu distincte ; celle-ci n’est utile que pour préparer un autre environnement ROS.

Installer Docker Desktop et l’application

  1. Installez Docker Desktop avec le backend WSL2. Redémarrez si nécessaire.
  2. Ouvrez Docker Desktop et attendez que son moteur soit prêt.
  3. Téléchargez le programme d’installation Windows, puis suivez les étapes. Si Windows a protégé votre ordinateur s’affiche, choisissez Informations complémentaires → Exécuter quand même pour le téléchargement officiel de WWW-POSIM. Ce paquet n’a pas de signature Authenticode ; les sommes SHA-256 publiées permettent d’identifier le fichier.
  4. Ouvrez WWW-POSIM depuis Démarrer. Confirmez à nouveau si le même avertissement apparaît. Connectez-vous et choisissez Démarrer le simulateur.
  5. Le navigateur ouvre le simulateur local. Poursuivez avec Prendre en main l’espace de travail.

Laissez Docker Desktop ouvert. L’application télécharge automatiquement les images correspondant à sa version.

Installer depuis un DMG

Utilisez un Mac Apple Silicon sous macOS 27 ou version ultérieure. Vous trouverez ces informations dans menu Pomme → À propos de ce Mac.

  1. Téléchargez le DMG pour Mac.
  2. Ouvrez-le et faites glisser WWW-POSIM dans Applications.
  3. Essayez d’ouvrir l’application. Sa signature est ad hoc et elle n’est pas notariée par Apple.
  4. Si macOS bloque ce premier lancement, ouvrez Réglages Système → Confidentialité et sécurité → Sécurité, puis choisissez Ouvrir quand même à côté de WWW-POSIM. Confirmez avec Ouvrir et authentifiez-vous si nécessaire. Consultez les instructions d’Apple.
  5. Connectez-vous et choisissez Démarrer le simulateur. Au premier démarrage, les fichiers du moteur sont téléchargés, vérifiés et décompressés. La fenêtre indique la progression.
  6. Continuez dans le navigateur avec Prendre en main l’espace de travail.

Les téléchargements reprennent après une interruption et sont divisés en parties de 512 Mio. Chaque partie et chaque programme d’installation pèsent moins de 2 Gio. L’environnement ROS et le moteur sont conservés en dehors de l’application pour les démarrages suivants. Le moteur natif utilise le GPU via Metal.

Si le lancement reste bloqué, consultez Débloquer le lancement sur Mac.

Installer avec Homebrew

Si nécessaire, installez d’abord Homebrew en suivant ses instructions officielles. Installez ensuite la même application avec :

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 autorise le Cask de cette application dans le dépôt indiqué. Voir Tap Trust.

Si Homebrew demande packages.arm64_dunno.jws.json et reçoit une erreur HTTP 404, sa table des versions ne reconnaît pas macOS 27. Mettez-le à jour sans l’API des paquets, puis réessayez :

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

Ces variables ne s’appliquent qu’à la commande qu’elles précèdent. Voir les options d’environnement de Homebrew. Si le problème persiste, suivez Installer depuis un DMG.

Ouvrez WWW-POSIM avec le même compte que sur le site. La connexion au serveur de comptes est automatique. Le premier démarrage vérifie les fichiers et extrait le moteur dans Library ; il affiche le volume extrait, le pourcentage, le temps restant estimé, puis le démarrage des services. Gazebo, ROS 2 et Autopilot s’exécutent sur le Mac. Une notification de mise à jour n’interrompt pas la simulation.

Pour charger l’environnement fourni dans un terminal existant :

eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"

L’application inclut le connecteur, les messages ROS standard et RViz2. Ouvrir le terminal ROS et Ouvrir RViz utilisent cet environnement. Installez les dépendances supplémentaires de votre algorithme dans un environnement compatible. Consultez Terminaux ROS et connexion et Commander un espace de travail local.

Préparer Docker sous Ubuntu

Installez Docker et curl. Après avoir ajouté votre compte au groupe Docker, fermez votre session Ubuntu et reconnectez-vous.

sudo apt update
sudo apt install -y docker.io curl
sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"

Dépôt APT

Suivez Préparer Docker sous Ubuntu, puis ajoutez le dépôt APT signé et installez l’application :

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

L’application sélectionne les images du moteur correspondant à sa version. Votre compte doit avoir accès à Docker. Le rendu GPU exige également des pilotes et un environnement de conteneurs compatibles.

Installer depuis un DEB

Ce paquet est destiné à Ubuntu 26.04 sur un ordinateur x86-64. Ouvrez un terminal avec Ctrl+Alt+T et exécutez :

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
  1. Saisissez votre mot de passe lorsque sudo le demande. Aucun caractère ne s’affiche pendant la saisie.
  2. Fermez votre session Ubuntu et reconnectez-vous pour activer l’accès à Docker.
  3. Ouvrez WWW-POSIM depuis le menu des applications ou lancez www-posim.
  4. Connectez-vous, choisissez Démarrer le simulateur, puis continuez avec Prendre en main l’espace de travail.

Docker exige-t-il Ubuntu 26.04 ?

Docker Engine prend aussi en charge Ubuntu 24.04 et 22.04. Les versions d’Ubuntu et de ROS du conteneur n’ont pas à correspondre à celles de l’hôte. En revanche, le DEB et l’installateur WWW-POSIM ciblent Ubuntu 26.04, et le lanceur dépend des bibliothèques système de l’hôte. Ce DEB est donc pris en charge sous 26.04. Le fonctionnement de Docker sur un hôte plus ancien ne garantit pas la compatibilité de l’installateur. Consultez les versions d’Ubuntu prises en charge par Docker.

Vérifier son compte et commencer

Créez votre compte sur Installation, ouvrez le courriel de vérification et choisissez Vérifier l’adresse e-mail. Vérifiez les courriers indésirables si nécessaire. Après vérification et connexion, l’application peut conserver le mot de passe dans le gestionnaire d’identifiants du système.

Une connexion Internet est nécessaire pour se connecter et renouveler périodiquement l’autorisation d’utilisation. Prévoyez de l’espace pour le moteur, les terrains et les modèles. Le quota de votre compte est distinct de l’espace libre sur votre ordinateur. Voir Comptes et durée des sessions.

Créer un projet Python ajoute des exemples dans le dossier de travail enregistré, initialement Documents/WWW-POSIM. Ouvrir le terminal ROS, Ouvrir le dossier de travail et Ouvrir dans VS Code utilisent ce dossier. VS Code ouvre ros_vehicle_command.py. Poursuivez avec Commander un espace de travail local.

Choisir le périphérique graphique

Dans les réglages locaux, Graphiques → Automatique (recommandé) teste un véritable périphérique EGL à l’intérieur du conteneur. Sous Windows avec NVIDIA, l’application utilise WSL D3D12. Si aucun moteur de rendu matériel n’est disponible, elle passe au processeur et en indique la raison.

GPU obligatoire empêche le démarrage si le test échoue. Logiciel (CPU) utilise le processeur. Sous Linux avec NVIDIA, il faut des pilotes compatibles et NVIDIA Container Toolkit. Sous Windows, installez le pilote NVIDIA dans Windows ; le moteur utilise le backend WSL2. Le moteur natif Mac utilise Metal.

Les outils ROS et RViz de l’application disposent déjà de l’environnement nécessaire. Une distribution Ubuntu et une installation ROS distinctes ne sont utiles que pour un environnement configuré manuellement, décrit dans Terminaux ROS et connexion.

Gazebo Ogre2 assure le rendu de la scène locale. Faites glisser pour tourner autour de la scène et utilisez la molette pour zoomer. La vue indique une attente si les images manquent ou ne se renouvellent plus.

Mises à jour

La bannière rouge indique la version installée et la version disponible. Mettre à jour maintenant ouvre les instructions dans le simulateur ou lance le téléchargement vérifié dans l’application. × masque la bannière dans cet onglet jusqu’à la prochaine version.

Terminez la simulation avant de mettre à jour :

Sur Mac, le téléchargement et la signature sont vérifiés avant le remplacement. Si le moteur correspond déjà à la version attendue, seuls les fichiers de l’application sont téléchargés. Les projets, modèles et terrains stockés en dehors de l’application sont conservés.

Pour un autre poste ROS, téléchargez le paquet du connecteur et préparez un environnement ROS compatible selon Terminaux ROS et connexion.

Images du moteur

L’application télécharge sur Docker Hub les images correspondant à sa version. Elles sont publiques : aucun compte de registre ni aucune URL d’image ne sont à saisir. Le paquet natif Mac utilise des parties vérifiées des fichiers de publication, pas des images Docker.

docker.io/ioeslab/www-posim-engine:0.6.15-amd64
docker.io/ioeslab/www-posim-web:0.6.15-amd64

Pour les télécharger à l’avance :

docker pull docker.io/ioeslab/www-posim-engine:0.6.15-amd64
docker pull docker.io/ioeslab/www-posim-web:0.6.15-amd64

Débloquer le lancement sur Mac

L’avertissement peut réapparaître après le téléchargement ou le remplacement de l’application, car cette distribution n’est pas notariée par Apple. Essayez Ouvrir quand même. Si ce bouton ne répond pas ou si l’application reste dans le Dock sans ouvrir de fenêtre, le service de validation de macOS peut nécessiter un redémarrage.

Quittez d’abord WWW-POSIM. Utilisez menu Pomme → Forcer à quitter uniquement si le lanceur est bloqué et qu’aucune simulation ne tourne. Redémarrer le Mac puis rouvrir l’application reste la solution la plus simple.

Pour intervenir sans redémarrer, vérifiez que le DMG provient du téléchargement officiel et correspond à sa somme SHA-256 publiée. Exécutez shasum -a 256 suivi du chemin du DMG. Une signature ad hoc vérifie l’intégrité des fichiers, pas l’identité de l’éditeur.

Enregistrez l’assistant de récupération Mac dans Téléchargements, puis exécutez :

bash "$HOME/Downloads/recover_macos_launch.command"

Le contrôle initial vérifie l’identité et la signature de l’application et indique son attribut de quarantaine. Pour débloquer le lancement :

bash "$HOME/Downloads/recover_macos_launch.command" --repair --restart-validation

Lisez la demande et saisissez TRUST WWW-POSIM pour autoriser cette application malgré l’avertissement d’Apple. L’assistant retire la quarantaine uniquement de l’application sélectionnée, redémarre le service de validation et demande son ouverture. Saisissez localement le mot de passe du Mac si sudo le demande. Gatekeeper reste activé. Vérifiez que la fenêtre s’ouvre : une demande de lancement ne suffit pas à confirmer le résultat.

Utilisez seulement --repair si Ouvrir quand même répond et si le service n’a pas besoin d’être redémarré. Pour la version Dev, ajoutez --app "/Applications/WWW-POSIM Dev.app". Le DMG contient le même assistant à côté du README ; vous pouvez aussi le lancer avec bash et son chemin.

Pour effectuer la même opération manuellement, quittez l’application et vérifiez d’abord la somme du DMG officiel. Ne poursuivez que si le contrôle ci-dessous réussit et si vous faites confiance à l’application :

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"

Le redémarrage du service touche les vérifications de sécurité en attente d’autres applications ; leur ouverture peut nécessiter un nouvel essai. Si le problème persiste, redémarrez le Mac. Si la vérification de signature échoue, téléchargez à nouveau l’installateur officiel.

Rechercher dans la documentation