Updated Building for Windows (markdown)
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
|
||||||
|
|
Loading…
Reference in New Issue