Building GMK with Xcode

Hi, there. Here are some notes for building GMK on the Mac with Xcode. You can pretty much just follow the steps outlined in the programmer's guide. The information here is just more detail.

To add the GMK files to your Xcode project file:
- select T3D in the "Groups & Files" tree on the left side
- right click and select "Add > Existing Files..."
- navigate to the T3D directory and select the logickingMechanics folder, click "Add"
- make sure "Recursively create groups for any added folders" is selected
- click "Add"

This will add all of the files to your project. The GMK instructions provide a subset of files for some of the steps. Just remove the files you don't want in the build from the current render target:

- select the newly create logickingMechanics folder in "Groups & Files"

On the right side you should see a list of all of the files in the project, as well as some fields with extra information. One of these fields looks like a little target - a circle with a dot in the center. The checkboxes in this column define whether the file is included in the build or not. Toggle off the files you don't want in the build. Later on in future steps, check the box next to any files that need to be added to the build.


Installation of the physics pack

You'll need to compile the bullet or ODE libraries and install them (PhysX is not available on the mac). There are various ways to do this on the mac. For example, this is what I did for bullet (from the command line):

cd bullet directory
./configure
make
make install

In Xcode you need to add the headers and libraries directories to the build process and specify which libraries to link against. By default, the files for bullet are installed into /usr/local/lib and /usr/local/include:

- Find your target in "Groups & Files" in the "Targets" section. Right click on it and select "Get Info"
- Double click in the "Header Search Paths" field, and add "/usr/local/include"
- Double click in the "Library Search Paths" field, and add "/usr/local/lib"
- Double click in the "Other Linker Flags" field, and add "-lbulletcollision -lbulletdynamics -lbulletmath -lbulletsoftbody"

NOTE: The method provided here is useful for using GMK on your own machine. You probably really want to build the physics library as a framework so that you can include it in your application bundle when you're ready to distribute it. I haven't done that yet, so there aren't instructions here. However, the bullet installation page describes how to make a framework for bullet.

I hope this is of use!

Peer.