Installazione
Scegli il metodo adatto al tuo sistema. I collegamenti nella tabella portano alle istruzioni di questa pagina.
Scegliere un pacchetto
| Sistema operativo | Metodo di installazione | Motore di simulazione |
|---|---|---|
| Apple Silicon · macOS 27 o successivo | Installare da DMG · Installare con Homebrew | ROS 2 e Gazebo nativi · Metal |
| Ubuntu 26.04 · x86-64 | Repository APT · Installare da DEB | Motore Linux in Docker |
| Windows · x86-64 | Installare su Windows | Docker Desktop · WSL2 |
Installare su Windows
Configurare WSL2
Se WSL non è installato, apri Terminale o PowerShell come amministratore dal menu Start ed esegui:
wsl --install --no-distribution
Riavvia il computer se richiesto, poi apri un nuovo terminale:
wsl --update
wsl --set-default-version 2
wsl --status
Verifica che la versione predefinita sia 2. In caso di errori di virtualizzazione, controlla le impostazioni del firmware e la guida di Microsoft all’installazione di WSL. Docker Desktop usa un proprio ambiente WSL2. Non serve una distribuzione Ubuntu separata, a meno che tu voglia preparare un ambiente ROS indipendente.
Installare Docker Desktop e l’app
- Installa Docker Desktop con il backend WSL2 e riavvia se richiesto.
- Apri Docker Desktop e attendi che il motore sia in esecuzione.
- Scarica il programma di installazione per Windows e segui le istruzioni. Se compare PC protetto da Windows, scegli Ulteriori informazioni → Esegui comunque per il download ufficiale di WWW-POSIM. Il pacchetto non ha una firma Authenticode; i checksum SHA-256 pubblicati identificano il file.
- Apri WWW-POSIM da Start e conferma nuovamente se compare lo stesso avviso. Accedi e seleziona Avvia simulatore.
- Il browser apre il simulatore locale. Prosegui con Conosci l’area di lavoro.
Mantieni Docker Desktop aperto durante l’uso. L’app scarica automaticamente le immagini associate alla propria versione.
Installare da DMG
Serve un Mac con Apple Silicon e macOS 27 o successivo. Controlla modello e versione da menu Apple → Informazioni su questo Mac.
- Scarica il DMG per Mac.
- Aprilo e trascina WWW-POSIM in Applicazioni.
- Prova ad aprire l’app. È firmata ad hoc e non è autenticata da Apple.
- Se macOS blocca il primo avvio, apri Impostazioni di Sistema → Privacy e sicurezza → Sicurezza e scegli Apri comunque accanto a WWW-POSIM. Conferma con Apri e autenticati se richiesto. Consulta le istruzioni di Apple.
- Accedi e seleziona Avvia simulatore. Al primo avvio vengono scaricati, verificati e decompressi i file del motore; la finestra mostra l’avanzamento.
- Continua nel browser con Conosci l’area di lavoro.
I download possono riprendere dopo un’interruzione e sono suddivisi in parti da 512 MiB. Ogni parte e ogni programma di installazione resta sotto 2 GiB. L’ambiente ROS e il motore vengono conservati fuori dall’app per gli avvii successivi. Il motore nativo usa la GPU tramite Metal.
Se l’avvio si blocca, consulta Ripristinare l’avvio su Mac.
Installare con Homebrew
Se non hai Homebrew, segui prima le sue istruzioni ufficiali. Poi installa la stessa app 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 autorizza il Cask di questa applicazione nel repository indicato. Vedi Tap Trust.
Se Homebrew richiede packages.arm64_dunno.jws.json e riceve HTTP 404, la sua tabella delle versioni non riconosce macOS 27. Aggiornalo senza l’API dei pacchetti e ripeti l’installazione:
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
Le variabili valgono solo per il comando che precedono. Consulta le opzioni d’ambiente di Homebrew. Se il problema persiste, usa Installare da DMG.
Apri WWW-POSIM con lo stesso account del sito. La connessione al server degli account è automatica. Il primo avvio verifica i file ed estrae il motore in Library, mostrando dimensioni estratte, percentuale, tempo residuo stimato e avvio dei servizi. Gazebo, ROS 2 e Autopilot vengono eseguiti sul Mac. Una notifica di aggiornamento non interrompe una simulazione in corso.
Per caricare l’ambiente incluso in un terminale esistente:
eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"
L’app include il connettore, i messaggi ROS standard e RViz2. Apri terminale ROS e Apri RViz usano questo ambiente. Installa le dipendenze aggiuntive del tuo algoritmo in un ambiente compatibile. Consulta Terminali ROS e connessione e Controlla un’area di lavoro locale.
Preparare Docker su Ubuntu
Installa Docker e curl. Dopo aver aggiunto il tuo account al gruppo Docker, esci dalla sessione Ubuntu e accedi di nuovo.
sudo apt update
sudo apt install -y docker.io curl
sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"
Repository APT
Completa Preparare Docker su Ubuntu, quindi aggiungi il repository APT firmato e installa l’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
L’app seleziona le immagini del motore in base alla propria versione. Il tuo account deve poter accedere a Docker. Per il rendering GPU servono anche driver e un ambiente di esecuzione dei container compatibili.
Installare da DEB
Il pacchetto è destinato a Ubuntu 26.04 su computer x86-64. Apri un terminale con Ctrl+Alt+T ed esegui:
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
- Inserisci la password quando
sudola richiede. Durante la digitazione non appaiono caratteri. - Esci dalla sessione Ubuntu e accedi di nuovo per attivare l’accesso a Docker.
- Apri WWW-POSIM dal menu delle applicazioni oppure esegui
www-posim. - Accedi, scegli Avvia simulatore e continua con Conosci l’area di lavoro.
Docker richiede Ubuntu 26.04?
Docker Engine supporta anche Ubuntu 24.04 e 22.04. Le versioni di Ubuntu e ROS nel container non devono coincidere con quelle dell’host. Il DEB e lo script di installazione di WWW-POSIM, però, sono destinati a Ubuntu 26.04; il programma di avvio dipende anche dalle librerie di sistema dell’host. Questo DEB è quindi supportato su 26.04. Il supporto di Docker su un host precedente non garantisce la compatibilità dell’installatore. Consulta le versioni Ubuntu supportate da Docker.
Verificare l’account e iniziare
Crea un account su Installazione, apri l’email di verifica e scegli Verifica email. Controlla la posta indesiderata se il messaggio non arriva. Dopo la verifica e l’accesso, l’app può salvare la password nell’archivio credenziali del sistema operativo.
Serve una connessione Internet per accedere e rinnovare periodicamente l’autorizzazione all’uso. Riserva spazio per il motore, i terreni e i modelli. Il limite di archiviazione dell’account è distinto dallo spazio libero sul computer. Vedi Account e durata delle sessioni.
Crea progetto Python aggiunge esempi nella cartella di lavoro salvata, inizialmente Documents/WWW-POSIM. Apri terminale ROS, Apri cartella di lavoro e Apri in VS Code usano questa cartella. VS Code apre ros_vehicle_command.py. Prosegui con Controlla un’area di lavoro locale.
Scegliere il dispositivo grafico
Nelle impostazioni locali, Grafica → Automatico (consigliato) verifica un dispositivo EGL effettivo nel container. Su Windows con NVIDIA viene usato WSL D3D12. Se non è disponibile un renderer hardware, l’app usa la CPU e ne indica il motivo.
GPU obbligatoria impedisce l’avvio se la verifica fallisce. Software (CPU) seleziona il rendering su CPU. Su Linux con NVIDIA servono driver compatibili e NVIDIA Container Toolkit. Su Windows installa il driver NVIDIA in Windows; il motore usa il backend WSL2. Il motore nativo Mac usa Metal.
Gli strumenti ROS e RViz dell’app hanno già un ambiente pronto. Una distribuzione Ubuntu e un’installazione ROS separate servono solo per un ambiente configurato manualmente, descritto in Terminali ROS e connessione.
Gazebo Ogre2 esegue il rendering della scena locale. Trascina per ruotare la visuale e usa la rotellina per lo zoom. Se i fotogrammi mancano o non si aggiornano più, la vista indica uno stato di attesa.
Aggiornamenti
Il banner rosso mostra la versione installata e quella disponibile. Aggiorna ora apre le istruzioni nel simulatore oppure avvia il download verificato nell’app. × nasconde il banner in quella scheda fino alla comparsa di una versione più recente.
Termina la simulazione prima di aggiornare:
- App: Aggiorna a VERSION.
- Homebrew:
brew upgrade --cask www-posim. - APT:
sudo apt update && sudo apt upgrade. - Installazione diretta: scarica e installa il pacchetto corrente.
Su Mac, download e firma vengono verificati prima della sostituzione. Se il motore corrisponde già alla versione richiesta, vengono scaricati solo i file dell’app. Progetti, modelli e terreni salvati fuori dall’app vengono conservati.
Per un altro computer ROS, scarica il pacchetto del connettore e prepara un ambiente ROS compatibile seguendo Terminali ROS e connessione.
Immagini del motore
L’app scarica automaticamente da Docker Hub le immagini del motore e dello spazio di lavoro associate alla propria versione. Sono pubbliche: non occorre accedere al registro o inserire URL. Il pacchetto nativo Mac usa parti verificate dei file di distribuzione, non immagini Docker.
docker.io/ioeslab/www-posim-engine:0.6.15-amd64
docker.io/ioeslab/www-posim-web:0.6.15-amd64
Puoi scaricarle in anticipo:
docker pull docker.io/ioeslab/www-posim-engine:0.6.15-amd64
docker pull docker.io/ioeslab/www-posim-web:0.6.15-amd64
Ripristinare l’avvio su Mac
L’avviso può ricomparire dopo il download o la sostituzione dell’app, perché questa distribuzione non è autenticata da Apple. Prova Apri comunque. Se il pulsante non risponde o l’app rimane nel Dock senza aprire una finestra, potrebbe essere necessario riavviare il servizio di convalida di macOS.
Chiudi prima WWW-POSIM. Usa menu Apple → Uscita forzata solo se il programma di avvio è bloccato e nessuna simulazione è in esecuzione. Riavviare il Mac e aprire nuovamente l’app è il rimedio più semplice.
Per intervenire senza riavviare, verifica che il DMG provenga dal download ufficiale e corrisponda al checksum SHA-256 pubblicato. Esegui shasum -a 256 seguito dal percorso del DMG. Una firma ad hoc verifica l’integrità dei file, ma non certifica l’identità dell’editore.
Salva l’assistente di ripristino per Mac in Download ed esegui:
bash "$HOME/Downloads/recover_macos_launch.command"
Il controllo iniziale verifica identità e firma dell’app e segnala l’attributo di quarantena. Per sbloccare l’avvio:
bash "$HOME/Downloads/recover_macos_launch.command" --repair --restart-validation
Leggi la richiesta e digita TRUST WWW-POSIM per autorizzare questa app nonostante l’avviso di Apple. L’assistente rimuove la quarantena solo dall’app selezionata, riavvia il servizio di convalida e ne richiede l’apertura. Inserisci localmente la password del Mac se sudo la richiede. Gatekeeper resta attivo. Verifica che compaia la finestra: la richiesta di apertura, da sola, non conferma il successo.
Usa soltanto --repair se Apri comunque risponde e il servizio non deve essere riavviato. Per l’app Dev aggiungi --app "/Applications/WWW-POSIM Dev.app". Lo stesso assistente è incluso nel DMG accanto al README; puoi eseguirlo con bash e il relativo percorso.
Per la procedura manuale, chiudi l’app e controlla prima il checksum del DMG ufficiale. Prosegui solo se il controllo seguente riesce e ritieni affidabile l’app:
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"
Il riavvio del servizio influisce anche sulle verifiche di sicurezza in sospeso di altre app, che potrebbero richiedere un nuovo tentativo di apertura. Se il problema persiste, riavvia il Mac. Se la firma non supera la verifica, scarica nuovamente l’installatore ufficiale.