Building On Mac

From Audacity Wiki
Revision as of 09:57, 19 January 2013 by Llucius (talk | contribs) (Guide for setting up a build environment on OS X Snow Leopard, Lion, or Mountain Lion)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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. You may use the environment for general development as well, but the intent is to get you started building Audacity as quickly and easily as possible. To that end, the steps detailed below will concentrate on Audacity and general development will be left up to you.

Download Xcode 3.2.6

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

http://developer.apple.com

Once registered, the available downloads are located here:

http://developer.apple.com/downloads

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:

File:Example.jpg

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:

File:Example.jpg

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:

File:Example.jpg

Download MacPorts

Two build utilities, cmake and pkgconfig, will need to be installed and MacPorts or Fink are the easiest way to get them. This guide will use MacPorts so you will need to make adjustments if you choose to use Fink. Download the version of MacPorts which matches your OS X version from:

http://www.macports.org/install.php

Download wxWidgets

You must download the wxMac version 2.8.12 of wxWidgets from:

http://www.wxwidgets.org/downloads/

Download the File:Build wxwidgets script that will be used to build wxWidgets for use with Audacity.

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:

File:Example.jpg

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:

export COMMAND_LINE_INSTALL=1 open "/Volumes/Xcode and iOS SDK/Xcode and iOS SDK.mpkg"

File:Example.jpg

This will start the installation while bypassing the version check:

File:Example.jpg

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

File:Example.jpg

Open the Essentials item by clicking the arrow:

File:Example.jpg

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:

File:Example.jpg

Continue through the installation dialogs to start the installation and close the installer when complete:

File:Example.jpg

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:

File:Example.jpg

The Xcode folder will open when it's mounted:

File:Example.jpg

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

File:Example.jpg

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

File:Example.jpg

The Command Line Tools folder will open:

File:Example.jpg

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

File:Example.jpg

Once the installation completes, close the installer:

File:Example.jpg

Open a Terminal window and enter:

sudo xcode-select -switch "/Applications/Xcode.app/Contents/Developer"

File:Example.jpg

This completes the Xcode 4.5.2 installation.

Install MacPorts

Locate the MacPorts installer and double click to start the installation:

File:Example.jpg

Click through the installation pages and close the installer when installation completes:

File:Example.jpg

Open a Terminal window and install the cmake and pkgconfig packages:

File:Example.jpg

This completes the MacPorts installation.

Install wxWidgets

Open a Terminal window and extract the wxWidgets source:

tar xf ~/Downloads/wxMac-2.8.12.tar

File:Example.jpg

Change to the newly created directory:

cd wxMac-2.8.12

File:Example.jpg

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

~/Downloads/build_wxwidgets

File:Example.jpg

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

File:Example.jpg

wxWidgets installation is now complete.