diff --git a/Building-for-Windows.md b/Building-for-Windows.md index 542ac65..1e495a9 100644 --- a/Building-for-Windows.md +++ b/Building-for-Windows.md @@ -1,6 +1,5 @@ ## Prerequisites -- Windows 7 SP1 or higher, 64-bit version -- [Visual Studio 2019](https://www.visualstudio.com/downloads/) +- [Visual Studio 2022](https://www.visualstudio.com/downloads/) - You can use any edition of VS (Community Edition is free) - Easiest to just choose "Desktop development with C++" workload - However, minimum required to get source and build are: @@ -8,7 +7,7 @@ - C++ core features - Latest MSVC C++ build tools (x64/x86 and/or ARM64) - Latest Windows SDK - - C++ CMake tools for Windows + - C++ CMake tools for Windows (if using cmake) - Recommended for development / debugging (included in workload) - Just-In-Time debugger - C++ profiling tools (pulls in graphics debugging features) @@ -17,17 +16,43 @@ To install all of the above on the command line, you can use something like: `vs_Community.exe --passive --add Microsoft.VisualStudio.Workload.NativeDesktop;includeRecommended --add Microsoft.VisualStudio.Component.Git --add Microsoft.VisualStudio.Component.VC.Tools.ARM64` -## Get and Build Dolphin -### Clone -* Windows requires pulling in some submodules, so use `git clone --recursive` to clone dolphin from the main repo or your fork. +## Clone Dolphin +* Building on Windows requires pulling in some submodules, so use `git clone --recursive` to clone dolphin from the main repo or your fork. * If you have already cloned the directory *without* pulling in the submodules run ``git submodule update --init`` to initialize the submodules. -### Building -1. Open the folder you cloned Dolphin into. - ![Open Folder](https://i.imgur.com/qkpG1sV.png) - ![Folder](https://i.imgur.com/iz9KUSH.png) -2. Select the target you'd like to build: - ![Target Example](https://i.imgur.com/KRW6XJQ.png) -3. Select ``Dolphin.exe`` as a startup item - ![Select Startup Item](https://i.imgur.com/TsHeHvt.png) -4. Press F7 or choose Build > Build Solution from the menu bar. \ No newline at end of file +## Building +Dolphin can be built with msbuild or cmake. Both msbuild and cmake are supported from Visual Studio (or other IDEs, like VS Code) as well as command line. The following assume Dolphin was cloned into `c:\src\dolphin`. + +### Build in Visual Studio from GUI with msbuild (recommended) +1. Open `Source\dolphin-emu.sln` with Visual Studio +1. Configure build target (e.g. x64 / Release) +1. Press F7 or choose `Build > Build Solution` from the menu bar + +### Build in Visual Studio from GUI with cmake +1. Open the folder Dolphin was cloned into with Visual Studio + * From the cmdline: `c:\src\dolphin>devenv .` +1. Configure build target (e.g. Release) +1. Select ``Dolphin.exe`` as startup item +1. Press F7 or choose `Build > Build Solution` from the menu bar + +### Build in VS Code with cmake +1. Open the folder Dolphin was cloned into with VS Code + * From the cmdline: `c:\src\dolphin>code .` +1. Install and use the [CMake Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools) extension. + +### Command line +First, bring msvc tools into your environment. +* For example: `c:\src\dolphin>"c:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat" x64` + +#### Build with msbuild +``` +c:\src\dolphin>msbuild -v:m -m -p:Platform=x64,Configuration=Release Source\dolphin-emu.sln +``` + +#### Build with cmake +``` +cd c:\src\dolphin +mkdir build && cd build +cmake .. -GNinja +ninja +``` \ No newline at end of file