src/MacOSX/0_HOW_TO_BUILD.txt

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

1) Install the OS X Development tools

   Source should build on 10.0 thru 10.2, and should be OK with 10.3
   (If anyone wants a version that will compile on Public Beta, email me)

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,
   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 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) 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 REAL_ADDRESSING or DIRECT_ADDRESSING,
   you need to reconfigure. Safest way is to "make distclean",
   and then to change the --enable flag in 1_prepare_files.sh

4) A few times I have had link errors on 10.1 like:
   Undefined symbol: _assign__t18string_char_traits1ZcRcRCc
   A web search reveals that this is a problem in Apple's AppKit
   framework, and that adding the lib stdc++ should help.
   defaults in sysdeps.h, you will need to reconfigure.
   (i.e. make distclean; sh 1_prepare_files.sh)
Revision:	1.8
Committed:	2004-01-28T07:20:36Z (20 years, 4 months ago) by nigel
Content type:	text/plain
Branch:	MAIN
CVS Tags:	nigel-build-15
Changes since 1.7:	+10 -2 lines
Log Message:	Mention Xcode, add note about strange 10.1 linking bug
#	User	Rev	Content
1	nigel	1.1	How to build this source
2			------------------------
3
4			1) Install the OS X Development tools
5
6	nigel	1.7	Source should build on 10.0 thru 10.2, and should be OK with 10.3
7	nigel	1.1	(If anyone wants a version that will compile on Public Beta, email me)
8
9	nigel	1.7	2) Open a Terminal, and cd to BasiliskII-1.0/src/MacOSX
10	nigel	1.1
11	nigel	1.3	3) sh 1_prepare_files.sh
12	nigel	1.1
13	nigel	1.3	This creates some symlinks to files in the Unix source and
14			/usr/libexec directories, generates ./configure, and runs it.
15	nigel	1.1
16	nigel	1.3	The end result is a Makefile and some header files
17	nigel	1.1
18	nigel	1.3	4) make
19	nigel	1.1
20	nigel	1.2	This should generate the uae_cpu emulator core's source,
21	nigel	1.1	and then the application.
22
23			* It is also possible to use the OS X integrated development environment
24			(i.e. the "Project Builder" IDE) to build the application, instead of make.
25	nigel	1.4	Instead of step 4) above, do these steps:
26	nigel	1.1
27	nigel	1.3	4) make ide
28	nigel	1.1
29	nigel	1.2	This should generate the uae_cpu emulator core's source,
30	nigel	1.8	and then open the project in the Project Builder or Xcode IDE.
31
32	nigel	1.1
33	nigel	1.3	5) From the Build menu, choose 'Build' or 'Build & Run'
34	nigel	1.1
35			This should build everything
36	nigel	1.5
37
38
39			Notes:
40
41			1) Compiling cpuemu.cpp takes 58 seconds on my 384MB G4 400.
42			Compiling it as separate files (cpuemu1.cpp thru cpuemu8.cpp)
43			takes 68 seconds on the same machine. If you have less RAM,
44			it may be faster to compile it as separate files.
45
46			2) For some reason, compiling on 10.2 with DIRECT_ADDRESSING 1
47			results in an executable that cannot write to the screen.
48
49	nigel	1.8	3) If you want to change REAL_ADDRESSING or DIRECT_ADDRESSING,
50			you need to reconfigure. Safest way is to "make distclean",
51			and then to change the --enable flag in 1_prepare_files.sh
52
53			4) A few times I have had link errors on 10.1 like:
54			Undefined symbol: _assign__t18string_char_traits1ZcRcRCc
55			A web search reveals that this is a problem in Apple's AppKit
56			framework, and that adding the lib stdc++ should help.
57	nigel	1.5	defaults in sysdeps.h, you will need to reconfigure.
58			(i.e. make distclean; sh 1_prepare_files.sh)