first commit

2026-08-06 15:18:27 +08:00
commit a5a73d76d1
37 changed files with 2697 additions and 0 deletions
@@ -0,0 +1,58 @@
+# Sensor Bench EXE Build
+
+This folder contains the Windows PyInstaller build setup for Sensor Bench.
+
+## Requirements
+
+- Windows x64
+- Anaconda or Miniconda available as `conda`
+- Python 3.10 build environment
+- Internet access to install `orisys` from PyPI
+
+The build installs `orisys` from PyPI. Do not use `PYTHONPATH` or an editable `orisys-sdk` checkout for release builds.
+
+## Build
+
+From the repository root (cmd or PowerShell):
+
+```bat
+.\build\create_env.bat
+.\build\build_exe.bat
+```
+
+The `.bat` wrappers bypass the local PowerShell execution policy. If you prefer calling PowerShell directly:
+
+```bat
+powershell -NoProfile -ExecutionPolicy Bypass -File .\build\create_env.ps1
+powershell -NoProfile -ExecutionPolicy Bypass -File .\build\build_exe.ps1
+```
+
+Output:
+
+```text
+dist/SensorBench/SensorBench.exe
+```
+
+The build is `onedir` rather than `onefile` so startup is faster and bundled DLL/resource issues are easier to diagnose.
+
+## Validation
+
+The build script runs:
+
+```powershell
+python tests/test_smoke.py
+python build/verify_dist.py
+```
+
+Manual hardware check:
+
+1. Run `dist\SensorBench\SensorBench.exe`.
+2. Confirm the UI opens without setting `PYTHONPATH`.
+3. Confirm the UI defaults to Simplified Chinese and can switch to English.
+4. Confirm Orisys status is available and fixed mode shows DDJX01.
+5. Use Next / Revert / New Sample Reset on the left workflow panel.
+6. Start preview with camera index `0`.
+7. Confirm raw preview and processed preview update.
+8. Record a short clip and verify it appears under `dist\SensorBench\recordings`.
+
+Locale files are bundled under `_internal/config/locales/` (and can also be placed beside the EXE under `config/locales/` for overrides). Edit those JSON files to change operator-facing text without rebuilding.