Reddit Post: https://redd.it/517jyi

Introduction

GBA4IOS is a Game Boy Advance emulator for iDevices. This is a tutorial for side-loading GBA4IOS, which simply means loading the application onto your device from your personal Mac.

I installed a Mac Virtual Machine on my Mac (I know) and documented the process which I used to side-load GBA4IOS on my iPad. My Virtual Machine was a completely new installation of OSX 10.12 (macOS Sierra) and my iPad had been formatted prior to this guide. The process is exactly the same as on the iPhone.

This guide is based off this post on Reddit by /u/psa-gba4ios.

Notes (for the Less Tech Savvy)

This guide was written for you. Side loading may seem like a very complicated task and I know Terminal looks daunting if you’re unfamiliar with it. This is a visual guide so I made sure to include a lot of pictures.

When you see “run the command” in this tutorial, simply copy and paste the command into Terminal and hit enter once. Sometimes Terminal may prompt you for verification or to input your password. You’ll know when Terminal has completed the command when the bottom most line is in the form of

(computer name):(folder name / ~) (username)$ 1 ( computer name ) : ( folder name / ~ ) ( username ) $

In my computer, for example, it would show Certain key words are underlined to make it easier to identify them on your machine. I’m using the beta of an upcoming version of macOS, do not worry if the screenshots do not look exactly like what is shown on your screen.

Requirements

Apple ID Mac with Xcode Installed (Found in the App Store) An iDevice An active internet connection Patience (literally the most important thing)

Step 1 – Install Xcode

Go to the App Store and download Xcode. Once it is downloaded, locate it in your Applications folder.

Open it and Accept the License Agreement. A pop up will appear and display Installing components…, wait until the installation is completed.

Once completed, you will presented with the Welcome to Xcode window.

Close Xcode.

Step 2 – Install Homebrew

Open Terminal (Found in /Applications/Utilities/Terminal.app).

Run the following command.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 1 / usr / bin / ruby - e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

You may be prompted to hit Enter or to enter your password into the Terminal window. Note that your password will not appear as you type it in Terminal (unlike in a text box).

When the process is completed, the Terminal window will look as so.

Step 3 – Set Up

Run the following command.

brew update && brew install ruby git 1 brew update && brew install ruby git

Run the following two commands. You’ll be prompted to enter your password. During these two commands, Terminal may seem unresponsive, but you have to be patient.

sudo gem install activesupport -v 4.2.6 1 sudo gem install activesupport - v 4.2.6

sudo gem install cocoapods 1 sudo gem install cocoapods

Once the commands have completed, the Terminal window should look as so.

Step 4 – Download the Source Code for GBA4IOS

Create a folder on your Desktop called GBA4IOS. Run the following command.

cd ~/Desktop/GBA4IOS 1 cd ~ / Desktop / GBA4IOS

This will change the directory to the newly created folder.

Run the following command.

git clone https://bitbucket.org/rileytestut/gba4ios/branch/master 1 git clone https : //bitbucket.org/rileytestut/gba4ios/branch/master

This may take a while depending on your internet speed. When it is completed, the Terminal window will look as so.

Run the following command.

cd master 1 cd master

Then

curl -o Podfile https://pastebin.com/raw/MKAFdU7T 1 curl - o Podfile https : //pastebin.com/raw/MKAFdU7T

Step 5 – The annoying CocoaPods part

This is the most annoying part of the process. Mainly because Terminal will appear unresponsive while it downloads a roughly 488MB file.

pod install --verbose 1 pod install -- verbose

The Terminal window will look like this for a long time. Be prepared to wait.

To keep your morale high, open Activity Monitor (found in /Applications/Utilities/Activity Monitor.App) and click on the Network tab. Find git-remote-https and notice as Rcvd Bytes increases. This is how you know it’s working.

When it is completed, the Terminal window will look as so.



After this, you can finally close Terminal.

Step 6 – Open GBA4IOS in Xcode

Open the GBA4IOS folder on your Desktop and locate a file called GBA4iOS.xcworkspace (not GBA4iOS.xcodeproj).

Xcode will open. At the very top Xcode will display Indexing. Leave it alone to complete.

When complete, the text will change to GBA4iOS: Ready.

Step 7 – Plug in your iDevice

Plug your iDevice into your computer. On Xcode, click the dropdown box as shown below and select your device [1]. You may need to wait for Xcode to complete Processing symbol files [2].

Xcode will show GBA4iOS: Ready when it’s ready.

Step 8 – Side-Load GBA4IOS

In Xcode, click the folder icon [1], click GBA4iOS [2] and change the Bundle Identifier to something unique to you (literally anything). For the sake of this tutorial, I’m going to change it to com.fuzzicode.GBA4IOSTutorial.

Click Fix Issue [1] and Add… [2].

A pop up will show. Login with your Apple ID.

After signing in, you’ll see your Apple ID show up on the left bar. I have censored personal information.

Take note of the item under Team. Close the window and go back to Xcode. In Xcode, click on the dropdown box and select your created Team.

Click Choose, there should be no more Code Signing issues.

On the same page, scroll all the way down until you see Linked Frameworks and Libraries. Locate libPods.a and click on the – button.

Find the following button at the top left corner of Xcode and click it.

You may be prompted to Enable Developer Mode on your Mac. Click Enable.

You may also be prompted to allow codesign access to your keychain. Click Always Allow.

After some time, Xcode should look as so. Don’t worry, this is normal.

Click OK.

Step 9 – Onto Your iDevice

Back on your iDevice, you should see GBA4iOS. Do not open it yet.

Instead, head over to Settings. Click on General and find Device Management. It will have a label of your Apple ID.

You should see a screen like so.

Click on the item with your Apple ID under Developer App. On the next screen, locate Trust (your Apple ID) and click it. On the next pop up, click the red Trust.

Step 10 – Launch that Sh*t

Exit out of Settings and open GBA4IOS.

If everything is successful, you have successfully side loaded GBA4IOS. Congratulations and enjoy!

If possible, do leave a comment on the Reddit thread.