[Solved] CS2261 LAB00-Mac Installation

Provided Files, Folders, and Executables

• .vscode (folder)

tasks.json

• Makefile
• c
• Dockerfile
• visualboyadvance-m.app

Files to Edit

• tasks.json

Instructions

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. If any part does not produce the expected outcome, alert a TA via Teams and fix the problem before continuing. It is incredibly important that you read each and every instruction. Many of your questions will be answered if you read carefully. Do not skim this document! 🙂

Part 1: Docker Desktop

First, youll need to download Docker Desktop. In order to do this, youll 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 youve signed up, follow the detailed Docker Desktop download instruction here:

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

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

Press the Get Stable button. In your downloads, youll 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, youve 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, youll know you forget to open the Docker Desktop application.

Part 2: VisualBoyAdvance-M

Lets 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, youll 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 (dont 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.

If you do, congrats, follow the submission instructions 🙂 If not, recall, you need to have

Docker Desktop running to build your code! If this is not your issue, notify a TA via Teams.