WWW-POSIM v0.6.16Documentación del simulador
Menú de documentación
WWW-POSIM / Documentación del simulador

Instalación

Elige el método correspondiente a tu sistema. Los enlaces de la tabla llevan a las instrucciones de esta página.

Elegir un paquete

Sistema operativo Método de instalación Motor de simulación
Apple Silicon · macOS 27 o posterior Instalar desde un DMG · Instalar con Homebrew ROS 2 y Gazebo nativos · Metal
Ubuntu 26.04 · x86-64 Repositorio APT · Instalar desde un DEB Motor Linux en Docker
Windows · x86-64 Instalar en Windows Docker Desktop · WSL2

Sumas de comprobación SHA-256

Instalar en Windows

Configurar WSL2

Si no tienes WSL, abre Terminal o PowerShell como administrador desde Inicio y ejecuta:

wsl --install --no-distribution

Reinicia el equipo si se solicita. Abre otra terminal y ejecuta:

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

Comprueba que la versión predeterminada sea 2. Si aparece un error de virtualización, revisa la configuración del firmware y la guía de instalación de WSL de Microsoft. Docker Desktop utiliza su propio entorno WSL2. La aplicación no necesita una distribución Ubuntu independiente; solo hace falta si quieres preparar otro entorno ROS.

Instalar Docker Desktop y la aplicación

  1. Instala Docker Desktop con el backend WSL2 y reinicia si lo pide.
  2. Abre Docker Desktop y espera a que el motor esté en ejecución.
  3. Descarga el instalador para Windows y sigue sus instrucciones. Si aparece Windows protegió su PC, selecciona Más información → Ejecutar de todas formas para la descarga oficial de WWW-POSIM. Este paquete no tiene firma Authenticode; comprueba el archivo con las sumas SHA-256 publicadas.
  4. Abre WWW-POSIM desde Inicio. Si se repite la advertencia, confirma de nuevo. Inicia sesión y pulsa Iniciar simulador.
  5. El navegador abre el simulador local. Continúa con Conocer el espacio de trabajo.

Mantén Docker Desktop abierto. La aplicación descarga automáticamente las imágenes correspondientes a su versión.

Instalar desde un DMG

Necesitas un Mac con Apple Silicon y macOS 27 o posterior. Puedes comprobarlo en menú Apple → Acerca de este Mac.

  1. Descarga el DMG para Mac.
  2. Ábrelo y arrastra WWW-POSIM a Aplicaciones.
  3. Intenta abrir la aplicación. Su firma es ad hoc y no cuenta con la notarización de Apple.
  4. Si macOS bloquea el primer inicio, entra en Ajustes del Sistema → Privacidad y seguridad → Seguridad y pulsa Abrir igualmente junto a WWW-POSIM. Confirma con Abrir y autentícate si se solicita. Consulta las instrucciones de Apple.
  5. Inicia sesión y pulsa Iniciar simulador. El primer inicio descarga las partes del motor, las verifica y las descomprime; la ventana indica el progreso.
  6. Continúa en el navegador con Conocer el espacio de trabajo.

Las descargas se pueden reanudar y se dividen en partes de 512 MiB. Cada instalador y cada parte ocupa menos de 2 GiB. El entorno ROS y el motor se guardan fuera de la aplicación para reutilizarlos. El motor nativo utiliza la GPU mediante Metal.

Si el inicio queda bloqueado, consulta Recuperar el inicio en Mac.

Instalar con Homebrew

Si aún no tienes Homebrew, sigue sus instrucciones de instalación. Después instala la misma aplicación con:

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 autoriza el Cask de esta aplicación en el repositorio indicado; consulta Tap Trust.

Si Homebrew solicita packages.arm64_dunno.jws.json y obtiene un error HTTP 404, su tabla de versiones no reconoce macOS 27. Actualízalo sin la API de paquetes y repite la instalación:

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

Estas variables solo afectan al comando que acompañan. Consulta las opciones de entorno de Homebrew. Si el problema persiste, utiliza Instalar desde un DMG.

Abre WWW-POSIM e inicia sesión con la misma cuenta del sitio web. La conexión al servidor de cuentas es automática. El primer inicio verifica y extrae el motor en Library; muestra el tamaño extraído, el porcentaje, el tiempo estimado y el inicio de los servicios. Gazebo, ROS 2 y Autopilot se ejecutan en el Mac. Un aviso de actualización no interrumpe una simulación en curso.

Para preparar una terminal existente con el entorno incluido:

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

La aplicación ya incluye el conector, los mensajes ROS estándar y RViz2. Abrir terminal ROS y Abrir RViz utilizan ese entorno. Instala las dependencias adicionales de tu algoritmo en un entorno compatible. Consulta Terminales ROS y conexión y Controlar un espacio de trabajo local.

Preparar Docker en Ubuntu

Instala Docker y curl. Cierra la sesión de Ubuntu y vuelve a entrar después de añadir tu cuenta al grupo Docker.

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

Repositorio APT

Completa Preparar Docker en Ubuntu. Añade el repositorio APT firmado e instala la aplicación:

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

La aplicación selecciona las imágenes del motor según su versión. Tu cuenta debe tener acceso a Docker; para usar la GPU también necesitas controladores y un entorno de contenedores compatibles.

Instalar desde un DEB

El paquete está destinado a Ubuntu 26.04 en equipos x86-64. Abre una terminal con Ctrl+Alt+T y ejecuta:

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. Introduce tu contraseña cuando sudo la pida; no verás caracteres mientras escribes.
  2. Cierra la sesión de Ubuntu y vuelve a entrar para activar el acceso a Docker.
  3. Abre WWW-POSIM desde el menú de aplicaciones o ejecuta www-posim.
  4. Inicia sesión, pulsa Iniciar simulador y continúa con Conocer el espacio de trabajo.

¿Docker exige Ubuntu 26.04?

Docker Engine también admite Ubuntu 24.04 y 22.04. Las versiones de Ubuntu y ROS del contenedor no tienen que coincidir con las del equipo anfitrión. Sin embargo, el DEB y el instalador de WWW-POSIM están preparados para Ubuntu 26.04, y el ejecutable de la aplicación depende de bibliotecas del sistema anfitrión. Por ello, la versión compatible con este DEB es 26.04. Que Docker funcione en una versión anterior no confirma la compatibilidad del instalador. Consulta las versiones de Ubuntu compatibles con Docker.

Verificar la cuenta y empezar

Crea una cuenta en Instalación, abre el correo de verificación y pulsa Verificar correo electrónico. Revisa el correo no deseado si no lo encuentras. Tras verificar la cuenta e iniciar sesión, la aplicación puede guardar la contraseña en el almacén de credenciales del sistema.

Necesitas conexión a Internet para iniciar sesión y renovar periódicamente el permiso de uso. Reserva espacio para el motor, los terrenos y los modelos; el límite de almacenamiento de la cuenta y el espacio libre del equipo son independientes. Consulta Cuentas y tiempo de uso.

Crear proyecto Python añade ejemplos a la carpeta de trabajo guardada, inicialmente Documents/WWW-POSIM. Abrir terminal ROS, Abrir carpeta de trabajo y Abrir en VS Code utilizan esa carpeta. VS Code abre el ejemplo ros_vehicle_command.py. Sigue Controlar un espacio de trabajo local.

Elegir el dispositivo gráfico

En los ajustes locales, Gráficos → Automático (recomendado) comprueba un dispositivo EGL real dentro del contenedor. En Windows con NVIDIA se utiliza la ruta WSL D3D12. Si no hay un renderizador por hardware disponible, se emplea la CPU y se indica el motivo.

GPU obligatoria impide el inicio si falla la comprobación. Software (CPU) selecciona el renderizado por CPU. En Linux con NVIDIA hacen falta controladores compatibles y NVIDIA Container Toolkit. En Windows, instala el controlador NVIDIA en Windows; el motor usa el backend WSL2. El motor nativo de Mac utiliza Metal.

Las herramientas ROS y RViz de la aplicación ya tienen su entorno preparado. Una distribución Ubuntu y una instalación ROS independientes solo son necesarias si eliges configurar tu propio entorno, como se explica en Terminales ROS y conexión.

Gazebo Ogre2 renderiza la escena local. Arrastra para orbitar la cámara y usa la rueda para acercarte o alejarte. Si faltan fotogramas o dejan de actualizarse, la vista muestra un estado de espera.

Actualizaciones

El aviso rojo muestra las versiones instalada y disponible. Actualizar ahora abre las instrucciones en el simulador o inicia la descarga verificada en la aplicación. × oculta el aviso en esa pestaña hasta que aparezca una versión posterior.

Termina la simulación antes de actualizar:

En Mac se verifican la descarga y la firma antes de reemplazar la aplicación. Si el motor ya corresponde a la versión requerida, solo se descargan los archivos de la aplicación. Se conservan los proyectos, modelos y terrenos guardados fuera de ella.

Para otro equipo ROS, descarga el paquete del conector y prepara un entorno ROS compatible según Terminales ROS y conexión.

Imágenes del motor

La aplicación descarga de Docker Hub las imágenes correspondientes a su versión. Son públicas: no necesitas iniciar sesión en el registro ni introducir una URL. El paquete nativo de Mac utiliza partes verificadas de los archivos de publicación, no imágenes Docker.

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

Puedes descargarlas de antemano:

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

Recuperar el inicio en Mac

La advertencia puede reaparecer después de descargar o reemplazar la aplicación, ya que esta distribución no está notarizada por Apple. Prueba Abrir igualmente. Si el botón no responde o la aplicación permanece en el Dock sin abrir una ventana, puede ser necesario reiniciar el servicio de validación de macOS.

Cierra WWW-POSIM primero. Usa menú Apple → Forzar salida únicamente si la aplicación no responde y no hay una simulación en ejecución. Reiniciar el Mac y abrir de nuevo la aplicación es la opción más sencilla.

Para recuperarla sin reiniciar, comprueba que el DMG procede de la descarga oficial y que coincide con las sumas SHA-256 publicadas. Ejecuta shasum -a 256 seguido de la ruta del DMG. Una firma ad hoc comprueba la integridad, pero no acredita la identidad del editor.

Guarda el asistente de recuperación para Mac en Descargas y ejecuta:

bash "$HOME/Downloads/recover_macos_launch.command"

La comprobación inicial verifica la identidad y la firma de la aplicación e informa de su marca de cuarentena. Para reparar el bloqueo:

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

Lee la solicitud y escribe TRUST WWW-POSIM para permitir la ejecución pese al aviso de Apple. El asistente elimina la cuarentena únicamente de la aplicación seleccionada, reinicia el servicio de validación y solicita abrirla. Introduce la contraseña del Mac localmente si sudo la pide. Gatekeeper permanece activado. Comprueba que aparezca la ventana; solicitar la apertura no demuestra que haya funcionado.

Usa solo --repair si Abrir igualmente responde y no necesitas reiniciar el servicio. Para la aplicación Dev, añade --app "/Applications/WWW-POSIM Dev.app". El DMG incluye el mismo asistente junto a su README; también puedes ejecutarlo con bash y su ruta.

Para realizar la misma recuperación manualmente, cierra la aplicación y verifica primero la suma del DMG oficial. Continúa únicamente si la siguiente comprobación es correcta y confías en la aplicación:

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"

Reiniciar el servicio afecta a otras comprobaciones de seguridad pendientes; quizá debas volver a abrir esas aplicaciones. Si sigue sin funcionar, reinicia el Mac. Si falla la firma, descarga de nuevo el instalador oficial.

Buscar en la documentación