yuzu-emu/yuzu
1
0
Fork 0
mirror of https://github.com/yuzu-emu/yuzu.git synced 2024-11-22 18:45:38 +01:00
Code Issues Packages Projects Releases Wiki Activity

Typographical changes

Mat M 2018-01-18 12:32:06 -05:00
parent c539b4309a
commit f289334701
1 changed files with 52 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
Building-for-Windows.md

@ -1,41 +1,52 @@
## MSVC Build for Windows ## 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 simply need to install:
* **[Visual Studio 2017 Community](https://www.visualstudio.com/products/visual-studio-community-vs)** - **Make sure to select C++ support in the installer**. * **[Visual Studio 2017 Community](https://www.visualstudio.com/products/visual-studio-community-vs)** - **Make sure to select C++ support in the installer**.
* **[CMake](http://www.cmake.org/cmake/resources/software.html)** - Used to generate Visual Studio project files. * **[CMake](http://www.cmake.org/cmake/resources/software.html)** - Used to generate Visual Studio project files.
![2](https://i.imgur.com/S1NH63P.png) ![2](https://i.imgur.com/S1NH63P.png)
* **Git** - We recommend [msysgit](http://msysgit.github.io/). * **Git** - We recommend [msysgit](http://msysgit.github.io/).
![3](http://i.imgur.com/joCBhIB.jpg) ![3](http://i.imgur.com/joCBhIB.jpg)
* While installing Git Bash, you should tell it to include Git in your system path. (Choose the "Use Git from the Windows Command Prompt" option.) If you missed that, don't worry, you'll just have to manually tell CMake where your git.exe is, since it's used to include version info into the built executable. * While installing Git Bash, you should tell it to include Git in your system path. (Choose the "Use Git from the Windows Command Prompt" option.) If you missed that, don't worry, you'll just have to manually tell CMake where your git.exe is, since it's used to include version info into the built executable.
![4](http://i.imgur.com/th8sFud.jpg) ![4](http://i.imgur.com/th8sFud.jpg)
### Cloning yuzu with Git
### Cloning yuzu in Git: ```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
``` ```
![9](https://i.imgur.com/xq15xTB.png) ![9](https://i.imgur.com/xq15xTB.png)
NOTE: yuzu by default downloads to C:\Users\<user-name>\yuzu NOTE: yuzu by default downloads to C:\Users\<user-name>\yuzu
### Building ### Building
* Open cmake-gui and point it to the yuzu directory. Default: C:\Users\<user name>\yuzu * Open cmake-gui and point it to the yuzu directory. Default: C:\Users\<user name>\yuzu
![10](https://i.imgur.com/YKmNs1p.png) ![10](https://i.imgur.com/YKmNs1p.png)
![11](https://i.imgur.com/SWxOVKB.png) ![11](https://i.imgur.com/SWxOVKB.png)
* For the build directory, use a `build/` subdirectory inside the source directory or some other directory of your choice. (Tell CMake to create it.) * For the build directory, use a `build/` subdirectory inside the source directory or some other directory of your choice. (Tell CMake to create it.)
* Click the "Configure" button and choose "Visual Studio 15 2017 Win64" * Click the "Configure" button and choose "Visual Studio 15 2017 Win64"
![12](http://i.imgur.com/RvVcyCP.jpg) ![12](http://i.imgur.com/RvVcyCP.jpg)
* When CMake gives you an error, find the YUZU_USE_BUNDLED_SDL2 and YUZU_USE_BUNDLED_QT options on the list and check their respective checkboxes. Click configure again. CMake will now download the required libraries. * When CMake gives you an error, find the YUZU_USE_BUNDLED_SDL2 and YUZU_USE_BUNDLED_QT options on the list and check their respective checkboxes. Click configure again. CMake will now download the required libraries.
![13](https://i.imgur.com/BX3Ek4h.png) ![13](https://i.imgur.com/BX3Ek4h.png)
![14](https://i.imgur.com/K2E8y8s.png) ![14](https://i.imgur.com/K2E8y8s.png)
* NOTE: If you used github's own app to clone, run "git submodule update --init --recursive" to get remaining dependencies.
* NOTE: If you used GitHub's own app to clone, run `git submodule update --init --recursive` to get the remaining dependencies.
* Click "Generate" to create the project files. * Click "Generate" to create the project files.
![15](http://i.imgur.com/CkZgD4p.jpg) ![15](http://i.imgur.com/CkZgD4p.jpg)
@ -62,24 +73,27 @@ Feel free to ask us in the IRC channel #yuzu @ [Freenode](https://webchat.freeno
## MinGW-w64 Build with MSYS2 ## MinGW-w64 Build with MSYS2
### ***NOTE THAT THESE INSTRUCTIONS ARE FOR CITRA AND ARE LIKELY OUTDATED FOR YUZU. EXPECT TO HAVE TO FIX UNICORN LINKING *** :warning: Note that these instructions are for citra and are likely outdated for yuzu. Expect to have to fix unicorn linkage issues.
### Prerequisites to install
#### Prerequisites to install
* [MSYS2](http://msys2.github.io/) * [MSYS2](http://msys2.github.io/)
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` * 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`
#### Clone the yuzu repository with git. ### Clone the yuzu repository with Git
* `git clone --recursive https://github.com/yuzu-emu/yuzu.git` * `git clone --recursive https://github.com/yuzu-emu/yuzu.git`
* `cd yuzu` * `cd yuzu`
#### Run the following commands to build yuzu (dynamic linked build) ### Run the following commands to build yuzu (dynamic linked build)
```bash
```cmd
mkdir build && cd build mkdir build && cd build
cmake -G "MSYS Makefiles" -DCMAKE_BUILD_TYPE=Release .. cmake -G "MSYS Makefiles" -DCMAKE_BUILD_TYPE=Release ..
make -j4 make -j4
@ -87,33 +101,35 @@ make -j4
./bin/yuzu-qt.exe ./bin/yuzu-qt.exe
``` ```
##### Note! This build is not a static build meaning that you need to include all of the dlls with the exe in order to use it. **Note! This build is not a static build meaning that you need to include all of the dlls with the exe in order to use it.**
#### 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
## Clang build using clang-cl ## Clang build using clang-cl
:warning: This section is outdated and may not work :warning: This section is outdated and may not work
#### Prerequisites to install ### Prerequisites to install
* **[LLVM](http://releases.llvm.org/download.html#3.9.0)** - The clang compiler * **[LLVM](http://releases.llvm.org/download.html#3.9.0)** - The clang compiler
* **[Visual Studio 2015 Community](https://www.visualstudio.com/products/visual-studio-community-vs)** - **Make sure to select C++ support in the installer**. * **[Visual Studio 2015 Community](https://www.visualstudio.com/products/visual-studio-community-vs)** - **Make sure to select C++ support in the installer**.
* **[CMake](http://www.cmake.org/cmake/resources/software.html)** - Used to generate Visual Studio project files. * **[CMake](http://www.cmake.org/cmake/resources/software.html)** - Used to generate Visual Studio project files.
* **Git** - We recommend [msysgit](http://msysgit.github.io/). * **Git** - We recommend [msysgit](http://msysgit.github.io/).
Follow the installers instructions. Follow the installers instructions.
#### Clone the yuzu repository with git. ### Clone the yuzu repository with Git
* `git clone --recursive https://github.com/yuzu-emu/yuzu.git` * `git clone --recursive https://github.com/yuzu-emu/yuzu.git`
* `cd yuzu` * `cd yuzu`
#### Run the following commands to build yuzu ### Run the following commands to build yuzu
```
```cmd
mkdir build mkdir build
cd build cd build
cmake.exe .. -TLLVM-vs2014 -G"Visual Studio 15 2017 Win64" -Dyuzu_USE_BUNDLED_SDL2=1 -Dyuzu_USE_BUNDLED_QT=1 -DYUZU_USE_BUNDLED_UNICORN=1 -DCMAKE_BUILD_TYPE=Release cmake.exe .. -TLLVM-vs2014 -G"Visual Studio 15 2017 Win64" -Dyuzu_USE_BUNDLED_SDL2=1 -Dyuzu_USE_BUNDLED_QT=1 -DYUZU_USE_BUNDLED_UNICORN=1 -DCMAKE_BUILD_TYPE=Release