trunk/osx/README.osx

Compiling linuxsampler for Mac OS X with XCode
==============================================

Requirements
------------

  The XCode project uses autotools build files. On Mac OS 10.4, you need
  to install pkg-config (available at http://pkgconfig.freedesktop.org/wiki/).
  
  If you are to build the CVS snapshot, then you need to do the following
  steps to make autotools work correctly:
  
  $ sudo ln -sf /usr/bin/glibtoolize /usr/local/bin/libtoolize
  $ sudo cat >/usr/local/bin/aclocal <<'EOF'
  #!/bin/sh
  /usr/bin/aclocal -I /usr/local/share/aclocal $@
  EOF
  $ sudo chmod +x /usr/local/bin/aclocal
  
Layout of the Directories
-------------------------

  The XCode project for libgig creates a temporary build directory as
  "$LS/../temp_build/$BUILD_STYLE" (where $LS is the linuxsampler 
  directory, and $BUILD_STYLE is the build style defined in the XCode 
  project). In this directory, the following subdirectories are created 
  and used:
    $BASELS.build:
      Intermediate build directory. Symbolic links to the original 
      source files are placed and "configure && make" is performed in 
      this directory. ($BASELS is the basename of the linuxsampler 
      directory.)
    local:
      The linuxsampler binary is "installed" in this directory as 
      local/bin/linuxsampler.
  
  This layout of the directories is similar to that of the libgig
  project, on which linuxsampler is dependent. You need to compile
  libgig first (with the same settings as this linuxsampler XCode
  project). So it is best to create a common directory, place the 
  libgig and linuxsampler directories in it, and build libgig and
  linuxsampler in this order. See also "osx/README.mac" in libgig.

Universal Binaries
------------------

  You can create the Universal Binaries by selecting "Deployment_UB" build
  style and build. The binaries for i386 and ppc architectures are built
  separately and then automatically combined. The Universal version of
  linuxsampler is found in $LS/../temp_build/Deployment_UB/local/bin.

  You do not need to have the Universal version of libgig, but you _do_
  need to build libgig both for i386 and ppc architectures.

Additional Information
----------------------

  The XCode project just invokes autoconf_builder.sh with after
  setting relevant environmental variables. If you are interested
  (or feel suspicious), please examine autoconf_builder.sh.

6 May 2007: First written by Toshi Nagata
9 May 2007: Updated to account for the Deployment_UB target

1	schoenebeck	1175	Compiling linuxsampler for Mac OS X with XCode
2			==============================================
3
4			Requirements
5			------------
6
7			The XCode project uses autotools build files. On Mac OS 10.4, you need
8			to install pkg-config (available at http://pkgconfig.freedesktop.org/wiki/).
9
10			If you are to build the CVS snapshot, then you need to do the following
11			steps to make autotools work correctly:
12
13			$ sudo ln -sf /usr/bin/glibtoolize /usr/local/bin/libtoolize
14			$ sudo cat >/usr/local/bin/aclocal <<'EOF'
15			#!/bin/sh
16			/usr/bin/aclocal -I /usr/local/share/aclocal $@
17			EOF
18			$ sudo chmod +x /usr/local/bin/aclocal
19
20			Layout of the Directories
21			-------------------------
22
23			The XCode project for libgig creates a temporary build directory as
24			"$LS/../temp_build/$BUILD_STYLE" (where $LS is the linuxsampler
25			directory, and $BUILD_STYLE is the build style defined in the XCode
26			project). In this directory, the following subdirectories are created
27			and used:
28			$BASELS.build:
29			Intermediate build directory. Symbolic links to the original
30			source files are placed and "configure && make" is performed in
31			this directory. ($BASELS is the basename of the linuxsampler
32			directory.)
33			local:
34			The linuxsampler binary is "installed" in this directory as
35			local/bin/linuxsampler.
36
37			This layout of the directories is similar to that of the libgig
38			project, on which linuxsampler is dependent. You need to compile
39			libgig first (with the same settings as this linuxsampler XCode
40			project). So it is best to create a common directory, place the
41			libgig and linuxsampler directories in it, and build libgig and
42			linuxsampler in this order. See also "osx/README.mac" in libgig.
43
44			Universal Binaries
45			------------------
46
47	schoenebeck	1191	You can create the Universal Binaries by selecting "Deployment_UB" build
48			style and build. The binaries for i386 and ppc architectures are built
49			separately and then automatically combined. The Universal version of
50			linuxsampler is found in $LS/../temp_build/Deployment_UB/local/bin.
51	schoenebeck	1175
52	schoenebeck	1191	You do not need to have the Universal version of libgig, but you _do_
53			need to build libgig both for i386 and ppc architectures.
54
55	schoenebeck	1175	Additional Information
56			----------------------
57
58			The XCode project just invokes autoconf_builder.sh with after
59			setting relevant environmental variables. If you are interested
60			(or feel suspicious), please examine autoconf_builder.sh.
61
62	schoenebeck	1191	6 May 2007: First written by Toshi Nagata
63			9 May 2007: Updated to account for the Deployment_UB target
64