User Tools

Site Tools


en:tutorials:orx:windows:compiling_orx_with_mingw32_gmake

This is an old revision of the document!


Compiling Orx with mingw32/gmake on Windows

Note: when cloning orx and running it's accomapanying setup file, a windows gmake build project is automatically created. These instructions will help you do this manually if you ever need to remake your own.

There are 5 steps required to build Orx using gmake

  1. Getting Orx from source
  2. Getting mingw32 (not mingw64)
  3. Updating the PATH environment variable
  4. Creating a build project for gmake
  5. Compiling

Getting Orx from source

This step is already covered under cloning orx. Please follow those instructions first.

Getting mingw32

Orx works with mingw32. Do not download the mingw64 project. Orx does not support this compiler yet. You can download an installer from: https://sourceforge.net/projects/mingw/files/Installer/ You will want the mingw-get-setup.exe file.

  1. Run the mingw-get-setup.exe file.
  2. Choose an installation directory. To avoid dramas, don't choose a folder with spaces in it. Something like C:\MinGW is best.
  3. Turn off the “start menu” and “on the desktop” options.
  4. Continue
  5. The application will download xml catalogues for a minute or two.
  6. Continue
  7. Under basic setup, choose mingw32-base and mingw32-gcc-g++.
  8. Select the Installation menu / Apply Changes.
  9. The compiler will be installed into the folder you chose.

Updating the PATH environment variable

  1. Edit the System Environment Variables
  2. Add your mingw bin folder location into the PATH list, ie: C:\MinGW\bin or C:\MinGW-5.3.0\bin (depending where you installed it)

Creating a build project for gmake

When first cloning Orx, this project should already be created for you. If so, skip this section.

  1. Open a command window (cmd.exe)
  2. cd into the C:\[somewhere]\orx\code\build folder
  3. premake4.exe gmake

Expected output:

Building configurations...
Running action 'gmake'...
Generating windows/gmake/Makefile...
Generating windows/gmake/orx.make...
Generating windows/gmake/orxLIB.make...
Generating windows/gmake/Bounce.make...
Done.

Compiling

  1. cd into the gmake folder
  2. mingw32.make

Expected output

"==== Building orxLIB (debug) ===="
Creating ../../../lib/dynamic
Creating obj/Debug/orxLIB
orxPlugin_EmbeddedList.cpp
orxAnim.c
orxAnimPointer.c
orxAnimSet.c
orxModule.c
orxType.c
orxClock.c
orxCommand.c
orxConfig.c
orxConsole.c
orxEvent.c
orxLocale.c
orxResource.c
orxSystem.c
orxThread.c
orxDebug.c
orxFPS.c
orxProfiler.c
orxDisplay.c
orxFont.c
orxGraphic.c
orxScreenshot.c
orxText.c
orxTexture.c
orxFile.c
orxInput.c
orxJoystick.c
orxKeyboard.c
orxMouse.c
orxParam.c
orxMath.c
orxVector.c
orxBank.c
orxMemory.c
orxFrame.c
orxFX.c
orxFXPointer.c
orxObject.c
orxSpawner.c
orxStructure.c
orxTimeLine.c
orxBody.c
orxPhysics.c
orxPlugin.c
orxCamera.c
orxRender.c
orxShader.c
orxShaderPointer.c
orxViewport.c
orxSound.c
orxSoundPointer.c
orxSoundSystem.c
orxHashTable.c
orxLinkList.c
orxString.c
orxTree.c
Linking orxLIB
Running post-build commands
cmd /c copy /Y ..\..\..\lib\dynamic\orx*.dll ..\..\..\bin
..\..\..\lib\dynamic\orxd.dll
        1 file(s) copied.
"==== Building orx (debug) ===="
Creating obj/Debug/orx
orxMain.c
Linking orx
"==== Building Bounce (debug) ===="
Creating ../../../bin/plugins/demo
Creating obj/Debug/Bounce
orxBounce.c
Linking Bounce

Your Orx Library

If you check in the C:\[somewhere]\orx\code\lib\dynamic folder, you'll see an liborxd.a and orxd.dll

Profile and Release builds

If you wish to build the other configurations, you can do so with:

mingw32.make config=profile

and…

mingw32.make config=release

… respectively.

Troubleshooting

Q. You get no errors, but no information either, just output like:

"==== Building orxLIB (debug) ===="
"==== Building orx (debug) ===="
"==== Building Bounce (debug) ===="

A. Try compiling again with debug messages again to get all possible information:

mingw32-make -d config=debug

Q. If you cannot compile, and you see something in the messages or logs regarding: C:\Program Files (x86)\Git\bin\sh.exe

A. This is because you have installed Git Bash and it has added C:\Program Files (x86)\Git\bin to your windows path. Therefore git binaries are available to your windows console and are clashing with mingw. Remove the path from your Environment Variables:

C:\Program Files (x86)\Git\bin

Reopen your windows console and try compiling again.

Q. You don't get any specific errors in the debug output.

A. Ensure you passed the correct config value. It must be either debug, profile, release or not specified. If you typed any other value, you will get empty output like:

"==== Building orxLIB (wrong) ===="
"==== Building orx (wrong) ===="
"==== Building Bounce (wrong) ===="

en/tutorials/orx/windows/compiling_orx_with_mingw32_gmake.1518583586.txt.gz · Last modified: 2018/02/14 00:46 (6 years ago) (external edit)