This page doesn’t try to be a complete porting guide, just a collection of the learnt approaches during porting Python packages and 3rd party libraries.
Common issues
Start with x86/x64 build as a reference and understand the "clean" build flow if possible, before trying to fix it on win-arm64.
There are cases where Windows related packages are released, but still not all tests are passing and these are suppressed on CI.
Historically Windows used to be equal to x86/x64, so Intel specific HW features are default enabled.
xmmintrin.h(27,1): fatal error C1189: #error: This header is specific to X86 and X64 targets -> Intel Streaming SIMD Extensions (SSE) HW feature is turned on, as wrong platform was selected by one of the compiler switches.
Does the project include a Visual Studio project?
Open with VS and add ARM as new platform and try to build it.
Does the project include Arm assembly source file that could be reused for win-arm64?
MSVC compiler doesn’t call preprocessor for assembly files, like LLVM, so that should be done explicitly.
Example: https://github.com/mesonbuild/wrapdb/pull/205/commits/da6a13fb61f64baca0567763c51efaed9b14c41f
Python related tips
Tests
Is there a test folder with test pythons scripts, but no hint how to run them?
Try install pytest and run this:
pytest <test directory>
Is vcvars.bat called some of the inner scripts and not setuptools or distutils?
Example: Example: https://github.com/mesonbuild/meson/pull/9409/commits/466ad78239e0f30bed16c40b863a79dc1a80b4b0
Don’t you find where is it defined?
Try to search for
vcvarsorvc_arch
Do you want to change the invoked toolchain (for example try x64/arm64 instead of the default x86/arm64) and it’s not set by the project?
Keep in mind, that even if you’re working within venv, still the installed Python directory is used for setuptools and distutils