Setup
Prerequisites
To launch
- Developer Mode enabled
- Windows 10 (or later)
- Windows App SDK
- Visual Studio 2022 OR WinDbg (for debugging if needed)
- Visual C++ Redistributables (unsure which are needed)
- Graphics Tools (from
Settings > Apps > Optional Features
(Windows 10) orSettings > System > Optional Features
(Windows 11)) - The latest release/artifact
To build
- Everything from the launch requirements (except for the release/artifact)
- Windows 10 (or later)
- Windows App SDK
- Visual Studio 2022
- Git
- Windows 11 SDK version 10.0.17134.0 or later
- The following from the Visual Studio Installer
- Desktop Development with C++
- Windows Application Development
- MSVC (143) C++ Build Tools
- C++ (143) Universal Windows Platform Tools
- .NET Desktop Development
- Game Development with C++
- The project cloned to a folder
Running the package
To run the package, you need to setup the Launch prerequisites and have already registered the package.
You'll need to also copy in all the DLLs from the latest release/artifact into your app's Mount folder (the folder that has the EXE).
After that, you just need to open the app through the start menu. (or other preferred way of running UWP apps)
Registering the UWP package
You cannot normally run a UWP app's EXE file directly, instead you have to register the UWP app and launch it from the Start Menu/a Debugger.
- Enable Developer Mode
- Go to the Mount folder of your game (where the EXE sits)
- Open Powershell.exe to that directory
- Run
Add-AppXPackage -Register .\AppxManifest.xml
Enabling Developer Mode
To register UWP apps, you have to enable Developer Mode.
- Go to For Developers in Settings (path differs depending on Windows version, read below)
- Settings > Windows Update > For Developers (Windows 10)
- Settings > System > For Developers (Windows 11)
- Enable Developer Mode
Building
Clone the repo
git clone --recursive https://github.com/WinDurango/WinDurango.git
Open the project solution in Visual Studio
- If you get a message asking about upgrading projects, press continue.
TODO: DO THE REST SINCE THIS CHANGED LOTS
Generate and copy the following IDLs into
/dlls/winrt_x/External
- Windows.Xbox.ApplicationModel.State.idl (656kB)
- Windows.Xbox.ApplicationModel.State.Internal.idl (33,379kB)
- Windows.Xbox.ApplicationModel.Store.idl (10,655kB)
- Windows.Xbox.idl (3,316kB)
- Windows.Xbox.Input.idl (53,430kB)
- Windows.Xbox.Management.Deployment.idl (53,430kB)
- Windows.Xbox.Management.idl (68,873kB)
- Windows.Xbox.Media.idl (516kB)
- Windows.Xbox.Shell.idl (33,135kB)
- Windows.Xbox.Shell.Social.idl (3,030kB)
- Windows.Xbox.System.idl (833kB)
- Windows.Xbox.Achievements.idl (29,850kB)
Build the project
- Note: You may need to build the Detours separately.
- You can build any part of the project by selecting individual solution(s), right-clicking, and clicking "Build Selection"
Other
Generating IDLs from WinMDs
TODO
Contributing
TODO