BUILD

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