=================
MacOS Development
=================

Here are some notes about running navit under Apple Mac OSX.

================================================================================================================================
WARNING: These instructions are currently unmaintained. Please feel free to submit a PR if you manage to build navit on Mac OSX.
================================================================================================================================

What you will need
==================

You need Xcode Tools and MacPorts in order to install navit.

MacPorts developers suggest to install Xcode Tools from http://developer.apple.com/tools/xcode/ and not from the Mac OSX install disk.
See `Mac-How <http://www.mac-how.net/>`_

Make sure you don't have fink installed on your system, it can confuse MacPorts package building and installation.

 * GTK Gui: You should only need gtk2 and glib2 via macPorts
 * SDL Gui: Untested yet.

Installation instruction
========================

Download Xcode Tools from http://developer.apple.com/tools/xcode/ and install it with X11 SDK

Download and Install MacPorts from http://www.macports.org/, or update your version

.. code-block:: bash

    sudo port -d selfupdate

Open up a terminal

make sure your PATH variables has `/opt/local/bin` and `/opt/local/sbin` in it:

.. code-block:: bash

    echo $PATH


Install automake, wget, libtool, gpsd (if you want gps support), gtk2 and glib2 (for gkt GUI) with

.. code-block:: bash

    sudo port install automake wget gpsd gtk2 glib2 libtool

Download navit or checkout it from Git

.. code-block:: bash

    git clone git@github.com:navit-gps/navit.git

You may also need a header file to handle endian issues (for PPC only)

.. code-block:: bash

    wget https://navit.svn.sourceforge.net/svnroot/navit/tags/R0_1_0/navit/projs/CodeBlocks/Win32Extra/byteswap.h

If you want to install navit along the MacPorts packages, you need to use the /opt/local directory as prefix:

.. code-block:: bash

  ./autogen.sh && ./configure --prefix=/opt/local --disable-binding-python

type `make` to build NavIt, and `sudo make install` to install it.

Then, you may edit and adapt your `navit.xml` file. The XML maptype is not supported, however normal Navit binfile works perfectly.

Speech
======

If you want (spoken) directions, get espeak from http://espeak.sourceforge.net, install as advised and use the following snippet in your navit.xml:

.. code-block:: xml

           <speech type="cmdline" data="speak -vde+f4 '%s'"/>

This will tell speak to use a female (f) german (de) voice.


Using xcode
===========

Download one of the `Git sources <https://github.com/navit-gps/navit>`_ that don't contain autogen.sh.

Open X-Code and create a new project. Cocoa will suffice

Add in a new target by clicking the triangle next to "Targets" and selected the location of the navit folder. Delete the previous target.

Delete the default files, and add in the navit files.

In a terminal, go into the navit folder.

.. code-block:: bash

 ./configure --disable-binding-python --disable-sample-map --disable-maptool

xcode can now build the navit


You can also use CMake.

.. code-block:: bash

 cd navit && cmake -G Xcode .

Something went wrong?
=====================

Please let us know by filing an issue on Github or reach out on IRC.
