Getting Started

The Dolphin sources are available on GitHub in two repositories.

  • Dolphin - This is the Dolphin image and the means to build the various product incarnations from a prebuilt boot image, DBOOT.img7.

  • DolphinVM - This is the Dolphin Smalltalk virtual machine and the helper DLLs for deploying to the different Windows target formats. The above Dolphin repository already contains the executables for the virtual machine components so, unless you feel that you need to recompile them, there is no need to be concerned with DolphinVM.

Building the Dolphin 7 Product Images

  • First clone the Dolphin repository into a suitable working directory on your machine. Any version of Windows from XP onwards should be suitable.

  • In the new directory you will find a number of CMD files used boot the images for the various products. Three such products are available, DCORE, DCE and DPRO. Normally, you will want to use DPRO only, since this is a superset of all the others. However, it is worthwhile booting all of the products after each change to make sure that nothing in the boot sequence has been broken. This can be done with the BootAll CMD file.

  • Double-clck BootAll.cmd. A console window will open and sequentially spawn the individual boot jobs. Depending on the heritage of your Windows environment, you may see a failure message saying that MSVCRT120.DLL cannot be found. If this is the case on your system, you will need to download and install the Visual Studio 2013 Redistributable components. Since Dolphin is a 32 bit application you’ll only need vcredist_x86.exe. Once done, try the BootAll again.

  • Note, since the initial release we have noticed that Dolphin 7 will not boot correctly when there is an installation of Dolphin X6 on the same machine. For the time being, until this is resolved, please remove Dolphin X6 before trying to boot or use Dolphin 7.

  • When the boot processes have completed, you should see a number of .img7 files in your directory. IMG7 is the new image extension for Dolphin 7. You should right click on DPRO.img7 and choose Open With…, selecting Dolphin7.exe as the executable to be permanently associated with this file type.

  • You should see Dolphin Professional 7 launch successfully. I’ll leave it as an exercise for the reader to work out how to dismiss the splash screen.

Building the Virtual Machine

  • In order to build the virtual machine components you will first have to clone the Dolphin repository as mentioned above. Note that, you'll only need to build DolphinVM if you need to explicitly change the VM itself.

  • You should clone DolphinVM into a DolphinVM\ subdirectory of Dolphin\Core.

  • Load the DolphinVM solution into MSVC 2013 Community Edition or later. This is a C++ set of projects so make sure you install this version of MSVC. Choose the Release profile (Debug will not compile) and then Build Solution. The first time you'll get errors but these should disappear after a second Build. A bunch of DLLs and Dolphin.exe will have been copied to the Dolphin\ root folder.

  • Then proceed as indicated above in order to boot the various product images.