Skip to content

Commit

Permalink
Update for-Windows-on-Linux info in README
Browse files Browse the repository at this point in the history
  • Loading branch information
isatsam authored Oct 1, 2024
1 parent 3593fe4 commit 63bdb6b
Showing 1 changed file with 6 additions and 1 deletion.
7 changes: 6 additions & 1 deletion Development.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,16 @@ VFS Explorer is built using [PyInstaller](https://pyinstaller.org/en/stable/) an

To generate a binary file for your system, use: `pyinstaller ./build/build.spec`

### Building for Windows from a Linux system
For developers on Linux trying to generate a Windows binary, Wine can be used for this purpose, and [this tutorial](https://www.makeworld.space/2021/10/linux-wine-pyinstaller.html) by makeworld.space has proven working for VFS Explorer. In short:
1. Download latest Python release for Windows from python.org
2. Run the installer through `wine`. Check the "install in PATH" box, select a customised installation, and check "Install for all users". You can additionally change Python directory to something more convenient; it will be `C:\\Program Files\\Python312`
3. Use your wine's new Python installation to install requirements through pip, then to run pyinstaller with the provided .spec file (the commands are the same, you just need to specify `wine C:\\path\\to\\python` in the beginning)
3. Use your wine's new Python installation to install requirements through pip: `wine C:\\Program\ Files\\Python312\\python.exe -m pip install -r requirements.txt`
4. Run pyinstaller: `wine C:\\Program\ Files\\Python312\\Scripts\pyinstaller.exe build.spec`
5. Open the produced executable through Wine and verify that it works.
NOTE: This method is not officially supported. If something suddenly stops working (especially after a Wine or a Python update), consider outsourcing dev builds to our Github Actions.

### MacOS
We additionally should try to keep (build_macos.spec)[./vfs_explorer/build/build_macos.spec] up-to-date, even though we don't currently use it or provide MacOS builds; this lack of support comes from Apple's draconian fees for the independent developer account, which is mandatory for certifying applications and making them easy to run on any MacOS system. If this is something you believe you can assist the project with, please open an issue.

# Localization
Expand Down

0 comments on commit 63bdb6b

Please sign in to comment.