Merge remote-tracking branch 'origin/master'
[moonshot.git] / mac-client-installer / README.MacOsBuildInstructions
1 ### Building Mac OS Installer using jhbuild
2 This document contains instructions for building the Mac OS Installer for the Moonshot GSS EAP and SASL GS2 libraries, and the Moonshot Identity Selector software.
3 The jhbuild build tool is used to build software, and must be installed as described at http://developer.gnome.org/jhbuild/unstable/getting-started.html.en.
4 The Gtk+ tool gtk-mac-bundler is used to make the Identity Selector Mac OS application bundle https://live.gnome.org/GTK%2B/OSX/Bundling
5 The Moonshot software requires Kerberos version 1.9.2, which is more recent than the version shipped with the target versions of Mac OS X, so must be downloaded from http://web.mit.edu/kerberos/dist/krb5/1.9/ and unpacked.
6 The software to be installed, the installer package and the disk image are produced by running the script build-installer.sh in this directory. 
7
8 ## Preparation
9 ++++++++++++++
10 1: Install jhbuild, which Creates working folder ~/gtk
11
12 2: Install gtk-mac-bundler as described at https://live.gnome.org/GTK%2B/OSX/Bundlingr
13 Either$ cd ~
14 $ wget http://ftp.gnome.org/pub/gnome/sources/gtk-mac-bundler/0.6/gtk-mac-bundler-0.6.1.tar.bz2
15 $ tar jxvf gtk-mac-bundler-0.6.1.tar.gz
16 $ cd gtk-mac-bundler-0.6.1
17 $ make install
18
19 3: bootstrap jhbuild
20 copy file moonshot/mac-client-installer/.jhbuildrc-custom to $HOME
21 then
22 $ jhbuild bootstrap --ignore-system
23
24 4 MIT Kerberos 1.9.2 Kerberos 
25 Install in ~/gtk/inst to build against - in the Krb5 src directory 
26 $ export CFLAGS="-arch i386"
27 $ ./configure --prefix=$HOME/gtk/inst/
28 $ make
29 $ make install
30
31 Install in moonshot/mac-client-installer/ to include in the Installer package 
32 $ ./configure
33 $ make
34 $ make install DESTDIR=$HOME/moonshot/mac-client-installer/krb
35
36 ## Building the Software, Installer Package and Disk Image
37 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
38 In the folder ~/moonshot/mac-client-installer, run the script build-installer.sh
39 $ ./build-installer.sh
40
41 ## Known issues
42 +++++++++++++++
43 The first time the build-installer.sh script is run the following errors may be generated: 
44
45 *** Error during phase build of perl-xml-parser: ########## Error running make LD_RUN_PATH= *** [6/37]
46 choose  [4] Start shell
47 $ git apply ~/moonshot/mac-client-installer/0001-Remove-arch-ppc-flags.patch 
48 $ make
49 $ exit 
50 choose [2] Ignore error and continue
51
52 make: *** No targets specified and no makefile found.  Stop.
53 *** Error during phase build of cyrus-sasl: ########## Error running make   *** [39/41]
54 choose  [4] Start shell
55 $ ./configure --prefix=/usr/local --with-gss_impl=mit
56 $ exit 
57 choose [1] Rerun phase build
58 *** Error during phase build of cyrus-sasl: ########## Error running make   *** [1/1]
59 choose [1] Rerun phase build
60