Table of Contents
Using Premake to create a Build Project to compile Orx
This article is no longer recommended as Orx now provides a setup script in the root of the Orx repository (setup.sh) which will automatically create build projects for all IDEs for your operating system. For more information: Cloning Orx from Github
If you wish to do this manually, continue with the article below.
This article is a short guide on building Orx from scratch using an IDE of your choice (Visual Studio, Codelite, XCode etc) on an operating system of your choice (Windows, Linux, Mac, Android etc).
What is a build project?
When you clone a copy of the very latest orx, look in the \orx\code\build folder. In here you will see folders to Windows, Linux, Android etc. And in these folders, you'll find subfolders to VisualStudio2010, Codelite, CodeBlocks, XCode, jni, etc.
These are build projects. With previous releases of orx, there were several build projects for some IDEs but not all. Premake now builds these Projects for us, for your chosen operating system and editor.
Your build may not exist in these folders, but you can create it. Then you can build orx for your own project.
Creating your build project
This article assumes that you are using the latest cloned Orx.
Step 1: cd your way into the build output folder:
cd orx\code\build
Step 2: run premake and specify the editor your want to create a build project for (in this case, windows codelite):
..\..\extern\premake\bin\windows\premake4 codelite
Your project for building Orx from scratch will now be created.
All operating systems, architectures, build projects
To get a list of all possible combinations, do a:
extern\premake\bin\windows\premake4 –help (dash dash help)
At the current time, the available oses are:
- OpenBSD, NetBSD, or FreeBSD
- Haiku
- Linux
- Apple Mac OS X
- Solaris
- Microsoft Windows
And the available build projects are:
- codeblocks
- codelite
- gmake
- vs2002
- vs2003
- vs2005
- vs2008
- vs2010
- vs2012
- vs2013
- xcode3
- xcode4
There's some interesting architectures there as well.
Compiling Orx using your Generated Project
Opening your IDE of choice and compiling should be fairly straight forward, but if you require any help, you can pick from one of the following guides:
And you're done!
Troubleshooting
If you encounter any issues, visit the troubleshooting page for building Orx.
