ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/src/MacOSX/0_HOW_TO_BUILD.txt
Revision: 1.9
Committed: 2004-05-02T11:34:49Z (20 years, 1 month ago) by nigel
Content type: text/plain
Branch: MAIN
CVS Tags: nigel-build-16
Changes since 1.8: +10 -12 lines
Log Message:
Added notes about the classic version of the app

File Contents

# 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 nigel 1.9 (i.e. "Project Builder" or Xcode) 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.3 5) From the Build menu, choose 'Build' or 'Build & Run'
33 nigel 1.1
34     This should build everything
35 nigel 1.5
36    
37    
38     Notes:
39    
40     1) Compiling cpuemu.cpp takes 58 seconds on my 384MB G4 400.
41     Compiling it as separate files (cpuemu1.cpp thru cpuemu8.cpp)
42     takes 68 seconds on the same machine. If you have less RAM,
43     it may be faster to compile it as separate files.
44    
45     2) For some reason, compiling on 10.2 with DIRECT_ADDRESSING 1
46     results in an executable that cannot write to the screen.
47 nigel 1.9 Building in XCode on 10.3 fixed this for me, but not for
48     other users.
49 nigel 1.5
50 nigel 1.9 3) If you want to change the addressing default
51     (which is currently direct), you have to reconfigure.
52     (i.e. make clean; ./configure --enable-addressing=banks)
53    
54     4) To emulate a Mac Classic, or any Mac with 24bit addressing,
55     the app needs to be built with the above (bank) style addressing.
56     This is how I build the "classic" version of the app.