From 4509e9b460f159cfebc8ad2ef66b4caa48dcdad2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Henrik=20Rydg=C3=A5rd?= Date: Wed, 30 Sep 2026 10:57:55 -0600 Subject: [PATCH] docs: UWP build command, and the x86-hosted compiler PCH failure on ARM64 Co-Authored-By: Claude Opus 5.5 (1M context) --- docs/building.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/building.md b/docs/building.md index f6f06fc631..46443f1a13 100644 --- a/docs/building.md +++ b/docs/building.md @@ -69,6 +69,21 @@ bug, since CI runs the equivalent of `UnitTest.exe all` on every commit across m platforms without apparent issue. If `all`/`Jit` hangs in your environment, run every other test by name instead (skip `Jit`) to still get real coverage. +## UWP build + +UWP has its own solution, `UWP\PPSSPP_UWP.sln`. Build the app with `/t:PPSSPP_UWP` (or a single +library such as `/t:CoreUWP`), same MSBuild setup as above: + +```powershell +& $msbuild "UWP\PPSSPP_UWP.sln" /t:PPSSPP_UWP /p:Configuration=Debug /p:Platform= /p:PreferredToolArchitecture=arm64 /m +``` + +On an ARM64 host, pass `/p:PreferredToolArchitecture=arm64`. Without it the UWP +projects use the 32-bit x86-hosted compiler (`bin\HostX86\arm64\CL.exe`), which runs emulated and +can't map the precompiled headers into its address space. Every file then fails at line 1 with +`C3859: Failed to create virtual memory for PCH` and `C1076: compiler limit: internal heap limit +reached`. That looks like running out of memory, but lowering `/m` or `CL_MPCount` doesn't help. + ## Android assets The APK's `assets/` directory is the repo-root `assets/` directory, wired up by