Changes between Version 237 and Version 238 of BuildInstructions

Timestamp:

May 17, 2014, 1:03:07 AM (10 years ago)

Author:

historic_bruno

Comment:

Adds some notes, ticket links, and explanations for OS X Mavericks

BuildInstructions

@@ -43 +43 @@
  * Visual C++ 2008
 
+Visual C++ 2013 is not supported yet, due to missing Boost libs (see #2271). Visual C++ 2005 is also not supported (#1951).
+
 '''Important notes:'''
  * Only 32-bit builds are supported (though they can be compiled and run on 64-bit Windows)
@@ -70 +72 @@
 
 === Build configuration ===
-Make sure to select the "Release" configuration to build an optimised, more playable version of the game (the target will be `pyrogenesis.exe`). The "Debug" configuration can be more useful for debugging but has significantly reduced performance (the target will be `pyrogenesis_dbg.exe`). Both "Release" and "Debug" builds include debug symbols, see [wiki:DebuggingOnWindows Debugging on Windows] for more details on debugging.
+Make sure to select the "Release" configuration to build an optimised, more playable version of the game (the target will be `pyrogenesis.exe`). The "Debug" configuration can be more useful for debugging but has significantly reduced performance (the target will be `pyrogenesis_dbg.exe`). Both "Release" and "Debug" builds include debug symbols, see [wiki:Debugging] and [wiki:DebuggingOnWindows Debugging on Windows] for more details on debugging.
 
 Now you should be able to build the code from within Visual Studio, using "Build Solution" (F7).
@@ -294 +296 @@
     * 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.''
   * If you want to build a distributable app bundle as described below, you will need Xcode.
+ * '''Note:''' As of Mavericks (10.9) and Xcode 5, Apple [https://developer.apple.com/library/mac/releasenotes/DeveloperTools/RN-Xcode/xc5_release_notes/xc5_release_notes.html#//apple_ref/doc/uid/TP40001051-CH2-SW302 no longer supports] llvm-gcc, instead it is required to use clang. Additionally, the default C++ library is now libc++ instead of libstdc++. These changes may cause failures in the build process (see #2304).
+   * A workaround may be to run the following commands in the terminal before building:
+     {{{
+export CFLAGS="-stdlib=libstdc++" LDFLAGS="-stdlib=libstdc++"
+export CC=clang CXX=clang++
+     }}}
+   * Add `toolset=clang` to the Boost.Build (b2) flags in `build-osx-libs.sh`.
+   * If you've upgraded and previously built the game, you should pass the `--force-rebuild` flag to `build-osx-libs.sh`.
+ * '''Note:''' As of Alpha 16, the game uses SpiderMonkey 24, which no longer supports GCC 4.2.x including llvm-gcc previously bundled with Xcode. The game can no longer be built on OS X Leopard (10.5), and there is a !SpiderMonkey [https://bugzilla.mozilla.org/show_bug.cgi?id=862657 bug] that breaks the build on Snow Leopard (10.6) with Xcode 3.2.6.
  * '''Note: CMake is a required dependency.''' You can download a prebuilt OS X package [http://www.cmake.org/cmake/resources/software.html here]. If prompted, install the command line CMake tools to the default location.
  * Obtain the game's source code from SVN as [#Gettingthecode described above].