OpenPunk/citra
1
0
Fork 0
mirror of https://github.com/citra-emu/citra.git synced 2024-11-22 05:50:06 +00:00
Code Issues Projects Releases Wiki Activity

Updated 6 year old pics

Benas Dorochinas 2023-07-10 16:07:22 +03:00
parent 0e7aed18be
commit 2480a117ff
1 changed files with 31 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
Building-for-Windows.md

@ -6,58 +6,69 @@ On Windows, all library dependencies are automatically included within the "exte
* **[Visual Studio 2022](https://visualstudio.microsoft.com/vs/)** - **Make sure to select C++ support in the installer**.
* **[CMake](https://cmake.org/download/)** - Used to generate Visual Studio project files.
![2](https://i.imgur.com/bUdUruA.png)
* **[Vulkan SDK](https://vulkan.lunarg.com/sdk/home#windows)** - **Make sure to select Latest SDK.**
![2](http://i.imgur.com/vSIXMHd.jpg)
* **Git** - We recommend [Git for Windows](https://gitforwindows.org/).
![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.
![3](https://i.imgur.com/Na1YrHO.png)
* While installing Git Bash, you should tell it to include Git in your system path. (Choose the "Git from the command line and also from 3rd-party software" 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](https://i.imgur.com/DOqoZEL.png)
### Cloning Citra in Git:
#### Master:
```
git clone --recursive https://github.com/citra-emu/citra.git
cd citra
```
![9](http://i.imgur.com/Yb5ahlL.jpg)
NOTE: Citra by default downloads to `C:\Users\<user-name>\citra`
#### Canary:
```
git clone --recursive https://github.com/citra-emu/citra-canary.git
cd citra-canary
```
![9](https://i.imgur.com/OUIJlPM.png)
_(Note: Citra by default downloads to `C:\Users\<user-name>\citra` (Master) or `C:\Users\<user-name>\citra-canary` (Canary)_
### Building
* Open cmake-gui and point it to the Citra directory. Default: `C:\Users\<user name>\citra`
![10](http://i.imgur.com/uFKhnKO.jpg)
![11](http://i.imgur.com/DeafFmS.jpg)
* For the build directory, use a `build/` subdirectory inside the source directory or some other directory of your choice. (Tell CMake to create it.)
* Open the CMake GUI application and point it to the `citra` (Master) or `citra-canary` (Canary) directory.
* Click the "Configure" button and choose "Visual Studio 17 2022 Win64"
![10](https://i.imgur.com/N8d67va.png)
![12](https://github.com/citra-emu/citra/assets/20753089/d1a3b641-d53f-4044-be60-f281ca608fb5)
* For the build directory, use a `build/` subdirectory inside the source directory or some other directory of your choice. (Tell CMake to create it.)
![11](https://i.imgur.com/3b6Bd8i.png)
* Click the "Configure" button and choose `Visual Studio 17 2022`, with `x64` for the optional platform.
![12](https://i.imgur.com/00fxoOr.png)
* NOTE: If you get errors like "XXX does not contain a CMakeLists.txt file" at this step, it means you didn't use the `--recursive` flag in the clone step, or you used tools other than the git CLI. Please run "git submodule update --init --recursive" to get remaining dependencies.
* Click "Generate" to create the project files.
![14](http://i.imgur.com/CkZgD4p.jpg)
![14](https://i.imgur.com/ujO41Oo.png)
* Open the solution file citra.sln in Visual Studio 2022, which is located in the build folder.
![15](http://i.imgur.com/sCWIZcK.jpg)
![15](https://i.imgur.com/v0MRcpl.png)
* Depending on which frontend (SDL2 or Qt) you want to build or run, select "citra" or "citra-qt" in the Solution Explorer, right-click and "Set as StartUp Project".
* Depending on which frontend (SDL2 or Qt) you want to build or run, select "citra" or "citra-qt" in the Solution Explorer, right-click and "Set as Startup Project".
![16](http://i.imgur.com/0Bvz9za.jpg)
![17](http://i.imgur.com/FkuAwd8.jpg)
![16](https://i.imgur.com/kJXBsAc.png)
![17](https://i.imgur.com/ouAYicR.png)
* Select the appropriate build type, Debug for debug purposes or Release for performance (in case of doubt choose the latter).
![18](http://i.imgur.com/Gqifkc0.jpg)
![18](https://i.imgur.com/g6gY1wV.png)
* Press F5 or select Build → Rebuild Solution in the menu.
![19](http://i.imgur.com/7ro9uSB.jpg)
![19](https://i.imgur.com/ElN5BdS.png)
* NOTE: Please refer to [Common Issues](https://github.com/citra-emu/citra/wiki/Common-Issues) if any errors. If you did not find a solution feel free to ask us in the IRC channel: #citra @ [Freenode](https://webchat.freenode.net/).