Windows:WSLへのインストール
Windows Subsystem for Linux 2(WSL2)上のUbuntu 26.04にPOSIMをインストールします。GazeboのウィンドウはWSLgによってWindowsデスクトップに表示されます。構築済みイメージを使う場合はWSLとDockerを選んでください。
1. WSLとUbuntuをインストールする
管理者としてPowerShellを開き、次を実行します。
wsl --install -d Ubuntu-26.04
再起動を求められたらWindowsを再起動します。Ubuntuを開き、Linuxのユーザー名とパスワードを設定してください。PowerShellで、UbuntuがWSL 2を使用していることを確認します。
wsl --list --verbose
既存のWSLを利用する場合やインストールに失敗する場合は、Microsoftの手順を参照してください。
2. グラフィックスドライバーとWSLgを準備する
Intel・AMD・NVIDIA GPUのWindows用ドライバーをインストールまたは更新します。NVIDIAの場合も必要です。WSLgはWindows側のドライバーでLinuxのGUIを描画します。GUIアプリの設定手順を確認してください。
NVIDIA では CUDA on WSL に従い、Windows 用ドライバーを導入します。WSL 内に Linux 用ディスプレイドライバーをインストールしないでください。 CUDA Toolkit が必要なのは、ソナーの CUDA バックエンドをビルドする場合です。
PowerShellでWSLを更新します。
wsl --update
再起動が必要な場合は、WSL内で作業を保存してから実施し、その後Ubuntuを開き直します。
3. UbuntuのターミナルでPOSIMをインストールする
LinuxのコマンドはWindows TerminalのUbuntuプロファイルで実行します。ディストリビューションを確認してください。
cat /etc/os-release
Ubuntuへのネイティブインストールのソース取得からビルドまでを実行します。ワークスペースはLinuxのホームディレクトリ内の~/posim_wsに作成してください。インストーラーはsudoを使い、Ubuntu内のパッケージを更新します。
画像トピックは見えるのに画像が届かない場合はトラブルシューティングを参照してください。以降の例で使う2つのウィンドウは、ターミナルの準備で説明しています。
4. デモワールドを起動する
Ubuntuのターミナルで実行します。WindowsデスクトップにGazeboが開き、海のシーンが表示されれば成功です。初回はFuelモデルをダウンロードすることがあります。別の例を起動する前にCtrl+Cで停止してください。
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
source ~/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
world_name:=posim_ocean_waves headless:=false
POSIMと同じUbuntuディストリビューション内でLinux版QGCを実行してください。この構成では、WindowsにインストールしたQGCは起動しません。QGCの設定に従ってください。