Diff of /INSTALL.macosx [000000] .. [f87cfd]  Maximize  Restore

Switch to unified view

a b/INSTALL.macosx
1
BUILDING THE UR-QUAN MASTERS ON MAC OS X
2
3
You'll need a number of libraries to build it.  All are available
4
online:
5
6
SDL: http://www.libsdl.org/download-1.2.php
7
Only the Runtime is truly necessary, but the devel extras are nice.
8
9
SDL_image: http://www.libsdl.org/projects/SDL_image/
10
11
Ogg Vorbis: http://www.xiph.org/downloads/
12
Theoretically optional, but necessary if you're using the 3DO music
13
or voices. You'll need libogg, libvorbis, and libvorbisfile.  The last
14
two are part of the Vorbis framework.
15
16
PREPARING THE LIBRARIES
17
18
For SDL and SDL_image:
19
- Install the SDL and SDL_image frameworks in /Library/Frameworks as
20
  instructed in the files.  The SDL-devel extras go in their own
21
  place, as noted in the instructions.
22
23
Unzip the libogg and libvorbis archives somewhere convenient.
24
25
For libogg:
26
- Go to the macosx directory, open the xcodeproj.
27
- Open Project->Project Settings and set the Configuration to
28
  "Release".  Ensure the Architecture is set to "i386 ppc".
29
- If you are using XCode 3.2.1 (Snow Leopard), you will need to use
30
  GCC 4.0 instead of the default 4.2 (which will not work for the 10.4
31
  target).  Inside Project Settings, add the following User-Defined
32
  Settings via the gear menu at the bottom left:
33
  - GCC_VERSION_i386 = 4.0
34
  - GCC_VERSION_ppc  = 4.0
35
- Choose the "10.4 | Release" target and build.
36
- If there are no errors, the Ogg.framework file should have turned
37
  from red to black.  Control-click it, choose "reveal in finder".
38
- Copy Ogg.framework to /Library/Frameworks.
39
40
For libvorbis:
41
- Same procedure as libogg.
42
43
To build:
44
- Run ./build.sh in the sc2/ directory and choose your configuration
45
  options.  The only truly important one is to use Included MikMod
46
  instead of System MikMod.
47
- If the build fails because SDL_include.h has errors, run 
48
49
    ./build.sh uqm clean
50
51
  then 
52
53
    CFLAGS="-I/Library/Frameworks/SDL.framework/Headers" ./build.sh uqm config
54
55
  You'll need to set that CFLAGS in that manner each time you
56
  reconfig, but not each time you rebuild. (So, every time you clean,
57
  you'll need to reset that CFLAGS.)
58
59
- If it builds without errors (last line is LINK uqm or LINK
60
  uqm-debug), ./build.sh uqm install to build the .app.