BUILD

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