Xestia Address Book OS X Development
====================================

Xestia Address Book uses Xcode to build the application for OS X.

Step 1: Location of Frameworks and Libraries
============================================

When you open up the Xcode project for the first time, you will see the
Frameworks & Libraries section will contain several red (missing) items.

The required frameworks & libraries are:

libcurl.framework
sfml-audio.framework
sfml-system.framework
SFML.framework
libxml2.dylib

Click on each framework that is in red and then the little folder icon
on the right hand side to locate each library.

You may need to set these libraries up again so that they are copied over
during the Copy Files phase.

Where possible, please build the libraries as "fat" binaries (with i686 
and x86_64 support).

Step 2: Setup user Settings
===========================

The following user settings are used for finding frameworks and libraries
with.

=========================================================================
| Setting Name			| Setting Description			|
=========================================================================
| SFML_FRAMEWORKPATH		| Path to the SFML framework		|
| CURL_FRAMEWORKPATH		| Path to the cURL framework		|
| LIBXML2_PATH			| Path to the libxml2 library		|
=========================================================================

To add the user settings, select the project, click on Build Settings, 
click on the add button and select the Add User Setting button, enter one
of the setting names from above with the value set as the path to where
the libraries are.

Step 3: Build
=============

Select the bitmapcode target first and click on the Run button at the
top of the Xcode window. This will build and run the bitmapcode helper
which will generate the required code and headers for the images used
in Xestia Address Book.

Now select the Xestia Address Book target and click on the Run button
again at the top of the Xcode window. This will build and run Xestia
Address Book.

At the end of the build process, it will copy the frameworks and libraries
over into the executable.

Release executables tend to be smaller but cannot be debugged as easily 
compared to the Debug executables.