Cloning and building the Orx library on the Mac with gmake

In the last article, I showed you how to get your Mac ready to develop Orx by downloading the Xcode Commandline Developer Tools which gives you git, gcc and a MacOSX SDK.

git is the tool that we will use to clone (or download) the latest repo of the Orx library.

• Open a Terminal
• cd to a folder where you would like to download Orx to. Suggestion: ~/Documents

$ git clone https://github.com/orx/orx.git

This will show the cloning process to your hard drive:

Cloning into 'orx'...
remote: Counting objects: 73959, done.
remote: Total 73959 (delta 0), reused 0 (delta 0), pack-reused 73959
Receiving objects: 100% (73959/73959), 58.93 MiB | 87.00 KiB/s, done.
Resolving deltas: 100% (54159/54159), done.
~Documents$

The Orx library source code is now on your Mac.

The next step is to run the setup script which will do three things for you automatically:

• Download all the external dependencies that Orx requires.
• Set a special $ORX environment variable
• Create projects for the more popular Mac IDEs so you can build the Orx library.

~Documents$ cd orx/
orx$ ./setup.sh

You will get the following output:

== Checking version: [ extern/ ]
== [ d99b8c61d781 ] needed, current [ ]
== [ d99b8c61d781 ] not in cache
== Fetching [ https://codeload.github.com/orx/orx-extern/zip/d99b8c61d781 ]
== Please wait!
== [ d99b8c61d781 ] cached!
== Decompressing [ cache/d99b8c61d781.zip ] => [ extern/ ]
== [ d99b8c61d781 ] installed!
== Copying [ premake4 ] to [ code/build ]
== Copying [ premake4 ] to [ tutorial/build ]
== Copying [ premake4 ] to [ tools/orxFontGen/build ]
== Copying [ premake4 ] to [ tools/orxCrypt/build ]

The external dependencies are downloaded and unpacked into your orx/extern folder. premake4 is copied to several folders which will be explained in a moment.

Next, the script sets a very handy environment variable ($ORX) on your system. This will have many uses for when you come to create your own game projects, but this is covered in the next article. But you will see output of:

== Setting environment: [ ORX = /Users/Someone/Documents/orx/code ]

The third step of the script is to create all the Projects for many IDEs availble for the Mac. premake4 is the tool that the script uses to create them, and the output will look like:

== Generating build files for [ mac ]
== Generating [ gmake ]
Building configurations...
Running action 'gmake'...
Generating mac/gmake/Makefile...
Generating mac/gmake/orx.make...
Generating mac/gmake/orxLIB.make...
Generating mac/gmake/Bounce.make...
Done.
Building configurations...
Running action 'gmake'...
Generating mac/gmake/Makefile...
Generating mac/gmake/01_Object.make...
    ... >8 snip!...
Generating mac/gmake/12_Lighting.make...
Done.
Building configurations...
Running action 'gmake'...
Generating mac/gmake/Makefile...
Generating mac/gmake/orxFontGen.make...
Done.
Building configurations...
Running action 'gmake'...
Generating mac/gmake/Makefile...
Generating mac/gmake/orxCrypt.make...
Done.
== Generating [ codelite ]
Building configurations...
Running action 'codelite'...
Generating mac/codelite/orx.workspace...
Generating mac/codelite/orx.project...
Generating mac/codelite/orxLIB.project...
   ...etc...
Done.
== You can now build orx in [ code/build/mac ]
== Installing git hook [ post-checkout ]
== Installing git hook [ post-merge ]

== IMPORTANT - New environment detected: Please logout/login to refresh your environment if you're using an IDE.

== [ 0:14:58 ] Setup successful!

We now have everything in place to actually build the Orx library.

Notice in the output above, Solution Projects have been created for gmake, Codelite, Code::Blocks and Xcode.

As we are setting up without Xcode, let's use gmake as our method to build Orx as it is available to everyone (if you followed the first article).

• cd into the build folder:

$ cd ~/Documents/orx/code/build/mac/gmake/

Then build the Debug version of the Orx library with:

$ make config=debuguniv64

The output will look like this:

==== Building orxLIB (debuguniv64) ====
Creating obj/x64/Debug/orxLIB
orxPlugin_EmbeddedList.cpp
orxAnim.c
orxAnimPointer.c
orxAnimSet.c
   ... >8 snip ....
orxString.c
orxTree.c
Linking orxLIB
ld: warning: directory not found for option '-L/usr/lib64'
Running post-build commands
cp -f ../../../lib/dynamic/liborx*.dylib ../../../bin
==== Building orx (debuguniv64) ====
Creating obj/x64/Debug/orx
orxMain.c
Linking orx
ld: warning: directory not found for option '-L/usr/lib64'
==== Building Bounce (debuguniv64) ====
Creating obj/x64/Debug/Bounce
orxBounce.c
Linking Bounce
ld: warning: directory not found for option '-L/usr/lib64'

Next, create the Profile version of the library with:

$ make config=profileuniv64

And finally, the Release version of the library with:

$ make config=releaseuniv64