|
1 ============================================================================== |
|
2 Using the Simple DirectMedia Layer with Mac OS X |
|
3 ============================================================================== |
|
4 |
|
5 These instructions are for people using Apple's Mac OS X (pronounced |
|
6 "ten"). |
|
7 |
|
8 From the developer's point of view, OS X is a sort of hybrid Mac and |
|
9 Unix system, and you have the option of using either traditional |
|
10 command line tools or Apple's IDE ProjectBuilder (PB). |
|
11 |
|
12 To build using the command line, use the standard configure and make |
|
13 process: |
|
14 |
|
15 ./configure |
|
16 make |
|
17 make install |
|
18 |
|
19 (You may need to create the subdirs of /usr/local manually.) |
|
20 |
|
21 For some reason, libtool doesn't run ranlib properly, so do this |
|
22 manually: |
|
23 |
|
24 ranlib /usr/local/lib/libSDL.a |
|
25 |
|
26 To use the library once it's built, you need to use the "Carbon |
|
27 framework", which is the port of the old Mac Toolbox to OS X. |
|
28 To do this, use the -F and -framework arguments for compiling |
|
29 and linking, respectively: |
|
30 |
|
31 cc -c myprog.c -I/usr/local/include/SDL -F/System/Library/Frameworks/Carbon.framework |
|
32 cc myprog.o -L/usr/local/lib -lSDL -framework Carbon |
|
33 |
|
34 sdl-config knows about the linking path and -framework, so it's |
|
35 recommended to use it to fill in your Makefile variables. |
|
36 |
|
37 [Add instructions for how to build using PB] |
|
38 |
|
39 As of this writing (Sep 2000), OS X is in public beta. This means |
|
40 that while most of the APIs are frozen, things are still subject to |
|
41 change, and many of the known problems will be resolved before the |
|
42 final release comes out. |
|
43 |
|
44 Known bugs are listed in the file "BUGS" |