Orx Learning

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Cloning and building the Orx library on the Mac with gmake ======

In the [[en:tutorials:orx:mac:setting_up_dev_on_mac|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.


===== Getting Orx =====

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

<code>
$ git clone https://github.com/orx/orx.git
</code>

This will show the cloning process to your hard drive:

<code>
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$
</code>

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.

<code>
~Documents$ cd orx/
orx$ ./setup.sh
</code>

You will get the following output:

<code>
== 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 ]
</code>

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:

<code>
== Setting environment: [ ORX = /Users/Someone/Documents/orx/code ]
</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:

<code>
== 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!
</code>

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

<WRAP center round important 90%>
Please note the message above that says:
''== IMPORTANT - New environment detected: Please logout/login to refresh your environment if you're using an IDE.''
Just close your Terminal and open a new one so that Orx settings are available during Terminal sessions.
</WRAP>


===== Building the Orx Library with gmake =====

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

<WRAP center round info 90%>
If you would rather compile using Xcode than gmake, follow this tutorial: [[en:tutorials:orx:mac:building_orx_with_xcode_on_mac|Building the Orx Library with Xcode on Mac OS X]]
</WRAP>

<WRAP center round info 90%>
If you would rather compile using Codelite than gmake, follow this tutorial: [[en:tutorials:orx:mac:building_orx_on_codelite_for_mac|Building the Orx library on a Mac with Codelite]]
</WRAP>

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 [[en:tutorials:orx:mac:setting_up_dev_on_mac|first article]]).

  * cd into the build folder:

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

Then build the **Debug** version of the Orx library with:

<code>
$ make config=debuguniv64
</code>

The output will look like this:

<code>
==== 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'
</code>

Next, create the **Profile** version of the library with:

<code>
$ make config=profileuniv64
</code>

And finally, the **Release** version of the library with:

<code>
$ make config=releaseuniv64
</code>


{{section>en:tutorials:orx:mac:finding_the_orx_libraries_for_mac&nofooter&noeditbutton}}



<WRAP center round info 80%>
Just a little note on the $ORX environment variable that the ''setup.sh'' script created for you: if you open the ''.bashrc'' and ''.profile'' files in your ''~'' folder, you will see the ''ORX'' variable set there for you.
</WRAP>
Orx Learning

User Tools

Site Tools

Page Tools
