👋

WSL2でLinuxネイティブ版Antigravityを正しく動かす

に公開

🎯 はじめに:結論から

この記事は、以下の目的を持った人に向けて書きました。

「Ubuntu 22.04 (WSL2) で、Windows版経由ではなく、純粋な Linux ネイティブ版として Antigravity を動かしたい」

私がこの環境構築でドハマリし、最終的にたどり着いた結論は以下の通りです。

  1. apt / deb 版は罠:WSL環境を検知すると「Windows版を使え」と警告するラッパーになっている。
  2. Windows版が邪魔をする:WSLの仕様により、Windows側にインストールされた Antigravity.exe が antigravity コマンドとして Linux 側の PATH に割り込み、ネイティブ版より優先されてしまう。
  3. tar.gz 版が唯一の正解:公式サイトの tarball を /opt に配置し、手動でパスを通すことでのみ純粋なLinux環境として動作する。

本記事では、この結論に至るまでの挙動の解析と、再現性100%の構築手順を共有します。


📌 検証環境

今回の検証は、以下の最新ミドル〜ハイエンド構成で行いました。

  • OS: Windows 11 Pro
  • WSL2: Ubuntu 22.04 LTS
  • CPU: AMD Ryzen 7 9800X3D (8-Core / 16-Thread, L3 Cache 96MB)
  • RAM: 32GB (DDR5-5600)
  • GPU: NVIDIA GeForce RTX 5070 Ti (VRAM 16GB)
  • Storage:
    • /home/user (WSL仮想ディスク / 高速)
    • /mnt/c (Windows側 NTFS / 低速)
  • 対象アプリ: Antigravity (Electron/Chromiumベース)

🧨 発生した4つの「詰み」ポイント

WSL上で普通に sudo apt install をしたり、公式サイトからインストーラーを落とすだけでは、以下の問題が発生します。

💥 問題1:apt版が「Windows版を使え」と命令してくる

apt でインストールした Linux 版を起動しようとすると、以下のメッセージが出て終了します。

To use Antigravity with the Windows Subsystem for Linux,
please install Antigravity in Windows and uninstall the Linux version in WSL.

実はこれ、**Antigravity 本体ではなく、WSL環境であることを検知するためのシェルスクリプト(ラッパー)**が起動しています。Debianパッケージ版は、WSL上ではあえて動かないように設計されているのです。

💥 問題2:apt remove しても「亡霊」が残る

「じゃあ apt 版は消そう」と apt purge しても、コマンドラインで antigravity と打つと何かが起動しようとします。これは WSL の Interop 機能 が自動生成した /bin/antigravity というファイル(shim)が残っているためです。

💥 問題3:Windows版 EXE が Linux コマンドになりすます

これが最大のパフォーマンス低下の原因です。WSL はデフォルトで Windows の PATH を引き継ぐため、以下の現象が起きます。

$ which -a antigravity

/usr/local/bin/antigravity  # 本来動かしたいLinux版(優先度低)
/bin/antigravity            # WSLが作った偽物(優先度高!)
/mnt/c/.../antigravity.exe  # Windowsの実体

Linux 側で antigravity と打ったつもりが、裏では Windows 側の .exe が起動しています。
WSL から Windows の EXE を叩くと、ファイルシステムの境界を越えるため IO が激重になり、「Linux 版を入れたはずなのに遅い」という現象を引き起こします。


🚀 完全な解決手順(再現手順)

WSL の干渉を排除し、純粋な Linux バイナリとして動作させるための唯一の手順です。

Step 0: 既存の競合を完全削除

まずは apt 版や、中途半端な設定を掃除します。

# apt版の削除
sudo apt purge -y antigravity || true
sudo apt autoremove -y

# 手動で配置した可能性のあるゴミを削除
sudo rm -f /usr/bin/antigravity /usr/local/bin/antigravity

# ハッシュキャッシュをクリア(重要)
hash -r

Step 1: 公式サイトから tar.gz 版を入手

公式サイトから、.deb ではなく .tar.gz (Linux x64) 版をダウンロードしてください。

Windows 側でダウンロードしたファイルを、WSL 側のホームディレクトリ(ext4領域)にコピーします。
※ /mnt/c 上で解凍するとパーミッションがおかしくなるため、必ず WSL のホーム以下で作業してください。

cd ~
# 例: WindowsのDownloadsから持ってくる
cp /mnt/c/Users/yourname/Downloads/Antigravity-linux-x64.tar.gz .

Step 2: /opt への配置(Linuxの流儀)

tar.gz を解凍し、/opt ディレクトリへ配置します。

# 以前の残骸があれば消す
sudo rm -rf /opt/antigravity

# 解凍して移動
tar -xzf Antigravity-linux-x64.tar.gz
sudo mv Antigravity /opt/antigravity

# 実行権限の確認
sudo chmod -R 755 /opt/antigravity

Step 3: 優先度を考慮したシンボリックリンク作成

ここが最重要です。WSL の shim (/bin/antigravity) よりも優先される場所、つまり /usr/local/bin にリンクを貼ります。

sudo ln -sf /opt/antigravity/bin/antigravity /usr/local/bin/antigravity

確認のため、以下のコマンドを打ちます。

hash -r
which -a antigravity

期待される出力:

/usr/local/bin/antigravity  <-- これが一番上にあればOK
/bin/antigravity            <-- Windows版へのshim(無視される)
/usr/bin/antigravity        <-- apt版(存在してはいけない)

Step 4: 依存関係の解決(Electron系あるある)

Antigravity は Electron (Chromium) ベースであるため、起動時にライブラリ不足のエラー(error while loading shared libraries: libnss3.so など)が出ることがあります。
必要なライブラリをまとめて入れます。

sudo apt update
sudo apt install -y \
  libnss3 \
  libatk1.0-0 \
  libatk-bridge2.0-0 \
  libasound2 \
  libgtk-3-0 \
  libxss1 \
  libgbm1 \
  libdrm2 \
  libxdamage1 \
  libxrandr2 \
  libxkbcommon0

Step 5: 起動確認

antigravity

これで「Windows版を使え」という警告が出ず、GUI アプリケーションとして起動すれば成功です!


🧩 技術的な深掘り:なぜこんなことが起きるのか?

なぜ apt 版はわざわざ使いにくくなっているのでしょうか?
そして、なぜ Windows 版が勝手に優先されるのでしょうか?

1. 開発元の推奨構成

Google等の開発元が推奨する構成は以下の通りです。

  • GUI アプリ: Windows 側にインストール
  • 実行環境: WSL Remote で接続

VS Code と同様、Antigravity も「Windows アプリから WSL に接続する」というアーキテクチャが公式推奨です。そのため、apt パッケージには「WSL で実行されたら、ユーザーに Windows 版を使うよう誘導する」スクリプトが仕込まれています。

2. WSL の Interop 機能の副作用

WSL は利便性のため、/init プロセスが Windows の PATH 環境変数を Linux 側にインポートし、さらに binfmt_misc を使って Windows バイナリを実行可能にします。


🏁 まとめ

WSL2 で「なんか Linux 版のツールが遅い」「Windows 版を使えと怒られる」という現象に出会ったら、以下を疑ってください。

  1. apt / deb パッケージが WSL 対策されたラッパーではないか?
  2. which -a コマンド名 で、Windows 側の EXE が優先されていないか?

解決策はシンプル。「tar.gz 版を /opt に入れ、/usr/local/bin にリンクを貼る」。
これで快適な Linux ネイティブ開発環境が手に入ります。

Discussion