Reference: environment & setup

Environment variables

Variable	Purpose
XPP_AOT_ROOT	Explicit AOT root override — wins over every other resolution path

App data locations

Path	Contents
%APPDATA%\xpp-studio	Settings, per-root state — survives install/uninstall
%APPDATA%\xpp-studio\aot-index\<hash>.db	Per-root persisted index (delete to force a clean rebuild)
<companion>/.xppstudio/debug.json	C# companion debug launch/attach configs (versioned, non-secret)

Toolchain prerequisites (on the D365 VM)

Requirement	Used by	Detected how
xppc.exe (D365 compiler)	Build Model, packaging, CI Build stage	Compile-bridge status segment
d365fo.tools (Invoke-D365DbSync)	Deploy pipeline DB sync	Auto-detected
Administrator rights	Deploy pipeline (DB sync + iisreset)	Checked up front — fails fast with a clear message
.NET SDK	C# companion builds, dotnet test	Companion build path

Root resolution order

1. XPP_AOT_ROOT environment variable
2. File → Open AOT folder… (persisted)
3. Default: samples/ (dev builds) or an empty per-user folder (packaged app)