src/MacOSX/0_HOW_TO_BUILD.txt

                        How to build this source
                        ------------------------

1) Install the OS X Development tools

   Source should build on either 10.0 or 10.1
   (If anyone wants a version that will compile on Public Beta, email me)

2) If grabbing this source from a tarball, put this MacOSX directory in
   BasiliskII-1.0/src. Source is currently only compatible with 1.0 snapshot.

3) Open a Terminal, and cd to BasiliskII-1.0/src/MacOSX

   If the source was grabbed from CVS, run the following commands:

   ln -s /usr/libexec/config.guess .
   ln -s /usr/libexec/config.sub   .
   ln -s ../Unix/acconfig.h .
   ln -s ../Unix/install-sh .

4) type autoconf

   Ignore the warning. autoconf should generate ./configure

5) type ./configure

   This should generate a Makefile and some header files

6) type make

   This should generate some symlinks, the uae_cpu emulator core's source,
   and then the application.

* It is also possible to use the OS X integrated development environment
  (i.e. the "Project Builder" IDE) to build the application, instead of make.
  Instead of step 6) above, do this:

6) make ide

   This should generate some symlinks and the uae_cpu emulator core's source,
   and then open the IDE with the file BasiliskII.pbproj

7) From the Build menu, choose 'Build' or 'Build & Run'

   This should build everything


* There is one file in the source, cpuemu.cpp, which takes _ages_ to
  compile, particularly if optimisation is on. The Unix source splits the
  file into 8 smaller parts to compile separately, but I didn't find that
  really helped on OS X. Basically, you just have to be patient.
Revision:	1.1
Committed:	2002-03-16T03:59:57Z (22 years, 5 months ago) by nigel
Content type:	text/plain
Branch:	MAIN
Log Message:	Initial revision of Mac OS X port code. Uses Objective-C++. Needs Mac OS 10.1
#	User	Rev	Content
1	nigel	1.1	How to build this source
2			------------------------
3
4			1) Install the OS X Development tools
5
6			Source should build on either 10.0 or 10.1
7			(If anyone wants a version that will compile on Public Beta, email me)
8
9			2) If grabbing this source from a tarball, put this MacOSX directory in
10			BasiliskII-1.0/src. Source is currently only compatible with 1.0 snapshot.
11
12			3) Open a Terminal, and cd to BasiliskII-1.0/src/MacOSX
13
14			If the source was grabbed from CVS, run the following commands:
15
16			ln -s /usr/libexec/config.guess .
17			ln -s /usr/libexec/config.sub .
18			ln -s ../Unix/acconfig.h .
19			ln -s ../Unix/install-sh .
20
21			4) type autoconf
22
23			Ignore the warning. autoconf should generate ./configure
24
25			5) type ./configure
26
27			This should generate a Makefile and some header files
28
29			6) type make
30
31			This should generate some symlinks, the uae_cpu emulator core's source,
32			and then the application.
33
34			* It is also possible to use the OS X integrated development environment
35			(i.e. the "Project Builder" IDE) to build the application, instead of make.
36			Instead of step 6) above, do this:
37
38			6) make ide
39
40			This should generate some symlinks and the uae_cpu emulator core's source,
41			and then open the IDE with the file BasiliskII.pbproj
42
43			7) From the Build menu, choose 'Build' or 'Build & Run'
44
45			This should build everything
46
47
48
49			* There is one file in the source, cpuemu.cpp, which takes _ages_ to
50			compile, particularly if optimisation is on. The Unix source splits the
51			file into 8 smaller parts to compile separately, but I didn't find that
52			really helped on OS X. Basically, you just have to be patient.