|
BUILD
XcodeMacintosh OS X - PowerPC XcodeMicrosoft Windows Microsoft Visual C++Macintosh OS 9 MPWLinux Linux command lineSolaris Gnu C compiler |
How to build the Mini vMac program
from the source code.
First download the source code archive, a file with a name in the form “minivmac-x.y.z.src.zip” (where x.y.z is replaced by the version number). Extract from this zip file a disk image (with a name in the form “minivmac-x.y.z.src.dsk”). Now launch Mini vMac (version 3.0.0 or later), booting from a disk image containing a system folder. (The source code disk image doesn't contain a system folder.) (See the Start page for information about getting started with Mini vMac.) Mount the source code disk image in Mini vMac. At the top level of this disk is an application named "Build". Launch this application. A text editing window will open in which to type in the desired options. Only the “Target” option is required. Type in a line such as: -t imchIf this option is used by itself, the build system will generate the files needed to compile the standard version of Mini vMac for Macintosh OS X on Intel using Apple's Xcode 2.4.1 development environment. Options for some other targets and development environments are listed below. You may also type in other options listed on the Mini vMac Options page. Each option can be on a separate line, or can instead be separated by a spaces. (The new line, space, and tab characters are equivalent.) The build system ignores text contained in brackets (between and including the symbols ‘{’ and ‘}’), so you don't need to type these comments. When you are done specifying options, choose the ‘Go’ command from the File menu (of the emulated Macintosh). The build system will generate an archive containing all the files needed to compile Mini vMac with the chosen options. When the build system is run Mini vMac 3.0.0 or later, it will automatically export this archive to the real computer. If the build system is run on a different emulator, or a real 680x0 Macintosh, this archive will be left in the folder “output”, in the folder containing the “Build” application. Extract this archive on your real computer, and the resulting folder has all the files needed to compile Mini vMac with your development environment. More specific instructions for various targets and development environments follow: |
Macintosh OS X - Intel
Use this option in the build system:-t imchExtract the archive and in the resulting folder open “minivmac.xcodeproj”. Choose the “Build” command from the “Build” menu. When it finishes there should now be a program called “minivmac” in the same folder.
Macintosh OS X - PowerPC
Use this option in the build system:-t machExtract the archive and in the resulting folder open “minivmac.xcodeproj”. Choose the “Build” command from the “Build” menu. When it finishes there should now be a program called “minivmac” in the same folder.
Building with Metrowerks CodeWarrior:
Mini vMac was last tested with version “8.3”. Use this option in the build system:-t mach -e mw8Launch the CodeWarrior IDE, and choose the “Import Project ...” command from the “File” menu. select the file “minivmac.mcp.xml”. It then asks where you wish to put the project file. You must put it in the same folder as “minivmac.mcp.xml” or it won’t work. Unfortunately, the dialog doesn’t default to this folder. You can name the file “minivmac.mcp”, but the exact name doesn’t matter. You can now choose the “Make” command from the “Project” menu, and when it finishes there should now be a program called “minivmac” in the same folder.
Microsoft Windows
Building with Microsoft Visual C++ 2005 Express Edition:
Use this option in the build system:-t wx86Extract the archive and in the resulting folder open the file “minivmac.sln”. Choose the “Build Solution” command from the “Build” menu. When it finishes there should now be a program called “minivmac.exe” in the same folder.
Building with the lcc-win32 system:
Use this option in the build system:-t wx86 -e lccLaunch lcc-win32 and choose the “Import...” command from the “Project” menu. Select the file “minivmac.prj”. Choose the “Make” command from the “Compiler” menu. When it finishes there should now be a program called “minivmac.exe” in the same folder.
Building with Bloodshed Dev-C++:
Mini vMac was last tested with version “4.9.8.0”.Use this option in the build system:
-t wx86 -e dvcLaunch Bloodshed Dev-C++ and choose the “Open Project or File...” command from the “File” menu. Select the file “minivmac.dev”. Choose the “Compile” command from the “Execute” menu. When it finishes there should now be a program called “minivmac.exe” in the same folder.
Building with Metrowerks CodeWarrior:
Mini vMac was last tested with version “8.3”.Use this option in the build system:
-t wx86 -e mw8Launch the CodeWarrior IDE, and choose the “Import Project ...” command from the “File” menu. select the file “minivmac.mcp.xml”. It then asks where you wish to put the project file. You must put it in the same folder as “minivmac.mcp.xml” or it won’t work. You can name the file “minivmac.mcp”, but the exact name doesn’t matter. You can now choose the “Make” command from the “Project” menu, and when it finishes there should now be a program called “minivmac” in the same folder.
Macintosh OS 9
Building with the Macintosh Programmers Workshop:
Mini vMac was tested with the most recent version, with the updated components from 12/04/02. No further MPW updates are expected.Use this option in the build system:
-t mppcSet the current directory to the extracted folder. (One way to do this is the “Set Directory...” command in the “Directory” menu.) Type “make” in the Worksheet window in a line by itself, and then press the “Enter” key to execute this command. This creates a list of commands. Select all of these commands (one way to do this is to use the “undo” command twice) and then press the “Enter” key to execute them. When the cursor stops spinning, there should now be a program called “minivmac” in the same folder.
Building with Metrowerks CodeWarrior:
Mini vMac was last tested with version “8.3”.Use this option in the build system:
-t mppc -e mw8Launch the CodeWarrior IDE, and choose the “Import Project ...” command from the “File” menu. select the file “minivmac.mcp.xml”. It then asks where you wish to put the project file. You must put it in the same folder as “minivmac.mcp.xml” or it won’t work. Unfortunately, the dialog doesn’t default to this folder. You can name the file “minivmac.mcp”, but the exact name doesn’t matter. You can now choose the “Make” command from the “Project” menu, and when it finishes there should now be a program called “minivmac” in the same folder.
Linux
Building with the Linux command line:
Mini vMac for Linux is compiled with the Gnu tools in Red Hat Linux 7 (running in Microsoft Virtual PC). But is has also been compiled on a number of other Linux distributions without change. It probably should work with most Linux distributions, and some other Unix and similar operating systems, perhaps with some adjustments to the Makefile and the configuration files.Use this option in the build system:
-t lx86Open a terminal window and change the current directory to the extracted folder. (Such as by using the “cd” command.) Then type “make” (and press return). When it finishes, there should now be a program called “minivmac” in the same folder.
Solaris
Building with the Gnu C compiler:
For SPARC use this option in the build system:
-t slrsFor Intel use this option in the build system:-t sl86(There currently isn't any difference in the source generated for SPARC and Intel except for the version name.)Open a terminal window and change the current directory to the extracted folder. (Such as by using the “cd” command.) Then type “make” (and press return). When it finishes, there should now be a program called “minivmac” in the same folder.