Building On Mac

From Audacity Wiki
Revision as of 02:04, 21 January 2013 by Llucius (talk | contribs)
Jump to: navigation, search
This guide will help you establish a working development environment for Audacity on OS X Snow Leopard, Lion or Mountain Lion.

The steps detailed below are focused on getting you building Audacity as quickly and easily as possible, but you may use the environment for general development as well.

Warning icon If Audacity is your only goal for getting this development environment established and you do not use products like MacPorts or Fink, then you may skip the Xcode 4.x.x steps.

Download Xcode 3.2.6

To download Xcode, you will need to register at the Apple Developer site:

Once registered, the available downloads are located here:

Xcode 3.2.6 is the last version that (officially) supports the PPC architecture and the macosx10.4u SDK. Unless you're building release versions, the PPC support isn't absolutely necessary, but the SDK is required.

Enter “Xcode 3.2.6” in the search box on the left, press enter, and download the “Xcode 3.2.6 and iOS SDK 4.3” dmg:

Bom xcode 326 download.png

Download Xcode 4.5.2

Snow Leopard users may skip this step.

NOTE: You may choose to install other versions of Xcode, but at the time this guide was written, 4.5.2 was the latest and other versions may not work as outlined here.

Enter “Xcode 4.5.2” in the search box on the left, press enter, and download the “Xcode 4.5.2” dmg:

Bom xcode 452 download.png

Enter “Command Line Tools” in the search box on the left, press enter and download the “Command Line Tools” dmg that corresponds to your version of OS X:

Bom tools 452 download.png

Download wxWidgets

You must download the wxMac version 2.8.12 of wxWidgets from:

Bom wxwidgets 2812 download.png

Download the "Build wxwidgets.gz" script that will be used to build wxWidgets for use with Audacity. Make sure you save the file as "build_wxwidgets.gz". Safari will automatically uncompress the file, others may not.

Download cmake

Download the latest Unix/Linux source version of cmake from:

Bom cmake download.png

Download pkg-config

Download the latest version of pkg-config from:

Bom pkg-config download.png

Install Xcode 3.2.6

Locate the Xcode 3.2.6 dmg, xcode_3.2.6_and_ios_sdk_4.3.dmg, on your system and double click it to have Finder verify and mount it:

Bom xcode 326 mount.png

The “Xcode and iOS SDK” installer checks the version of OS X that is currently running and it will not work on any version above Snow Leopard. However, this version check can be bypassed by starting the installation from the command line.

NOTE: It is advisable to have all OS X updates applied to your system before installing Xcode 3.2.6. This is especially important for Lion users as the installation will fail.

Open a Terminal window and start the installation by entering the following commands:

open "/Volumes/Xcode and iOS SDK/Xcode and iOS SDK.mpkg"

Bom xcode 326 install.png

This will start the installation while bypassing the version check.

On Mountain Lion, the installer needs to restart itself:

Bom xcode 326 restart.png

And, since the Xcode 3.2.6 certificate has expired, you will be asked to accept it:

Bom xcode 326 cert.png

You will then get to the normal installation process:

Bom xcode 326 installer.png

Proceed through the various installation pages until you get to the “Custom Install” page:

Bom xcode 326 custom install.png

Open the Essentials item by clicking the arrow:

Bom xcode 326 options.png

The minimum required options are “Unix Development” and “Mac OS X 10.4 SDK”, but if you're running Snow Leopard, you may elect to install everything. On Lion or above, you will not be able to use “System Tools” and may choose to use the “iOS SDK” and “Documentation” from Xcode 4.5.2:

Bom xcode 326 selected options.png

Continue through the pages to start the installation.

On Mountain Lion, you will be prompted to stop iTunes near the end of the installation:

Bom xcode 326 itunes.png

To terminate the process and allow the installation to complete, open a Terminal window and enter:

sudo killall iTunesHelper

Bom xcode 326 ituneshelper.png

Close the installer when complete:

Bom xcode 326 complete.png

This completes the Xcode 3.2.6 installation.

Install Xcode 4.5.2

Snow Leopard users should skip this step.

Locate the Xcode 4.5.2 dmg, xcode4520418508a.dmg, on your system and double click it to have Finder verify and mount it:

Bom xcode 452 mount.png

The Xcode folder will open when it's mounted:

Bom xcode 452 folder.png

You may choose to drag the Xcode app to wherever you like, but this guide expects it to be located in the Applications folder:

Bom xcode 452 copy.png

Locate the Command Line Tools dmg, xcode452cltools10_76938212a.dmg, on your system and double click it to have Finder verify and mount it:

Bom tools 452 mount.png

The Command Line Tools folder will open:

Bom tools 452 folder.png

Start the installation by double clicking the installer, “Command Line Tools (Lion).mpkg” in this case:

Bom tools 452 installer.png

Once the installation completes, close the installer:

Bom tools 452 complete.png

Open a Terminal window and enter:

sudo xcode-select -switch "/Applications/"

Bom xcode 452 switch.png

You will be asked to enter your password:

Bom xcode 452 switched.png

To make it a little easier to use Xcode 3.2.6 from the command line, create a link to the 3.2.6 version of xcodebuild. You make change the "xcodebuild3" to whatever you like, just remember when building Audacity from the command line to use what you specify here:

sudo ln -s /Developer/usr/bin/xcodebuild /usr/bin/xcodebuild3

Bom xcode 452 xcodebuild3.png

This completes the Xcode 4.5.2 installation.

Install cmake

Open a terminal window, extract the cmake archive and change to the extracted directory using:

tar xf ~/Downloads/cmake-
cd cmake-

Bom cmake extract.png

Configure cmake:

./configure --prefix=/usr/local --docdir=/share/doc/CMake --mandir=/share/man

Bom cmake configure.png

Build cmake:


Bom cmake build.png

Install cmake:

sudo make install

Bom cmake install.png

This completes the cmake installation.

Install pkg-config

Open a terminal window, extract the pkg-config archive and change to the extracted directory using:

tar xf ~/Downloads/pkg-config-0.27.1.tar
cd pkg-config-0.27.1

Bom pkgconfig extract.png

Configure pkg-config:

sh configure --with-internal-glib

Bom pkgconfig configure.png

Build pkg-config:


Bom pkgconfig build.png

Install pkg-config:

sudo make install

Bom pkgconfig install.png

This completes the pkg-config installation.

Install wxWidgets

Open a Terminal window and extract the wxWidgets source:

tar xf ~/Downloads/wxMac-2.8.12.tar

Bom wxwidgets 2812 extract.png

Change to the newly created directory:

cd wxMac-2.8.12

Bom wxwidgets 2812 cd.png

Start the build. This assumes you downloaded the build_wxwidgets script to your Downloads directory:

sh ~/Downloads/build_wxwidgets

Bom wxwidgets 2812 build.png

After all configurations are built, you will be prompted for your password:

Bom wxwidgets 2812 install.png

All configurations have been built and installed:

Bom wxwidgets 2812 complete.png

To verify, list the installed configurations:

Bom wxwidgets 2812 list.png

Make sure you see 1 default configuration and 3 alternates:

Bom wxwidgets 2812 installed.png

wxWidgets installation is now complete.

Create links

To make it easier for Xcode to find the cmake, pkg-config, and wx-config, create links to them in the Xcode developer tree:

sudo ln -s /usr/local/bin/pkg-config /Developer/usr/bin
sudo ln -s /usr/local/bin/cmake /Developer/usr/bin
sudo ln -s /usr/local/bin/wx-config /Developer/usr/bin

Bom create links.png

Download Audacity

Now that everything is in place, we finally get to the whole purpose of this exercise, building Audacity. But first, you must decide if you want to use the source for the current stable version of Audacity or if you want to get the absolute latest development source. Remember that the latter may not build (usually does) due to active development.

Make your choice when downloading from here:

Bom audiacty build download.png

Once you have the source downloaded and extracted, you may use either the xcodebuild command line utility or the Xcode 3.2.6 IDE.

The Audacity xcode project has 4 configurations defined:

Debug Static - disables optimization, enables debugging code, and links to static libraries
Debug Shared - disables optimization, enables debugging code, and links to shared libraries
Release Static - enables optimization, disables debugging code, and links to static libraries
Release Shared - disables optimization, disables debugging code, and links to shared libraries

So you'll need to select which one you want to use in the following steps, but "Debug Static" will be used for this guide.

Build with xcodebuild

To use the command line utility, open a Terminal window, change to the Audacity mac directory, and start the build. If you didn't install Xcode 4.5.2 above, then use "xcodebuild" here:

cd audacity/mac
xcodebuild3 -configuration "Debug Static"

Bom audiacty build xcodebuild.png

When it completes, you should get a "Build Succeeded" message:

Bom audiacty build xcodebuild complete.png

The newly built Audacity can be started from Finder, using gdb, or simply:

open "build/Debug Static/"

Bom audiacty build xcodebuild open.png

Build with Xcode IDE

To build Audacity using the Xcode 3.2.6 IDE, use Finder to navigate to the "/Developer/Applications" folder, by selecting "Go to folder" from the "Go" menu in Finder:

Bom audiacty build xcode goto.png

And then enter the "/Developor/Applications" and click "Go":

Bom audiacty build xcode folder.png

Now double click the "Xcode" application to start it:

Bom audiacty build xcode start.png

The first time you launch Xcode 3.2.6, you will be prompted to install Java:

Bom audiacty build xcode java.png

When the installation completes, open the Audacity Xcode project by selecting "Open" from the "File" menu in Xcode:

Bom audiacty build xcode open.png

Navigate to the "audacity/mac" folder and then double click the "Audacity.xcodeproj" project:

Bom audiacty build xcode xcodeproj.png

Now just click "Build and Run" on the toolbar and a freshly built Audacity will start when the build completes.

Bom audiacty build xcode build.png