Building wxSA on Mac

From LSDevLinux
Jump to: navigation, search

Checking out the code

The Subversion repository is at http://linux.lsdev.sil.org/svn/SpeechAnalyzer. You can check out the trunk as follows:

$ svn co http://linux.lsdev.sil.org/svn/SpeechAnalyzer/trunk SpeechAnalyzer

It's also possible to set up a local git repository which mirrors the main Subversion one. You can create your own local branches and make a series of commits to them. Then, when you're ready, you can push a series of commits back to the trunk. Consult the git-svn man page for instructions on how to do this.

Both Subversion and git can be installed using MacPorts. Although there may already be a copy of Subversion included with Mac OS X, the MacPorts one is usually much more recent.

Installing necessary packages

First, you will need to install the Apple Developer Tools (which includes the Xcode IDE). These can be downloaded in a disk image from Apple's Mac Development Center. You will need to register for a free account first. Try to stay updated to the latest version whenever possible.

Beyond this, SA needs wx libraries and headers. It's relatively simple to build these from source, and by using Subversion to obtain the source it's simple to keep upgrading to the latest version without downloading large amounts of data. For instructions, see Building wx from source.

SA also uses the sndfile library, which can be installed using MacPorts. The package name is libsndfile.

SA will soon be using the RtAudio library, but this doesn't have a MacPorts package and so must be built from source.

Building

There is no configure step, so running make is all that needs to be done. The application can then be launched by opening SAminimal.app in the Finder or by executing Saminimal.app/Contents/MacOS/SAminimal in Terminal.

It's also possible to set up an Xcode project that uses the Makefile to build, and which allows source-level debugging from within Xcode.