CS2261-LAB 0 Mac Installation Solved

In this lab, you will be installing the software to write, compile, and run GBA games for this class. It is broken up into various parts. 
Part 1: Docker Desktop
First, you'll need to download Docker Desktop. In order to do this, you'll need to sign up for Docker Hub. Sign up for Docker Hub here: ​https://hub.docker.com/signup​. You can use your personal or GT email; either is fine.

Once you've signed up, follow the detailed Docker Desktop download instruction here:

https://docs.docker.com/docker-for-mac/install/

  

Here, you'll click on the "Download from Docker Hub" button (as seen above) and, granted you're logged into the Docker Hub account you created, you'll be taken to a new page that looks like the following:

  

Press the "Get Stable” button. In your downloads, you'll see "Docker.dmg".

Now, follow the "Install and run Docker Desktop on Mac" instructions on the Docker

Desktop download instructions page

(https://docs.docker.com/docker-for-mac/install/#install-and-run-docker-desktop-on-m​ a c)​ . Stop once you reach the “Uninstall Docker Desktop” section. Great, you've got Docker Desktop on your machine! :) Go to your applications, and click Docker.app, as seen below.

You should see, in the top right of your screen, a little icon that looks like the following:

 

  

This icon indicates that Docker Desktop is running on your machine!​ YOU MUST BE RUNNING DOCKER IN ORDER TO BUILD YOUR CODE​. Otherwise, when you attempt to build your code, you will see the following error:

  

If you see this, you'll know you forget to open the Docker Desktop application.

Part 2: VisualBoyAdvance-M
Let's get the GBA emulator setup! VisualBoyAdvance-M is the emulator for this class. If you already have a GBA emulator that you are comfortable with, I still highly recommend you use this one for this class. It has some special features that will come in handy for debugging.

Find the "​visualboyadvance-m.app​" application in the Lab00 folder in a folder parent folder. I recommend creating a parent CS2261 folder that will contain all of your homework, labs, etc. and keeping the "​visualboyadvance-m.app​" in this folder. Lab00 should be in this CS2261 folder, too. Keep a note of the exact path of the "​visualboyadvance-m.app​". In the image below, you'll see a recommended folder setup. The exact path to

"visualboyadvance-m.app​", in this case, is

/Users/mariezimmy/CS2261/visualboyadvance-m.app 

  

You can verify the directory location of the "​visualboyadvance-m.app​" on your machine by simply opening Finder, opening the CS2261 folder where you placed the

"​visualboyadvance-m.app​", and dragging the "visualboyadvance-m.app" icon into the terminal. The output in the terminal is the exact path to the "​visualboyadvance-m.app​". The sequence of images below shows this process.

  

In this case, as stated before, the exact path is

/Users/mariezimmy/CS2261/visualboyadvance-m.app​. Copy this exact path

and paste it into your task.json, on line 9 in between "open" and "./Project.gba". Make sure there is a space after "open" and before "./Project.gba". The (truncated) image below outlines what my tasks.json looks like. Your exact path on line 9 will be different! Remember to save your changes to your tasks.json file.

  

Part 3: Visual Studio Code
Visual Studio Code is the text editor of choice for this class. We highly recommend you use this editor. If you do not already have VSCode, you can download it here: https://code.visualstudio.com/download​.

Once downloaded, open VSCode, and open the Lab00 folder by selecting File Open Lab00.  

Open main.c and then hit ​cmd+shift+b ​to build your project (remember, Docker Desktop needs to be running!). This first compilation process will take some time because a Docker image is being downloaded from Dockerhub (don’t worry about the nitty gritty details of this). ​All subsequent builds will not take this long ​(whew). In the terminal output in VSCode, you should see something like this for the very first time you build:

  

Once the build is complete, you should see something like the following pop up:

  

If instead you get an error that that says you cannot open the visualboyadvance-m app, follow the instructions here to allow your Mac to open the application from an unidentified developer: ​https://support.apple.com/en-gb/guide/mac-help/mh40616/mac​. Then, try building again. You should see the image above.