feat: native host bridge integration — C++ bridge, Rust SHM, JS routing, build scripts, docs

- native_bridge/: InstrumentEngineManager multi-channel, sample-accurate, CC/program/pitchbend, transport, Vst3Instrument stub (HAVE_VST3SDK)
- src-tauri: shm.rs, bridge spawn + audio pump + health monitor, open_vst_gui, externalBin, commands
- app: UnifiedMidiRouter, NativeBridgeService, bridgeAudioNode, audioRoutingEngine, Plugin Manager UI, Bridge/WASM indicator, set_position sync
- build: 3 ps1 (force-added, build/ ignored), verify_bundle --check-bridge, CI workflow
- docs: TASKS.md, TEST_NOTES.md (Windows verify checklist), install/report updates
This commit is contained in:
locpham
2026-08-11 23:37:29 +07:00
parent aae0b05473
commit c3368d0a91
37 changed files with 2970 additions and 80 deletions
+34
View File
@@ -112,6 +112,40 @@ bash build_linux.sh
bash build_macos.sh
```
## 5.2 KIẾN TRÚC 2 SIDECAR (Native Host Bridge — bản 1.2)
Từ bản 1.2, bản desktop chạy **Tauri v2** shell + **2 sidecar** (không còn browser):
```
┌───────────────────────── SonicForgeDAW (Tauri v2) ─────────────────────────┐
│ WebView2 (UI HTML5/JS — app.precompiled.js) │
│ ▲ invoke ▲ bridge-audio (event) │
│ Rust shell (src-tauri) │
│ ├── spawn+watchdog ──► daw_engine.exe (FastAPI sidecar, port 8000) │
│ └── spawn+health ────► daw_vst_bridge.exe (C++ Native Host Bridge) │
│ │ SharedMemory "SonicForge_DAW_IPC" │
│ │ (MidiEventIPC / ControlEventIPC / audio) │
│ └─ FluidSynth / sfizz / VST3 host │
└────────────────────────────────────────────────────────────────────────────┘
```
- **MIDI → âm**: Web MIDI/timeline → `push_midi_event` (Rust ghi SHM) →
bridge render block 256 (FluidSynth/sfizz/VST3) → Rust audio pump emit
`bridge-audio` → WebView2 ScriptProcessor → track FX → master → loa.
- **Fallback**: bridge chết → `SonicSF` (FluidSynth WASM) tự bật, app không crash.
- **YC runtime**: cả `daw_engine.exe` lẫn `daw_vst_bridge.exe` cần VC++ 2015-2022
Redistributable — `hooks.nsh` (NSIS) cài `vc_redist.x64.exe`; MSI không chạy
hooks → máy sạch nên cài NSIS hoặc tự cài redist.
- **Binaries**: engine = `src-tauri/resources/daw_engine/` (bundle.resources),
bridge = `src-tauri/binaries/daw_vst_bridge-x86_64-pc-windows-msvc.exe`
(`bundle.externalBin`).
- **Build bridge**: `build/scripts/build_native_bridge.ps1` (vcpkg fluidsynth/
sfizz + submodule vst3sdk + CMake MSVC) → copy exe vào `src-tauri/binaries/`.
- **API mới**: `GET /api/v1/bridge/status`, `POST /api/v1/bridge/load`,
`GET /api/v1/bridge/log` (engine giữ trung gian IPC file
`%APPDATA%/SonicForgeDAW/ipc/`).
- **Logs**: `%APPDATA%/SonicForgeDAW/logs/spawn.log` (engine+bridge), `bridge.log`.
## 6. CẬP NHẬT
- **Version check**: khi mở app, gọi endpoint version (file `version.json` đóng kèm + so sánh remote) → thông báo bản mới + link tải installer.
- Cập nhật = chạy installer mới (ghi đè, GIỮ NGUYÊN `~/SonicForgeStudio/` — data + soundfonts không đụng).