docs(windows): add WSL development workflow section

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
pull/12772/head
244t 2026-05-22 20:18:45 +09:00
parent e48b288fc7
commit 69f35447c4
1 changed files with 20 additions and 0 deletions

View File

@ -94,6 +94,26 @@ W1(配線・骨格)→ W2(空ウィンドウが出る所まで)→ W3(GL でタ
`zig build -Dtarget=x86_64-windows-msvc -Dapp-runtime=windows`
- 当面は `zig build``.exe` を生成 → 直接実行。
## WSL で開発する場合
WSL(WSL2)を母艦に Windows 移植を開発することも可能。native Windows との
差は実質「`xwin` セットアップ1回」だけ。
- **Claude Code**: WSL2 で完全サポート(full Bash + サンドボックス)。
- **編集**: 問題なし。
- **ビルド(クロスコンパイル)**: WSL(Linux)から
`zig build -Dtarget=x86_64-windows-msvc` で Windows 向け `.exe` を生成できる。
MSVC ABI は Windows SDK / MSVC ライブラリを要するため、`xwin`
(github.com/Jake-Shadle/xwin)で一度だけ取得して Zig に渡す。
- 代替: `src/build/Config.zig` の MSVC ABI 強制を exe ビルドでは
`windows-gnu` に緩めれば、Zig が完全自己完結なので `xwin` 不要。
libghostty-vt を MSVC リンカで使う用途が無いならこちらが楽。
- **実行・テスト**: WSL2 の interop で、生成した `term244.exe` を WSL シェルから
そのまま起動できる(Windows 側で実行され、ウィンドウは Windows デスクトップに
出る)。ビルド→実行ループはこれで回せる。
- **デバッグ**: 深い Win32 のデバッグはネイティブ Windows のツール
(Visual Studio デバッガ等)の方が楽。要所だけ native 側で確認するとよい。
## 参考資料
- **Win32 ウィンドウ/入力層(W2)**: WezTerm(Rust, MIT)— 独自ウィンドウ層を