Skip to content

Building for Windows

Jump to bottom
Bianca van Schaik edited this page Aug 14, 2020 · 4 revisions

You have two main options in how you want to build Julius. You can either:

A. Using Microsoft Visual Studio (64-bit build)

  1. Make sure you have Microsoft Visual Studio installed. Please note that only Visual Studio 2017 (fully updated) or Visual Studio 2019 can be directly used. You need to have C++ CMake tools for Windows installed for Visual Studio that you can install via Visual Studio Installer as an optional package. These instructions assume you are using Visual Studio 2019.

  2. Download the SDL2 development library as a zip file:

    • Open the SDL2 download page
    • In the section Development Libraries, select SDL2-devel-2.0.12-VC.zip (Visual C++ 32/64-bit)

  3. Download the SDL2_mixer development library as a zip file:

    • Open the SDL2_mixer download page
    • In the section Development Libraries, select SDL2_mixer-devel-2.0.4-VC.zip (Visual C++ 32/64-bit)

  4. Extract the SDL2 and SDL2_mixer development libraries to an easy to remember folder (I recommend something like C:\libs).

  5. Open Microsoft Visual Studio. Select Clone or check out code.

    Visual Studio 2019 Startup window

  6. In the Repository location option, type https://github.com/bvschaik/julius.git. In the Local path option, select in which folder you wish the source to be downloaded to. This will be your work folder:

    Visual Studio 2019 Clone or check out code window

    Alternatively, you can obtain the source code without using Visual Studio's built in Git integration. Check obtaining the source files for Julius for details.

  7. The first time you open the project, Visual Studio will throw an error complaining it can't find SDL:

    Visual Studio 2019 SDL not found error

  8. You will need to tell Visual Studio where the SDL libraries you downloaded can be found. To do that, click up top where it says x64-Debug and select Manage Configurations.

  9. On the new screen that appears, scroll down to CMake Command Arguments.

  10. Paste the location of your library paths. If you used the above example paths, then paste the following code:

    -DCMAKE_PREFIX_PATH=C:\libs\SDL2-devel-2.0.12-VC\SDL2-2.0.12;C:\libs\SDL2_mixer-devel-2.0.4-VC\SDL2_mixer-2.0.4

    Notice that you must always include -DCMAKE_PREFIX_PATH= at the start.

    Visual Studio 2019 video adding cmake settings

  11. Press CTRL + S to save the configuration. Visual Studio will attempt to reconfigure everything, and this time it should detect the libraries and work.

  12. Pick Select Startup Item up top and select julius.exe.

    Visual Studio 2019 selecting startup item

  13. Go to Build → Build All. The game should compile without errors.

  14. After the game compiles, it is stored in a folder inside your work folder. You can access it from work folder\out\build\x64-Debug.

  15. If you simply execute the game right now, it will complain about missing DLL's. You need to copy the SDL2 and SDL2_mixer DLL's to the same directory as the executable.

    Both libraries are available inside your library directory. Using the example library location, the files should be in the following location:

    • SDL2 - C:\libs\SDL2-2.0.12\lib\x64
    • SDL2_mixer - C:\libs\SDL2_mixer-2.0.4\lib\x64

Success! You should now be able to run the game.

B. Using CMake and MinGW-w64 via command line

Building Julius by command line is useful if you don't wish to install a very large IDE such as Visual Studio. However, it still requires that you install some programs, such as CMake, MinGW-w64 and optionally Git.

Installing the prerequesite programs

Installing MinGW-w64

MinGW stands for Minimalist GNU for Windows and is a set of programs and tools that allow the compilation of the source files to an executable.

In order to properly install MinGW-64, do the following:

  1. Obtain MinGW-w64 and proceed to install it. The default options are good enough.

  2. Add the MinGW-w64 binaries to the path:

    • In the start menu, type environment variables and select Edit the system environment variables.

    • In the new window that appears, select Environment Variables:

      MinGW-w64 system properties window

    • On the new window that appears, at the top list, select the Path variable and click Edit.

    • On the new window that appears, select New and type C:\Program Files (x86)\mingw-w64\i686-8.1.0-posix-dwarf-rt_v6-rev0\mingw32\bin.

    • Click OK on all windows to confirm.

      MinGW-w64 video adding path

  3. MinGW-w64 is now installed.

Installing CMake

CMake is the tool that tells MinGW-w64 which files to compile and what options to use.

Open the download page for CMake and select the file from the Windows win64-x64 Installer option to install.

During install, check the option Add CMake to the system PATH for the current user:

MinGW-64 CMake installation window

Installing Git for Windows (optional)

Git is a source control system, allowing the local source code to be updated by only downloading the relevant changes instead of the entire codebase. This program is optional.

If you wish to install it, download it from the gitforwindows website, which provides an user interface as well as the command line tools. The default installation options are enough for Julius.

Obtaining SDL2 and SDL2_mixer

  1. Download the SDL2 development library as a gzipped file:

    • Open the SDL2 download page
    • In the section Development Libraries, select SDL2-devel-2.0.12-mingw.tar.gz (MinGW 32/64-bit)

  2. Download the SDL2_mixer development library as a gzipped file:

    • Open the SDL2_mixer download page
    • In the section Development Libraries, select SDL2_mixer-devel-2.0.4-mingw.tar.gz (MinGW 32/64-bit)

  3. Extract the SDL2 and SDL2_mixer development libraries to an easy to remember folder (I recommend something like C:\libs).

    • If you can't extract .tar.gz files, obtain 7-Zip.

    • For each one of the downloaded libraries, after opening the .gz file in 7-Zip, open the single .tar file that appears on the 7-Zip window and extract its contents:

      MinGW-w64 extracting SDL

Obtaining the source files for Julius

You have two options regarding on how to obtain the source code for Julius. The simplest, but not recommended one, is downloading the julius repository as a zip file.

While doing this will work, you will have to download the entire source again if there are any updates to the game which you wish to build yourself. So only directly download the source if you're sure you want to do it just once.

Still, if you download the contents as a zip file, extract them to a folder, which will be your work folder. You can now proceed to build Julius.

The best approach, however, is to use Git for Windows, since it allows you to keep up with changes to the source code.

If you followed the optional section about installing Git, keep reading. If not, follow installing Git for Windows before proceeding.

To obtain the source from Git, follow the following steps:

  1. Press Shift and right-click with the mouse on the folder where you wish to download the source to.

  2. Select Open PowerShell window here or Open command window here.

  3. On the command window, type:

     > git clone https://github.com/bvschaik/julius.git

Optional: If you already have the source files from Git and simply wish to update them (in order to build a newer version), repeat above steps 1. and 2. and type:

    > git pull origin master

If you then wish to proceed building Julius, delete the build folder and proceed to build Julius normally.

Building Julius

  1. Open the folder where you downloaded the source files to.

  2. Press Shift and right-click with the mouse on the julius folder and select Open PowerShell window here or Open command window here.

  3. Create a build directory and move to it:

     > mkdir build
 > cd build

  4. Run cmake:

     > cmake .. -G "MinGW Makefiles" "-DCMAKE_PREFIX_PATH=C:\libs\SDL2-2.0.12\i686-w64-mingw32;C:\libs\SDL2_mixer-2.0.4\i686-w64-mingw32"

    Replace the contents of -DCMAKE_PREFIX_PATH= with the location of the folders where you extracted SDL2 and SDL2_mixer to, and be sure to add the i686-w64-mingw32 at the end of both locations.

  5. Build Julius:

     > mingw32-make

    The game will be built to the build directory inside the main folder.

  6. Test that everything is working:

     > mingw32-make test

  7. If you simply execute the game right now, it will complain about missing DLL's. You need to copy the SDL2 and SDL2_mixer DLL's to the same directory as the executable.

    Both libraries are available inside your library directory. Using the example library location, the files should be in the following location:

    • SDL2 - C:\libs\SDL2-2.0.12\i686-w64-mingw32\bin
    • SDL2_mixer - C:\libs\SDL2_mixer-2.0.4\i686-w64-mingw32\bin

Success! You should now be able to run the game.

Julius information

Additional downloads

For developers

Clone this wiki locally