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.
   Open a Terminal, and cd to BasiliskII-1.0/src/MacOSX

3) sh 0prepare_links

   This creates some symlinks to files in the Unix and /usr/libexec directories

4) autoconf

   Ignore the warning. autoconf should generate ./configure

5) ./configure

   This should generate a Makefile and some header files

6) make

   This should generate 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 the uae_cpu emulator core's source,
   and then open the IDE with the file in 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.2
Committed:	2002-03-16T11:50:45Z (22 years, 2 months ago) by nigel
Content type:	text/plain
Branch:	MAIN
Changes since 1.1:	+9 -13 lines
Log Message:	New script to generate symlinks, remove any symlink generation from Makefile, Makefile now generates 8 wrappers for cpuemu.cpp to slightly improve compile time, added the 8 wrappers to the Project Builder file, updated doco
#	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	nigel	1.2	Open a Terminal, and cd to BasiliskII-1.0/src/MacOSX
12	nigel	1.1
13	nigel	1.2	3) sh 0prepare_links
14	nigel	1.1
15	nigel	1.2	This creates some symlinks to files in the Unix and /usr/libexec directories
16	nigel	1.1
17	nigel	1.2	4) autoconf
18	nigel	1.1
19			Ignore the warning. autoconf should generate ./configure
20
21	nigel	1.2	5) ./configure
22	nigel	1.1
23			This should generate a Makefile and some header files
24
25	nigel	1.2	6) make
26	nigel	1.1
27	nigel	1.2	This should generate the uae_cpu emulator core's source,
28	nigel	1.1	and then the application.
29
30			* It is also possible to use the OS X integrated development environment
31			(i.e. the "Project Builder" IDE) to build the application, instead of make.
32			Instead of step 6) above, do this:
33
34			6) make ide
35
36	nigel	1.2	This should generate the uae_cpu emulator core's source,
37			and then open the IDE with the file in BasiliskII.pbproj
38	nigel	1.1
39			7) From the Build menu, choose 'Build' or 'Build & Run'
40
41			This should build everything
42
43
44
45			* There is one file in the source, cpuemu.cpp, which takes _ages_ to
46			compile, particularly if optimisation is on. The Unix source splits the
47			file into 8 smaller parts to compile separately, but I didn't find that
48			really helped on OS X. Basically, you just have to be patient.