doc/texi/Building.osx.texi

   1 @input texinfo @c -*- Texinfo -*-
   2 @c %**start of header
   3 @setfilename Building.osx.info
   4 @include base/article.texi
   5 @include building/command.texi
   6 @paragraphindent none
   7
   8 @set BG.platform osx
   9 @c %**end of header
  10
  11 @majorheading Build Guide for @value{HB.name} @value{HB.version} on @value{OS.@value{BG.platform}}
  12
  13 @contents
  14 @include building/chapter.introduction.texi
  15
  16 @c %**-------------------------------------------------------------------------
  17 @anchor{prerequisites}
  18 @chapter Prerequisites
  19 Building on @value{OS.osx} is well supported. It is the reference platform for @value{HB.name}. The following are the recommended specifications for this platform; but is not necessarily the only configuration that is possible:
  20
  21 @itemize @bullet
  22 @item Mac Intel hardware
  23 @item @value{OS.osx} 10.5.7
  24 @item Xcode-3.1.2
  25 @item gcc 4.0.1 (Apple Inc. build 5490)
  26 @item yasm 0.8.0.2194 (for i386 and x86_64 architectures)
  27 @end itemize
  28
  29 @include building/prerequisites.bundled.texi
  30 @include building/prerequisites.common.texi
  31
  32 @c %**-------------------------------------------------------------------------
  33 @include building/chapter.quickstart.texi
  34
  35 @c %**-------------------------------------------------------------------------
  36 @anchor{overview}
  37 @chapter Overview
  38 The two general methods to build on @value{OS.osx} are from @b{terminal} or @b{Xcode.app}. The preferred method for automated and repeatable builds is to use the terminal. Otherwise the choice is generally up to the individual. To be extra clear, building from the terminal by default actually invokes @command{xcodebuild} to build the very same targets contained in the Xcode project. Think of it as building with Xcode but without the GUI.
  39
  40 @c %**-------------------------------------------------------------------------
  41 @include building/chapter.via.terminal.texi
  42
  43 @c %**-------------------------------------------------------------------------
  44 @anchor{terminal.ub}
  45 @section Universal Binaries
  46 This section outlines convenience procedures for creating Universal Binaries for all the architectures.
  47
  48 @quotation Note
  49 The dummy (container) build configuration uses @command{--disable-xcode}; but the nested architecture builds will all make full use of Xcode.
  50 @end quotation
  51
  52 Create a dummy (container) build configuration and use it to launch a nested-build for each architecture @i{serially}; optionally you may substitute @command{make ub.build.serial} for @command{make ub.build.parallel} if your machine has the horsepower:
  53
  54 @example
  55 ./configure --disable-xcode
  56 cd build/
  57 make ub.build.serial
  58 make ub.combine
  59 @end example
  60
  61 To specify a subset of architectures to be built first create/edit @file{_SRC_/custom.defs} with the following override to build UB for @samp{i386} and @samp{x86_64} before invoking @command{make}:
  62
  63 @example
  64 ## prefer i386 (order is important)
  65 UB.archs = i386 x86_64
  66 @end example
  67
  68 @c %**-------------------------------------------------------------------------
  69 @include building/chapter.via.xcode.texi
  70 @include building/chapter.troubleshooting.texi
  71 @include building/appendix.repo.texi