Difference between revisions of "Development on Windows"

Jump to: navigation, search
Line 26: Line 26:
Run mingwXY.exe (XY=32 or 64) and type:
'''Run mingw64.exe (or mingw32.exe if you want to build 32bit binaries) and type:'''

Revision as of 15:04, 17 March 2019

Other languages:
English • ‎français

This wiki explains how to install a compilation environment (based on Msys2/mingw64) to build GIMX.
It also explains how to install Eclipse CDT and perform a checkout.
Unless otherwise specified, perform a default installation (default directories, etc).


Download and install Msys2.
Make sure to follow the instructions from the Msys2 wiki.

If you are running a 32-bit Windows, install the i686 version.
If you are running a 64-bit Windows, install the x84_64 version.

Checkout installation and build tools

This has to be run into msys2.exe.

pacman --noconfirm -S git
git clone https://github.com/matlo/GIMX-build.git

Development tools

Run mingw64.exe (or mingw32.exe if you want to build 32bit binaries) and type:

cd GIMX-build/windows

Inno setup

Download and install Inno setup.

Automated command-line build

Run mingwXY.exe (XY=32 or 64) and type:

cd GIMX-build/windows

All binaries are copied into <path to msys>\home\<username>\GIMX\setup, e.g. C:\msys32\home\matlo\GIMX\setup.
A setup file is also created.

Eclipse IDE

This part is only useful in case you intend to modify the source code. If you only want to build GIMX, you can skip it.
Eclipse is an IDE that can be stacked onto the Msys2/MinGW64 compilation toolchain.
Be sure to have a java JRE installed on your system.
Download Eclipse CDT 2018-12. Unzip it to wherever you want.
Run eclipse.exe.
Use default workspace folder.

Cloning project

Copy the following URL: https://github.com/matlo/GIMX.git
Click on "Window > Show View > Other...", select "Git repositories", and click on "Open".
Type Ctrl+V. A "Clone Git Repository" window should appear.
First step defines the repository to import. Click on "Next".
Second step defines the branch selection. Select the branches you are interested in. "master" branch contains latest stable source code. Click on "Next".
Third step defines local destination. A standard value for "Directory" is "C:\Users\<username>\git\GIMX". Make sure to select "Clone submodules". Click on "Finish".

Importing project

In the "Git Repositories" view, right click on the cloned git repository, and click on "Import Projects...". Select the project folder (for example "GIMX") and click on "Finish".

Building project

In the "Project Explorer" view, right-click on the project, and click on "Build Project".
If the build fails at finding make or gcc :

  • in the "Project Explorer" view, right-click on the project, and click on "Properties"
  • unfold "C/C++ Build", and click on "Environment"
  • make sure msys2 and mingw64 bin folders are present in the PATH variable
    • for example, if you used default installation folder for msys2 (C:\msys64), you should have this at the end of the PATH variable: C:\msys64\usr\bin;C:\msys64\mingw64\bin