Skip to content

Commit adf837b

Browse files
committed
Add Windows 7 compatibility documentation to README
close #2
1 parent dc923ea commit adf837b

File tree

2 files changed

+58
-1
lines changed

2 files changed

+58
-1
lines changed

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,4 +89,5 @@ You also can use the command line to run the project.
8989
## Others
9090

9191
- [Release and Product Version Control](docs/publish.md)
92-
- [Internationalization](docs/i18n.md)
92+
- [Internationalization](docs/i18n.md)
93+
- [Windows 7 Compatibility](docs/windows7.md)

docs/windows7.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
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

Comments
 (0)