wiki:CompilingGuide

Version 19 (modified by leo, 4 years ago) (diff)

--

Getting the source code

The source code is stored using Subversion and the read-only repository is at http://svn.leocad.org/. You can download the trunk version for the latest but unstable changes or the official releases using the leocad-0.73, leocad-0.75, etc tags. Please use one of the release tags unless you plan to be a developer.

Typing this would download the latest revision to a directory called 'leocad' on your computer:

C:\>svn co http://svn.leocad.org/trunk leocad

Or if you want to get the source code for version 0.77 you would type:

C:\>svn co http://svn.leocad.org/tags/leocad-0.77 leocad

If you are new to Subversion you may want to read Version Control with Subversion (CVS users will find a good comparison between CVS and Subversion in Appendix A), and download a free Subversion client from here.

You can receive notifications of source code changes by subscribing to the rss feed at the bottom of the Timeline page.

Optional Libraries

LeoCAD can use a few Open Source libraries to add extra functionality to it, you can download them if you want or just compile LeoCAD without those features (see the next sections for instructions on how to install them).

Compiling the Linux Version

Make sure you have the GTK+ 2.0 header files and libraries installed in your system, you can check that by typing from a shell:

$ 'pkg-config --atleast-version=2.0 gtk+2.0'

The GTK+ 2.0 libraries are required to compile LeoCAD, they are available for download from the GTK+ Homepage. Debian and Ubuntu users can simply type:

$ sudo apt-get install libgtk2.0-dev

If you don't have the OpenGL headers installed in your computer you can get them from the Mesa package:

$ sudo apt-get install libgl1-mesa-dev

Next go to the leocad directory and run the auto-configuration:

$ make config

This will try to detect what libraries you have installed and what kind of computer you have. After that is done you're ready to build the executable:

$ make

If you don't get any errors you should have a new executable in the bin directory.

Compiling the Windows Version

If you downloaded the optional libraries extract them to the leocad\win folder, or open config.h in that same folder and comment out the #define LC_HAVE_XXX at the bottom of the file for the libraries that you don't have installed.

LeoCAD 0.77 requires Visual Studio 2010 to compile.

Compiling the iPhone Version

Extract the Pieces Library to the iphone directory then open LeoCAD.xcodeproj, select the target configuration and compile.

You will need the official iPhone SDK to compile and a developer certificate to run it on a phone, both can be obtained directly from Apple.