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. The tarball is currently only compatible with the
   BasiliskII_src_15012002.tar.gz (1.0) snapshot.
   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,
   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 4) above, do these steps:

4) make ide

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

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) For some reason, compiling on 10.2 with DIRECT_ADDRESSING 1
   results in an executable that cannot write to the screen.

3) If you want to change the REAL_ADDRESSING or DIRECT_ADDRESSING
   defaults in sysdeps.h, you will need to reconfigure.
   (i.e. make distclean; sh 1_prepare_files.sh)
Revision:	1.5
Committed:	2003-01-10T23:00:43Z (21 years, 5 months ago) by nigel
Content type:	text/plain
Branch:	MAIN
CVS Tags:	nigel-build-12, nigel-build-13
Changes since 1.4:	+16 -0 lines
Log Message:	Added a few notes on different compilation strategies
#	Content
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. The tarball is currently only compatible with the
11	BasiliskII_src_15012002.tar.gz (1.0) snapshot.
12	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	and then the application.
25
26	* It is also possible to use the OS X integrated development environment
27	(i.e. the "Project Builder" IDE) 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 IDE with the file in BasiliskII.pbproj
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) For some reason, compiling on 10.2 with DIRECT_ADDRESSING 1
49	results in an executable that cannot write to the screen.
50
51	3) If you want to change the REAL_ADDRESSING or DIRECT_ADDRESSING
52	defaults in sysdeps.h, you will need to reconfigure.
53	(i.e. make distclean; sh 1_prepare_files.sh)