Updated Building for Windows (markdown)

Margen67 2020-02-24 20:39:06 -08:00
parent 5169fca9b3
commit bae18efc78

@ -1,17 +1,17 @@
## THIS GUIDE IS INTENDED FOR DEVELOPERS ONLY, SUPPORT WILL ONLY BE GIVEN IF YOU'RE A DEVELOPER. # THIS GUIDE IS INTENDED FOR DEVELOPERS ONLY, SUPPORT WILL ONLY BE GIVEN IF YOU'RE A DEVELOPER.
## Method I: MSVC Build for Windows ## Method I: MSVC Build for Windows
### Minimal Dependencies ### Minimal Dependencies
On Windows, all library dependencies are automatically included within the "externals" folder or can be downloaded on-demand. To build yuzu, you simply need to install: On Windows, all library dependencies are automatically included within the `externals` folder, or can be downloaded on-demand. To build yuzu, you need to install:
* **[Visual Studio 2019 Community](https://visualstudio.microsoft.com/downloads/)** - **Make sure to select C++ support in the installer.** * **[Visual Studio 2019 Community](https://visualstudio.microsoft.com/downloads/)** - **Make sure to select C++ support in the installer.**
* **[CMake](https://cmake.org/download/)** - Used to generate Visual Studio project files. Does not matter if either 32-bit or 64-bit version is installed. * **[CMake](https://cmake.org/download/)** - Used to generate Visual Studio project files. Does not matter if either 32-bit or 64-bit version is installed.
![2](https://i.imgur.com/giDwuTm.png) ![2](https://i.imgur.com/giDwuTm.png)
* **Git** - We recommend [Git for Windows](https://gitforwindows.org/). * **Git** - We recommend [Git for Windows](https://gitforwindows.org).
![3](https://i.imgur.com/UeSzkBw.png) ![3](https://i.imgur.com/UeSzkBw.png)
@ -22,15 +22,13 @@ On Windows, all library dependencies are automatically included within the "exte
### Cloning yuzu with Git ### Cloning yuzu with Git
**Master:** **Master:**
``` ```cmd
cmd
git clone --recursive https://github.com/yuzu-emu/yuzu.git git clone --recursive https://github.com/yuzu-emu/yuzu.git
cd yuzu cd yuzu
``` ```
**Mainline (no assert):** **Mainline (no assert):**
``` ```cmd
cmd
git clone --recursive https://github.com/yuzu-emu/yuzu-mainline.git git clone --recursive https://github.com/yuzu-emu/yuzu-mainline.git
cd yuzu-mainline cd yuzu-mainline
``` ```
@ -49,7 +47,7 @@ cd yuzu-mainline
![11](https://i.imgur.com/cNnhs22.png) ![11](https://i.imgur.com/cNnhs22.png)
* Click the "Configure" button and choose "Visual Studio 16 2019", with "x64" for the optional platform. * Click the "Configure" button and choose `Visual Studio 16 2019`, with `x64` for the optional platform.
![12](https://i.imgur.com/DKiREaK.png) ![12](https://i.imgur.com/DKiREaK.png)
@ -58,11 +56,11 @@ cd yuzu-mainline
![15](https://i.imgur.com/5LKg92k.png) ![15](https://i.imgur.com/5LKg92k.png)
* Open the solution file yuzu.sln in Visual Studio 2019, which is located in the build folder. * Open the solution file `yuzu.sln` in Visual Studio 2019, which is located in the build folder.
![16](https://i.imgur.com/208yMml.png) ![16](https://i.imgur.com/208yMml.png)
* Depending if you want a graphical user interface or not ("yuzu" is with a graphical user interface, while "yuzu-cmd" is just the command line version of it), select "yuzu" or "yuzu-cmd" in the Solution Explorer, right-click and "Set as StartUp Project". * Depending if you want a graphical user interface or not (`yuzu` has the graphical user interface, while `yuzu-cmd` doesn't), select `yuzu` or `yuzu-cmd` in the Solution Explorer, right-click and `Set as StartUp Project`.
![17](https://i.imgur.com/nPMajnn.png) ![18](https://i.imgur.com/BDMLzRZ.png) ![17](https://i.imgur.com/nPMajnn.png) ![18](https://i.imgur.com/BDMLzRZ.png)
@ -82,30 +80,30 @@ Feel free to ask us in the IRC channel #yuzu-emu @ [Freenode](https://webchat.fr
* [MSYS2](https://www.msys2.org) * [MSYS2](https://www.msys2.org)
Make sure to follow the instructions and update to the latest version by running `pacman -Syu` as many times as needed. * Make sure to follow the instructions and update to the latest version by running `pacman -Syu` as many times as needed.
### Install yuzu dependencies for MinGW-w64 ### Install yuzu dependencies for MinGW-w64
* Open the "MSYS2 MinGW 64-bit" (mingw64.exe) shell * Open the `MSYS2 MinGW 64-bit` (mingw64.exe) shell
* Download and install all dependencies using: `pacman -S mingw-w64-x86_64-toolchain mingw-w64-x86_64-qt5 mingw-w64-x86_64-SDL2 mingw-w64-x86_64-cmake make git python2` * Download and install all dependencies using: `pacman -S mingw-w64-x86_64-toolchain mingw-w64-x86_64-qt5 mingw-w64-x86_64-SDL2 mingw-w64-x86_64-cmake make git python2`
### Clone the yuzu repository with Git ### Clone the yuzu repository with Git
**Master:** **Master:**
``` ```bash
git clone --recursive https://github.com/yuzu-emu/yuzu.git git clone --recursive https://github.com/yuzu-emu/yuzu.git
cd yuzu cd yuzu
``` ```
**Mainline (no assert):** **Mainline (no assert):**
``` ```bash
git clone --recursive https://github.com/yuzu-emu/yuzu-mainline.git git clone --recursive https://github.com/yuzu-emu/yuzu-mainline.git
cd yuzu-mainline cd yuzu-mainline
``` ```
### Run the following commands to build yuzu (dynamically linked build) ### Run the following commands to build yuzu (dynamically linked build)
```cmd ```bash
mkdir build && cd build mkdir build && cd build
cmake -G "MSYS Makefiles" -DCMAKE_MAKE_PROGRAM=mingw32-make -DCMAKE_BUILD_TYPE=Release .. cmake -G "MSYS Makefiles" -DCMAKE_MAKE_PROGRAM=mingw32-make -DCMAKE_BUILD_TYPE=Release ..
mingw32-make -j4 mingw32-make -j4
@ -117,13 +115,13 @@ mingw32-make -j4
### Building without Qt (Optional) ### Building without Qt (Optional)
Doesn't require the rather large Qt dependency, but you will lack a GUI frontend. Doesn't require the rather large Qt dependency, but you will lack a GUI frontend:
* Pass the `-DENABLE_QT=no` flag to cmake * Pass the `-DENABLE_QT=no` flag to cmake
## Building from the command line with MSVC ## Building from the command line with MSVC
``` ```cmd
git clone --recursive https://github.com/yuzu-emu/yuzu git clone --recursive https://github.com/yuzu-emu/yuzu
cd yuzu cd yuzu
mkdir build mkdir build