インストール
お使いのOSに合った方法を選んでください。表のリンクから、このページ内の手順に移動できます。
パッケージを選ぶ
| OS | インストール方法 | シミュレーションエンジン |
|---|---|---|
| Apple Silicon · macOS 27以降 | DMGからインストール · Homebrewでインストール | ネイティブROS 2・Gazebo · Metal |
| Ubuntu 26.04 · x86-64 | APTリポジトリ · DEBからインストール | Docker内のLinuxエンジン |
| Windows · x86-64 | Windowsにインストール | Docker Desktop · WSL2 |
Windowsにインストール
WSL2を設定する
WSLが未インストールの場合は、スタートメニューからターミナルまたはPowerShellを管理者として開き、次を実行します。
wsl --install --no-distribution
再起動を求められたら再起動し、新しいターミナルで次を実行します。
wsl --update
wsl --set-default-version 2
wsl --status
既定のバージョンが2になっていることを確認してください。仮想化のエラーが出る場合は、ファームウェアの仮想化設定とMicrosoftのWSLインストールガイドを確認します。Docker Desktopは独自のWSL2環境を使用するため、Ubuntuディストリビューションを別途入れる必要はありません。別のROS環境を自分で用意する場合にのみ追加してください。
Docker Desktopとアプリをインストールする
- Docker Desktopをインストールし、WSL2バックエンドを設定します。指示があれば再起動します。
- Docker Desktopを開き、エンジンが起動するまで待ちます。
- Windows用インストーラーをダウンロードして実行します。WindowsによってPCが保護されましたと表示された場合、公式のWWW-POSIMダウンロードに対して詳細情報 → 実行を選びます。このパッケージにはAuthenticode署名がありません。公開されているSHA-256チェックサムでファイルを確認できます。
- スタートメニューからWWW-POSIMを開きます。同じ警告が出たら再度確認します。ログインし、シミュレーターを起動を選びます。
- ブラウザーでローカルシミュレーターが開きます。ワークスペースの基本に進んでください。
使用中はDocker Desktopを起動したままにします。アプリはバージョンに対応するイメージを自動でダウンロードします。
DMGからインストール
Apple Silicon搭載のMacとmacOS 27以降が必要です。Appleメニュー → このMacについてで確認できます。
- Mac用DMGをダウンロードします。
- DMGを開き、WWW-POSIMをアプリケーションへドラッグします。
- アプリを開いてみます。このアプリはアドホック署名を使用しており、Appleの公証は受けていません。
- 初回起動がブロックされた場合は、システム設定 → プライバシーとセキュリティ → セキュリティでWWW-POSIMの横にあるこのまま開くを選びます。確認画面で開くを選び、必要に応じて認証します。Appleの案内も参照してください。
- ログインしてシミュレーターを起動を選びます。初回はエンジンのファイルをダウンロード、検証、展開します。ウィンドウで進行状況を確認できます。
- ブラウザーでワークスペースの基本に進みます。
ダウンロードは512 MiB単位に分割され、中断後も再開できます。インストーラーと各分割ファイルはいずれも2 GiB未満です。ROS環境と準備済みエンジンはアプリの外に保存され、次回以降も利用されます。ネイティブエンジンはMetal経由でGPUを使用します。
起動できない場合はMacの起動を復旧するを参照してください。
Homebrewでインストール
Homebrewがなければ、先に公式のインストール手順に従って準備します。同じアプリを次のコマンドでインストールできます。
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は、指定したリポジトリにあるこのアプリのCaskを読み込むことを許可します。Tap Trustを参照してください。
packages.arm64_dunno.jws.jsonへの要求がHTTP 404になる場合、Homebrewのバージョン一覧がmacOS 27に対応していません。パッケージAPIを使わずに更新し、再度インストールします。
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
これらの環境変数は、直後のコマンドだけに適用されます。Homebrewの環境変数を参照してください。解決しない場合はDMGからインストールを使用します。
アプリを開き、Webサイトと同じアカウントでログインします。アカウントサーバーには自動で接続されます。初回は検証したエンジンをLibrary内に展開し、展開済みサイズ、進捗率、推定残り時間、サービスの起動状況を表示します。Gazebo、ROS 2、AutopilotはMac上で実行されます。更新通知が出ても実行中のシミュレーションは中断されません。
既存のターミナルに同梱環境を読み込むには、次を実行します。
eval "$(/Applications/WWW-POSIM.app/Contents/MacOS/WWW-POSIM --ros-env)"
コネクター、標準ROSメッセージ、RViz2は同梱されています。ROSターミナルを開くとRVizを開くはこの環境を使用します。独自のアルゴリズムに必要な追加パッケージは、互換性のある環境にインストールしてください。ROSターミナルと接続とインストール版のワークスペースを制御で詳しく説明しています。
UbuntuでDockerを準備する
Dockerとcurlをインストールします。アカウントをDockerグループに追加した後は、Ubuntuからログアウトしてログインし直してください。
sudo apt update
sudo apt install -y docker.io curl
sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"
APTリポジトリ
UbuntuでDockerを準備するを完了してから、署名付きAPTリポジトリを追加してアプリをインストールします。
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
エンジンのイメージはアプリのバージョンに合わせて自動選択されます。ユーザーアカウントからDockerを利用できる必要があります。GPUレンダリングには、対応するドライバーとコンテナー実行環境も必要です。
DEBからインストール
このパッケージはx86-64のUbuntu 26.04向けです。Ctrl+Alt+Tでターミナルを開いて実行します。
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
sudoに求められたらパスワードを入力します。入力中は文字が表示されません。- Ubuntuからログアウトし、ログインし直してDockerへのアクセスを有効にします。
- アプリケーションメニューからWWW-POSIMを開くか、
www-posimを実行します。 - ログインしてシミュレーターを起動を選び、ワークスペースの基本に進みます。
DockerにもUbuntu 26.04が必要?
Docker EngineはUbuntu 24.04と22.04にも対応しています。コンテナー内のUbuntuやROSのバージョンをホストに合わせる必要はありません。ただし、WWW-POSIMの公開DEBとインストールスクリプトはUbuntu 26.04向けで、ランチャーの実行ファイルはホストのシステムライブラリにも依存します。そのため、このDEBの対応環境は26.04です。古いホストでDockerが動くことだけでは、WWW-POSIMインストーラーの互換性は確認できません。Dockerが対応するUbuntuのバージョンを参照してください。
アカウントを確認して使い始める
インストールで登録し、確認メールを開いてメールアドレスを確認を選びます。届かない場合は迷惑メールフォルダーも確認してください。確認済みアカウントでのログイン後、パスワードをOSの資格情報ストアに保存できます。
ログインと定期的な利用許可の更新にはインターネット接続が必要です。エンジン、地形、モデルを保存する空き容量を確保してください。アカウントの保存容量制限と、コンピューターの空き容量は別です。アカウントと利用時間を参照してください。
Pythonプロジェクトを作成は、保存済みの作業フォルダーにサンプルを追加します。初期値はDocuments/WWW-POSIMです。ROSターミナルを開く、作業フォルダーを開く、VS Codeで開くはこのフォルダーを使用します。VS Codeではros_vehicle_command.pyが開きます。インストール版のワークスペースを制御に進んでください。
グラフィックスデバイスを選ぶ
ローカル設定のグラフィックス → 自動(推奨)は、エンジンのコンテナー内で実際のEGLデバイスを検査します。WindowsのNVIDIA環境ではWSL D3D12を使用します。ハードウェアレンダラーが使えない場合はCPUへ切り替え、その理由を表示します。
GPU必須はGPU検査に失敗すると起動を中止します。ソフトウェア(CPU)はCPUレンダリングを選択します。LinuxのNVIDIA環境では互換性のあるドライバーとNVIDIA Container Toolkitが必要です。WindowsではNVIDIAドライバーをWindows側にインストールします。エンジンはWSL2バックエンドを使用します。MacのネイティブエンジンはMetalを使用します。
アプリのROSターミナルとRVizには環境が準備されています。UbuntuとROSを別途インストールするのは、ROSターミナルと接続に従って独自の環境を準備する場合だけです。
ローカルシーンはGazebo Ogre2が描画します。ドラッグで観察カメラを回転し、ホイールでズームします。フレームが届かない、または更新されなくなった場合は待機状態が表示されます。
更新
赤い通知にインストール済みと更新先のバージョンが表示されます。今すぐ更新は、シミュレーターでは手順を開き、ランチャーでは検証付きダウンロードを開始します。×で閉じると、そのタブでは次のバージョンが出るまで非表示になります。
シミュレーションを終了してから、次のいずれかで更新してください。
- アプリ:VERSIONに更新。
- Homebrew:
brew upgrade --cask www-posim。 - APT:
sudo apt update && sudo apt upgrade。 - 直接インストール:最新版のパッケージをダウンロードしてインストール。
Macでは置き換える前にダウンロードと署名を検証します。エンジンが対応バージョンなら、アプリのファイルだけをダウンロードします。アプリの外に保存したプロジェクト、モデル、地形キャッシュは保持されます。
別のROS端末ではコネクターパッケージと互換性のあるROS環境を用意します。手順はROSターミナルと接続を参照してください。
エンジンのイメージ
アプリは対応するエンジンとワークスペースのイメージをDocker Hubから自動取得します。公開イメージなので、レジストリへのログインやURL入力は不要です。Macのネイティブ版はDockerイメージではなく、検証済みの分割配布ファイルを使用します。
docker.io/ioeslab/www-posim-engine:0.6.15-amd64
docker.io/ioeslab/www-posim-web:0.6.15-amd64
事前にダウンロードする場合:
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の起動を復旧する
この配布版はAppleの公証を受けていないため、ダウンロードやアプリの置き換え後に警告が再表示される場合があります。まずこのまま開くを試してください。ボタンが反応しない、またはDockに残ったままウィンドウが開かない場合は、macOSの検証サービスの再起動が必要なことがあります。
先にWWW-POSIMを終了してください。Appleメニュー → 強制終了は、ランチャーが応答せず、シミュレーションも実行していない場合に限って使用します。Macを再起動してアプリを開き直すのが最も簡単な復旧方法です。
再起動せずに復旧する場合は、DMGが公式ダウンロードであることと、公開SHA-256チェックサムとの一致を確認します。shasum -a 256の後にDMGのパスを指定してください。アドホック署名はファイルの整合性を確認するもので、配布元の身元を証明するものではありません。
Mac起動復旧ツールをダウンロードフォルダーに保存し、実行します。
bash "$HOME/Downloads/recover_macos_launch.command"
既定の検査ではアプリの識別情報と署名を確認し、隔離属性の有無を表示します。復旧するには次を実行します。
bash "$HOME/Downloads/recover_macos_launch.command" --repair --restart-validation
表示内容を読み、Appleの警告があるこのアプリの実行を許可する場合にTRUST WWW-POSIMと入力します。ツールは選択したアプリの隔離属性だけを解除し、検証サービスを再起動して起動を要求します。sudoに求められたら、Macのパスワードをその端末で入力してください。Gatekeeperは有効なままです。起動要求だけで成功とは判断せず、ウィンドウが開いたことを確認します。
このまま開くが正常に応答し、サービスの再起動が不要なら--repairのみを使います。Dev版では--app "/Applications/WWW-POSIM Dev.app"を追加します。DMG内のREADMEの隣にも同じツールがあり、bashにそのパスを渡して実行できます。
手動で同じ復旧を行う場合も、アプリを終了し、公式DMGのチェックサムを先に確認します。次の検査に成功し、アプリを信頼できる場合にだけ続けてください。
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"
検証サービスを再起動すると、他のアプリで保留中のセキュリティ検査にも影響し、開き直す必要が生じる場合があります。復旧しない場合はMacを再起動してください。署名検査に失敗した場合は、公式インストーラーを再ダウンロードします。