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
------------------

  Universal Binaries are not automatically created by the XCode project.
  However, it is easy to create them by hands as follows:
  
  $ cd $LS   # Move to the linuxsampler directory
  $ mkdir -p ../temp_build/UB/bin
  $ cd ../temp_build/Deployment_ppc
  $ i=bin/linuxsampler
  $ lipo -create $i ../Deployment_i386/$i -output ../UB/$i

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
Written by Toshi Nagata
1	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	Universal Binaries are not automatically created by the XCode project.
48	However, it is easy to create them by hands as follows:
49
50	$ cd $LS # Move to the linuxsampler directory
51	$ mkdir -p ../temp_build/UB/bin
52	$ cd ../temp_build/Deployment_ppc
53	$ i=bin/linuxsampler
54	$ lipo -create $i ../Deployment_i386/$i -output ../UB/$i
55
56	Additional Information
57	----------------------
58
59	The XCode project just invokes autoconf_builder.sh with after
60	setting relevant environmental variables. If you are interested
61	(or feel suspicious), please examine autoconf_builder.sh.
62
63	6 May 2007
64	Written by Toshi Nagata