|
| 1 | +# Windows 7 Compatibility |
| 2 | + |
| 3 | +## Feature Integrity |
| 4 | + |
| 5 | +Due to system limitations on Windows 7, some features cannot be fully enabled on this platform. |
| 6 | +The following list summarizes the confirmed missing or limited functionalities: |
| 7 | + |
| 8 | +### Theme-Related |
| 9 | + |
| 10 | +- System theme synchronization is **not supported**; only manual switching between light and dark themes is available. |
| 11 | + |
| 12 | +- **HiDPI** (High DPI) display support is unavailable. |
| 13 | + |
| 14 | + |
| 15 | +### Internationalization (I18N) String Collection |
| 16 | + |
| 17 | +- Some older versions of **PySide6** do **not include** the `lupdate` executable, which prevents automatic collection of translation strings (generation of `.ts` files). |
| 18 | + |
| 19 | +- **Workaround:** |
| 20 | + Add the directory containing your custom `lupdate` executable to the system `PATH` environment variable, so that `pyside-cli` can detect it properly. |
| 21 | + |
| 22 | + |
| 23 | +### Nuitka Build Backend |
| 24 | + |
| 25 | +- Compilation and packaging with Nuitka are theoretically possible, but the generated applications **may fail to run properly** on Windows 7. |
| 26 | + |
| 27 | + |
| 28 | +--- |
| 29 | + |
| 30 | +## Usage Notes |
| 31 | + |
| 32 | +This project provides **PyInstaller** as a compatibility build backend for Windows 7. |
| 33 | +You can enable this mode by adding the `--backend pyinstaller` flag when running commands: |
| 34 | + |
| 35 | +```bash |
| 36 | +uv run pyside-cli --all --onefile --backend pyinstaller --low-perf |
| 37 | +``` |
| 38 | + |
| 39 | +### Build Recommendations |
| 40 | + |
| 41 | +Packaging on Windows 7 may encounter toolchain incompatibility issues. |
| 42 | +It is recommended to follow one of the approaches below: |
| 43 | + |
| 44 | +1. **Preferred approach:** |
| 45 | + Perform development and builds on a newer Windows platform, then test on the target Windows 7 system. |
| 46 | + |
| 47 | +2. **Alternative approaches:** |
| 48 | + |
| 49 | + - Downgrade specific toolchain versions to regain compatibility. |
| 50 | + |
| 51 | + - Use compatibility layers such as [VxKex](https://github.com/i486/VxKex) to run build tools. |
| 52 | + |
| 53 | + |
| 54 | +Additionally, since Windows 7 often runs on older hardware, |
| 55 | +it’s recommended to include the `--low-perf` flag in your build command to disable certain high-performance features, |
| 56 | +improving overall stability and compatibility. |
0 commit comments