Skip to content

Getting Started Mac OSX

Bob Baker edited this page Oct 5, 2020 · 19 revisions

A lot of this is outdated. Documentation is slowly moving over to sap1emu.net/Docs/Docs

To get started download the latest release for your system at the Releases page. The following Windows platforms will be supported:

  • Mac-OSX.10.14-x64

In addition to the command-line programs, the SAP1Emu Project will also support a single GUI using Electron.NET, a wrapper around Electron allowing for ASP.NET Core Linkage. This GUI should be able to run on Windows, Linux, and OSX with x64-bit architecture. ARM will most likely not be supported.

The GUI program is still under development, but instructions for installing it will be found here.

Extracting the Files

The files come as .tar files to save space when uploading. OXS should natively support .tar files.

  1. Download the SAP1Emu-CLI-osx.10.14-x64.tar file from the Releases page
  2. Save the file to your Desktop
  3. Double Click the .tar file. MacOSX should automatically extract the file and place it right next to the .tar file
  4. Open the folder named osx.10.14-x64 and you should see the following contents (you can rename this new folder to "SAP1Emu" if you want)

Installing the .Net Core Runtime

Download the .Net Core Runtime form Microsoft Docs and run the .pkg file by clicking on it in your browser. You should see the following: Continue thought the prompts until you finish. Once you are done, you can safely move the installer to the trash.

Testing the Download

The SAP1Emu command-line tools are "run in place". This means, once downloaded, you can just run the files without running an installer.

The SAP1Emu GUI will have an all-in-one installer.

To test the download, follow these steps:

  1. Open the terminal app and navigate to the folder where the files are located. For example:
cd Desktop/osx.10.14-x64

  1. Once in the correct folder, run the following command in the terminal
./SAP1Emu

You should see the following response:

If you see an error regarding .Net Core Runtimes, please repeat the Installing the .Net Core Runtime section.

You're Done

Please see the Your First Program page to learn how to make the assembly files.