felixmaker / thunk

Build Rust program to support Windows XP, Vista and more

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Use Thunk to build your Rust program to support old Windows platforms

中文自述文件

Thunk uses VC-LTL5 and YY-Thunks to build programs that support even Windows XP. So, how does it work?

  • Add VC-LTL to the library search path
  • Use YY-Thunks to remedy API that old platform that does not exist

Note: Thunk does not guarantee the compiled program work or work accurately on old platforms. USE AT YOUR OWN RISK!

Usage (As Command line tool)

Preparation (Manual)

Download VC-LTL5 and YY-Thunks Binary, unzip them and add environment variable:

Binary Environment Variable
VC-LTL-XXX-Binary.7z VC_LTL
YY-Thunks-XXX-Binary.zip YY_THUNKS

Then add Thunk to run path.

Preparation (Scoop)

You can just install with scoop:

scoop bucket add felixmaker 'https://github.com/felixmaker/scoop-felixmaker'
scoop install felixmaker/thunk

Sample 1. Build for Windows XP

cargo new build_for_xp
cd build_for_xp
thunk --os xp --arch x86 -- --release

Sample 2. Build a shared library for Windows XP

cargo new build_for_xp
cd build_for_xp
thunk --os xp --arch x86 --lib -- --release

Show help

Use the following command to show help:

thunk.exe --help

Note: In order to distinguish the program build by Thunk, Thunk builds the release in ./target/*_build.

Usage (As Library)

Step1: Ensure command line tools curl and 7z could be found in PATH. (Needed if VC_LTL and YY_THUNKS not found in environment variables)

Step2: Add thunk as a build dependency:

cargo add thunk-rs --build

Step3: Create a build script build.rs:

fn main() {
    thunk::thunk();
}

Then, your program should run on Windows XP. See thunk-rs.

Todo list

  • Windows XP x86
  • Windows XP x64
  • Windows Vista x86
  • Windows Vista x64
  • Windows 7 x86 (v0.3.2)
  • Windows 7 x64 (v0.3.2)
  • Windows 8 x86 (v0.3.2)
  • Windows 8 x64 (v0.3.2)
  • Windows 10 x86 (v0.3.2)
  • Windows 10 x64 (v0.3.2)
  • Only VC-LTL
  • Scoop bucket

Thanks

About

Build Rust program to support Windows XP, Vista and more

License:MIT License


Languages

Language:Rust 100.0%