BUILD

   1 $Id: BUILD,v 1.11 2005/10/23 01:35:59 titer Exp $
   2
   3 BUILD file for HandBrake <http://handbrake.m0k.org/>
   4
   5 Building HandBrake with jam
   6 ===========================
   7
   8 You can build HandBrake on BeOS, MacOS X, Linux, and on Windows using Cygwin.
   9 If you'd like to port it to another OS, email me (titer@m0k.org).
  10
  11 Step 1: get needed tools
  12 ========================
  13
  14 + gcc and g++
  15     There are usually included in your OS' dev tools. On BeOS/Zeta, the
  16     default gcc isn't enough, gcc 2.95.3 is required.
  17 + jam
  18     I use 2.5rc3, earlier versions might cause issues.
  19     On BeOS, you can download it at <http://www.haiku-os.org/develop.php>.
  20     On OS X, you cannot use the modified jam shipped with the developer
  21     tools, use this one instead:
  22     <http://download.m0k.org/handbrake/jam-2.5rc3-OSX.zip>.
  23     On Cygwin, get the jam source from
  24     http://public.perforce.com/public/jam/index.html,
  25     compile it with gcc in Cygwin, and put the jam executable somewhere on
  26     your path.
  27 + nasm (Only for x86. On Mac OS X Intel, Xcode 2.4.1 include it)
  28
  29 Cygwin setup:
  30     There are a couple extra things required to make the code build for Cygwin.
  31     Make sure you have /bin and /usr/bin on your path *first*, before
  32     the Windows paths.  Otherwise the Cygwin find.exe won't be used, and
  33     lame won't build.
  34     Also, I have not tried to build this with MinGW, I've only built it with
  35     the Cygwin environment, so you should build with Cygwin gcc and dev tools.
  36     Unfortunately this means you need to have cygwin1.dll around to run the
  37     HBTest.exe program, but that's the way it is for now, until I get time
  38     to try building it with MinGW.  If you want to try making it work with
  39     MinGW, then go for it!
  40
  41
  42 Step 2: build
  43 =============
  44
  45 Run `./configure && jam'. This will build every library HandBrake
  46 requires, then HandBrake itself.
  47
  48 -----------------------------------------------------------------------------------------------------
  49
  50 Building HandBrake with make
  51 ============================
  52
  53 Step 1: get needed tools
  54 ========================
  55
  56 + gcc and g++
  57     There are usually included in your OS' dev tools. On BeOS/Zeta, the
  58     default gcc isn't enough, gcc 2.95.3 is required.
  59
  60 + nasm (Only for x86. On Mac OS X Intel, Xcode 2.4.1 include it)
  61
  62 Cygwin setup:
  63     There are a couple extra things required to make the code build for Cygwin.
  64     Make sure you have /bin and /usr/bin on your path *first*, before
  65     the Windows paths.  Otherwise the Cygwin find.exe won't be used, and
  66     lame won't build.
  67     Also, I have not tried to build this with MinGW, I've only built it with
  68     the Cygwin environment, so you should build with Cygwin gcc and dev tools.
  69     Unfortunately this means you need to have cygwin1.dll around to run the
  70     HBTest.exe program, but that's the way it is for now, until I get time
  71     to try building it with MinGW.  If you want to try making it work with
  72     MinGW, then go for it!
  73
  74
  75
  76
  77 Step 2: configuration
  78 =====================
  79
  80 The HB_BUILD and HB_VERSION are defined in a single file, the Makefile correct the values in Xcode too.
  81
  82 The file where the informations are stored is Makefile.config
  83
  84 Step 3: build
  85 =============
  86
  87 Run `make'. This will build libmediafork, MediaFork and MediaForkCLI as Universal Binary.
  88 This build method use precompiled contrib libraries. Script to build those binaries are provided too.
  89 All the build is handled by Xcode 2.4.1, should work on powerPC and Intel Macs.
  90
  91