src/MacOSX/0_HOW_TO_BUILD.txt

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

1) Install the OS X Development tools

   Source now only builds on 10.2 and 10.3. On 10.1, there are a few
   compile and link errors that I just can't be bothered to fix.
   On 10.4 when doing Xcode builds, there are problems with the way that
   I have built libslirp.a. For now, do "make" instead of "make ide".


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

3) sh 1_prepare_files.sh

   This creates some symlinks to files in the Unix source and
   /usr/libexec directories, generates ./configure, and runs it.

   The end result is a Makefile and some header files

4) make

   This should generate the uae_cpu emulator core's source,
   compile the SLIRP sources and then the application.

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

4) make ide

   This should generate the uae_cpu emulator core's source,
   and then open the project in the Project Builder or Xcode IDE.

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

   This should build everything


Notes:

1) Compiling cpuemu.cpp takes 58 seconds on my 384MB G4 400.
   Compiling it as separate files (cpuemu1.cpp thru cpuemu8.cpp)
   takes 68 seconds on the same machine. If you have less RAM,
   it may be faster to compile it as separate files.

2) If you want to change the addressing default
   (which is currently direct), you have to reconfigure.
   (i.e. make clean; ./configure --enable-addressing=banks)

3) To emulate a Mac Classic, or any Mac with 24bit addressing,
   the app needs to be built with the above (bank) style addressing.
Revision:	1.12
Committed:	2006-01-05T03:37:56Z (18 years, 5 months ago) by nigel
Content type:	text/plain
Branch:	MAIN
CVS Tags:	nigel-build-19
Changes since 1.11:	+2 -2 lines
Log Message:	10.4 builds are fine, but not when using Xcode
#	Content
1	How to build this source
2	------------------------
3
4	1) Install the OS X Development tools
5
6	Source now only builds on 10.2 and 10.3. On 10.1, there are a few
7	compile and link errors that I just can't be bothered to fix.
8	On 10.4 when doing Xcode builds, there are problems with the way that
9	I have built libslirp.a. For now, do "make" instead of "make ide".
10
11
12	2) Open a Terminal, and cd to BasiliskII-1.0/src/MacOSX
13
14	3) sh 1_prepare_files.sh
15
16	This creates some symlinks to files in the Unix source and
17	/usr/libexec directories, generates ./configure, and runs it.
18
19	The end result is a Makefile and some header files
20
21	4) make
22
23	This should generate the uae_cpu emulator core's source,
24	compile the SLIRP sources and then the application.
25
26	* It is also possible to use the OS X integrated development environment
27	(i.e. "Project Builder" or Xcode) to build the application, instead of make.
28	Instead of step 4) above, do these steps:
29
30	4) make ide
31
32	This should generate the uae_cpu emulator core's source,
33	and then open the project in the Project Builder or Xcode IDE.
34
35	5) From the Build menu, choose 'Build' or 'Build & Run'
36
37	This should build everything
38
39
40
41	Notes:
42
43	1) Compiling cpuemu.cpp takes 58 seconds on my 384MB G4 400.
44	Compiling it as separate files (cpuemu1.cpp thru cpuemu8.cpp)
45	takes 68 seconds on the same machine. If you have less RAM,
46	it may be faster to compile it as separate files.
47
48	2) If you want to change the addressing default
49	(which is currently direct), you have to reconfigure.
50	(i.e. make clean; ./configure --enable-addressing=banks)
51
52	3) To emulate a Mac Classic, or any Mac with 24bit addressing,
53	the app needs to be built with the above (bank) style addressing.