Changes between Version 160 and Version 161 of BuildInstructions

Timestamp:

Mar 15, 2012, 8:46:41 PM (12 years ago)

Author:

historic_bruno

Comment:

clarify the process on OS X

BuildInstructions

@@ -233 +233 @@
 The process on OS X is similar to Linux:
 
- * Install Apple's XCode for your system: see your Mac OS X install DVD or go to [http://connect.apple.com Apple's Developer Connection Site]. This provides the necessary tools to compile programs. For Leopard, you must install XCode >= 3.1 from the ADC site else some components will not compile.
-
- * You may also need the [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20719 Java Developer Package].
-
+ * If you're using Lion 10.7.3 or later, Apple has made their ''Command Line Tools for Xcode'' package freely available, as a separate download. '''It does not include or require Xcode.''' If you don't want the Xcode IDE, it's recommended to install only this package from [https://developer.apple.com/downloads/index.action Apple Developer Downloads]. You need a free Apple ID to access the download. If you already have Xcode 4.3+, you can download the command line tools from the [https://developer.apple.com/library/IOs/#recipes/xcode_help-documentation_preferences/DownloadingandInstallingXcodeComponents/DownloadingandInstallingXcodeComponents.html download preferences].
+ * If you're using Snow Leopard or Lion 10.7.2 or earlier, you'll probably need to install Xcode to get the command line tools (or you can try [https://github.com/kennethreitz/osx-gcc-installer/ OSX GCC Installer]):
+    * If available, use your Mac OS X install DVD which saves downloading 1.72+ GB.
+    * Visit [https://developer.apple.com/downloads/index.action Apple Developer Downloads] (logging in with your free Apple ID) and download the latest Xcode version for your OS. Version 4.x is required for Lion, while version 3.x is required for Snow Leopard. It's very important you install the correct version.
+    * The latest version of Xcode is also available for free from the [http://www.apple.com/mac/app-store/ Mac App Store], you'll need Snow Leopard 10.6.6 or later to access the App Store. ''Note: if you download the app, it is only the installer for Xcode. You need to open it and run the "Install Xcode" app.''
  * Install [http://www.macports.org/install.php MacPorts]. This is the easiest way to install all the dependencies needed by the game.
-
  * `sudo port install` the following packages :
    * boost
@@ -249 +249 @@
    * wxWidgets-devel (required for building Atlas, only the 2.9.x branch will work on 64-bit Macs)
    * subversion (the default version on 10.5 seems to cause checksum mismatch errors)
-
- * Now follow the same instructions as for Linux above, starting from the `svn co`.
+ * Now follow the [#Gettingthecode same instructions] as for Linux above, starting from the `svn co`.
+ * Newer versions of Xcode no longer include the command line tools by default, you need to install them as described above. Additionally, the command line tools package no longer includes GCC but it does include LLVM-GCC which is compatible. If you get errors during the build like "C compiler cannot create executables" then you probably have the newer command line tools with LLVM. The following command should fix it:
+ {{{
+ export CC=gcc CXX=g++
+ }}}
+
 
 === Compiling with GCC 4.2 or 4.3 under OS X ===
+
 If you get errors compiling with OS X's default version of GCC (4.0.1), you can try compiling with GCC 4.2 or 4.3. On Snow Leopard, running 
 {{{