View source for Calligra/Building Calligra on OSX


== Install Dependencies ==

First you need to install Calligra dependencies, you can do it manually, through Macports or Homebrew, here shows how to do it in Homebrew.

# Install Homebrew following [http://brew.sh/#install this guide].
# Setup <code>adymo/homebrew-kde</code> tap following [https://github.com/adymo/homebrew-kde/blob/master/README.md this guide].
# Install all the dependencies to the calligra formula.
# Install <code>ninja</code> through Homebrew, which is a build tool faster than GNU make.

== Setup Calligra Source Code==

# Clone Calligra git repo.
#: <pre>git clone git://anongit.kde.org/calligra</pre>
# Checkout the branch you want to build, master branch usually works best on OSX
# Make a directory for build and a directory for install, here we call them ${BUILD_DIR} and ${INSTALL_DIR} as references. 

== Build & Install ==

# Go to ${BUILD_DIR}, run cmake, ${PATH_TO_SOURCE_DIR} is the relative path from ${BUILD_DIR} to the source code directory:
#: <pre style="white-space: pre-wrap; 
white-space: -moz-pre-wrap; 
white-space: -pre-wrap; 
white-space: -o-pre-wrap; 
word-wrap: break-word;">cmake -DCMAKE_INSTALL_PREFIX=${INSTALL_DIR} -DKDE_DEFAULT_HOME=${CMAKE_INSTALL_PREFIX}/.kde -DCMAKE_PREFIX_PATH=/usr/local/opt/gettext:/usr/local/opt/sqlite/:/usr/local/kde4 -DBUILD_doc=FALSE -DBUNDLE_INSTALL_DIR=${CMAKE_INSTALL_PREFIX}/bin -DCMAKE_BUILD_TYPE:STRING=RelWithDebInfo -DPRODUCTSET=osx ${PATH_TO_SOURCE_DIR} -GNinja -Wno-dev -DCMAKE_CXX_FLAGS=-w</pre>
# Build and install through command
#: <pre>ninja install</pre>
# Setup environment variables similar to the homebrew-kde guide or put them in a script so you can fire up a debugger easily

== Run & Debug ==

# If you set environment variables in ~/.profile and ran kbuildsycoca4 and update-mime-database, you can run Calligra application by .app container under ${INSTALL_DIR}/bin
# Here is a example script which included environment variable setup and debugger support
<pre>

</pre>