Skip to content
chinhodado edited this page Jan 7, 2015 · 23 revisions

Minimal Dependencies

On Windows, all light-weight dependencies are automatically included within the "externals" folder. To build the minimalist Citra (no Qt debugger), you simply need to install:

  • Visual Studio 2013 Community.
  • CMake - Used to generate Visual Studio project files.
  • Git - I recommend msysgit. While installing it, you can 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 executable is, since it's used to include version info into the built executable.

Debugger Dependencies

For the debugger/Qt GUI, you'll need to install Qt 5:

  • Download the Qt Online installer and launch it. When asked which components to install, select the msvc2013 OpenGL version for the processor architecture of your choice. (Be careful to use the OpenGL versions, or Citra will fail to initialize.) You might also want to install Qt Designer if you plan on modifying Citra's user interface.
  • Optionally, set your QTDIR environment variable to the directory which contains the bin, include and lib folders. (e.g. C:\Qt\5.4\msvc2013_64_opengl) This will avoid the need to manually set them in CMake.
  • For running Citra builds, you'll need to have icudt53.dll, icuin53.dll, icuuc53.dll, Qt5Core.dll, Qt5Gui.dll, Qt5OpenGL.dll and Qt5Widgets.dll in either the application directory or in the system PATH. By default, those files are in C:\Qt\5.4\msvc2013_64_opengl\bin. For debug builds use the dlls with a 'd' appended to the name. (e.g. Qt5Cored.dll)
  • You might also need platforms/qwindows.dll in the application directory. It can be found in C:\Qt\5.4\msvc2013_64_opengl\plugins\platforms. For the debug version use qwindowsd.dll.

Cloning Citra in Git:

git clone --recursive https://github.com/citra-emu/citra.git
cd citra

Building

  • Open cmake-gui and point it to the Citra source code (the citra root directory, not the src sub-directory).
    • 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 12 2013" or "Visual Studio 12 2013 Win64".
    • Check if CMake detected all libraries and paths correctly and, if necessary, make any adjustments and click "Configure" again.
      • Qt 5.3 is known to fail at this step. Make sure you have at least 5.3.1.
    • Click "Generate" to create the project files.
  • Open the solution file (citra.sln) in Visual Studio 2013
    • Depending on which frontend (GLFW or Qt) you want to build or run, select "citra" or "citra-qt" in the Solution Explorer, right-click and "Set as StartUp Project".
    • Press F5 or select Build → Rebuild Solution in the menu.

Clone this wiki locally