Difference between revisions of "Building On Mac"
From Audacity Wiki
(Cliff's tweaks.) |
(Missing spaces.) |
||
Line 56: | Line 56: | ||
You should now be able to build Audacity using either the Xcode application or | You should now be able to build Audacity using either the Xcode application or | ||
the Xcodebuild command line tool. | the Xcodebuild command line tool. | ||
− | + | ||
* Change directory to <path to Audacity source>/mac | * Change directory to <path to Audacity source>/mac | ||
Optionally, if you have built before, clean with: | Optionally, if you have built before, clean with: | ||
− | + | ||
xcodebuild clean | xcodebuild clean | ||
Revision as of 12:08, 27 December 2016
Contents
Instructions in mac/build.txt
Gale 11Dec16: Just adding here that Xcode 8.1 requires minimum of OS X 10.11.5.
These instructions for building on mac are in mac/build.txt in the Git repo.
At this time, the newest SDK version that Audacity can build with is 10.6. To build Audacity using Xcode 5.1 or newer, you need to extract the 10.6 SDK from an earlier version of Xcode.
In the instructions below, Xcode 4.3.3 (for the 10.6 SDK) and Xcode 8.1 will be used. Fuller instructions that cover * Using other xcodes * Optional signing of DMGs * Applying wxWidgets patches one by one can be found on our wiki at http://wiki.audacityteam.org/wiki/Building_On_Mac 1) Download Xcode 8.1 and install it to /Applications. 2) Download Xcode 4.3.3 (it includes the 10.6 and 10.7 SDK's despite the downloads page says it only has the 10.7 SDK). 3) Open the DMG in Finder. 4) Right-click the "Xcode.app" bundle and select "Show Package Contents". 5) Navigate down the directories to get to: Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/ . 6) Copy the MacOSX10.6.sdk folder to: /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/ 7) Change the MinimumSDKVersion key value in /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Info.plist to 10.6 Xcode is now ready. 8) Download audacity patched wxWidgets 3.0.2 zip from the audacity copy of the wxWidgets project: https://github.com/audacity/wxWidgets/tree/audacity-fixes it's the green "clone or download" button on the right. Don't be tempted to use Widgets already installed by a package manager such as Homebrew because this will cause problems. 9) Once the download is complete, unzip it: unzip wxWidgets-audacity-fixes.zip 10) And finally build/install wxWidgets: sudo <path to Audacity source>/mac/build_wxwidgets . You should now be able to build Audacity using either the Xcode application or the Xcodebuild command line tool. * Change directory to <path to Audacity source>/mac Optionally, if you have built before, clean with: xcodebuild clean * Using xcodebuild, build Audacity and create DMG and ZIP bundles in /private/tmp by typing the following in the terminal: xcodebuild -configuration Release install * If you use the Xcode application, don't make any changes to Audacity.xcodeproj recommended by Xcode. In particular, be sure to leave the Base SDK configuration set to 10.6 as it is now. If you need Audacity to show languages other than English, install the gettext suite of tools (to get the msgfmt command). The source can be downloaded from: ftp://ftp.gnu.org/gnu/gettext/gettext-latest.tar.gz Untar it: tar xf gettext-latest.tar.gz And install: cd gexttext-latest ./configure sudo make install
More Detailed Wiki Instructions
These instructions for variations on building aren't in mac/build.txt in the Git repo.
Using wxWidgets from wxWidgets
Rather than downloading patched wxWidgets, you can download 3.0.2 and patch it yourself
Apply the following fixes to wxWidgets: cd wxWidgets-3.0.2 patch -p0 -i <path to Audacity source>/mac/wxMac_additions/wxMac-3.0.2-fixes.patch . patch -p0 -i <path to Audacity source>/mac/wxMac_additions/eventloops.patch . patch -p0 -i <path to Audacity source>/mac/wxMac_additions/pinch-spread.patch . patch -p0 -i <path to Audacity source>/mac/wxMac_additions/focusrings.patch . patch -p0 -i <path to Audacity source>/mac/wxMac_additions/wxMac-3.0.2-wxaccessible.patch . patch -p0 -i <path to Audacity source>/mac/wxMac_additions/tooldock-quit.patch . patch -p0 -i <path to Audacity source>/mac/wxMac_additions/fullscreen.patch .
The patches and their reasons can be found here, and there is more description about them here in the wiki.
Updating GitIdent
The Audacity about box can contain a link to the corresponding git commit To create this, run the batch script: get_gitident.sh If you do this, you are responsible for making sure the ident is correct in future builds. The script over writes RevisionIdent.h in the src directory. If you make further changes to your local copy after this step, or merge more recent version from git, this file, and hence the ident in the build, stays the same, and so would be misleading. To reset RevisionIdent.h you could do: git reset -hard origin/master
Signing the DMG
1) Comment out the last line of mac/scripts/build_dist.sh so that it reads #rm -rf ${DMG} TMP.dmg This will prevent deletion of TMP.dmg 2) Clean and build Audacity normally. 3) Navigate to /private/tmp/ and type hdiutil resize -size 200m TMP.dmg This step is needed as codesigning takes some temporary space, more than is available in the dmg. 4) mount the dmg hdiutil mount TMP.dmg 5) Codesign the app (deep to make sure everything important is signed) codesign --deep -s <identity> -v "/Volumes/Audacity 2.1.3/Audacity/Audacity.app" 6) Check it is signed to gatekeeper's satisfaction: spctl -a -v "/Volumes/Audacity 2.1.3/Audacity/Audacity.app" 7) unmount the dmg 8) Make a compressed dmg hdiutil convert TMP.dmg -format UDZO -imagekey zlib-level=9 -o "Newname.dmg" 9) codesign that codesign -s <identity> -v Newname.dmg
To test the signing, upload the dmg to dropbox and then download it again. Then double click to install and drag across to apps. When you go to run, you now get a warning about having downloaded form the internet, rather than being prevented from running...