Setup GameMaker:Studio for iOS

In order to utilize GameMaker: Studio’s iOS support you will need to first prepare GameMaker:Studio and your device for use as well as fulfill a number of prerequisites from Apple. To make things easier we have outlined below all the necessary steps for you to take in this simple setup process.

What You Need To Get Started
Before beginning to work with the iOS module with GameMaker:Studio, you must be a registered Apple developer and have all certificates and licenses up to date. For more information on becoming a registered Apple Developer and how to get the necessary certificates, please visit the Apple developer site here.

Ideally, you will really need a Mac and a PC to use the iOS module properly, but you can create the whole game app with just a pc and then author it through Apple using a Mac at the end of the process. For those that wish to do it that way, there are services like MacInCloud that can be very useful. Bare in mind that you will still need all the certificates and things outlined below to actually create the final app.

To be able to develop for an apple product there are a number of things that you should have from Apple :


 * 1) Development Certificate - This is the certificate that Apple gives you permitting you to create for their products
 * 2) Provisional Profile - This is what ties a product to your Development Certificate and devices, basically saying "The product I am making can only be tested on these devices"
 * 3) Distribution Certificate - This is not essential for developing but if you wish to put your product on the app store at one point then you will need to buy it from Apple.

Once you have all of the above, you will need to have installed the following tools :


 * On your Mac you need the Xcode Development Environment which can be found for Lion here and for Snow Leopard here (You will need to sign in with your Apple ID).
 * On your PC you should get the iPhone Configuration Utility for Windows which is avaialable here.

Device Compatibility
If you are already a registered developer it is worth noting before starting that nearly all iOS devices are compatible with GameMaker:Studio including :


 * iPhone 3G, 3Gs, 4G, 4Gs
 * iPad 1 & 2
 * iPod Touch 1st, 2nd 3rd Gen

It also doesn't matter if you are testing on an iPhone or an iPad as all iOS project builds created by GameMaker:Studio are, as standard, universal apps. This means that they will run on both iPhone and iPad devices without problems.

Setup GameMaker:Studio And Devices
For GameMaker:Studio to work with the iOS module you will need a Mac computer, an iOS device and your copy of GameMaker:Studio. The following sections ive you all the information you need to get three things set up correctly and working as they should.

GameMaker:Studio Setup
Install GameMaker:Studio and do the following :
 * 1) Launch GameMaker:Studio
 * 2) Enter your License Key
 * 3) Create a new Project
 * 4) Select File>Preferences>Web Server
 * 5) Web Server Port: This is set to 51268 to 51280 by default. There is no need to change this unless these ports are already in use
 * 6) IP Allowed List: Enter your local IP Address here as seen in this example: 192.168.1.1/24

If you are not sure of your local IP address, you can find it easily by following the instructions found here

Mac Setup
So, you are a registered developer and you have Xcode on your Mac, what now? Well, you need to copy over the Application Oven disc image from your pc GameMaker-Studio/iOS folder onto your Mac. This file can be found easily by opening GameMaker:Studio and going to Help>Open GameMaker in Explorer then select the iOS directory and there you will find the .dmg file for the Application Oven. Once you have copied that over to your Mac using a USB stick or over a network connection, you should double-click it and then in the following window you should drag the Application Oven to Applications to install it. This app is necessary due to the fact that the YoYo Runner that is used comes with the certification of YoYo Games, and you will need to change this to your own certification for the iOS module to work properly. When you open the Application Oven you will see something like this :



The fields that you see represent the following :


 * 1) Certificate - This is either iPhone Developer, or iPhone Publisher. The default is developer so if in doubt as to what certificate you use, just leave it as that.
 * 2) Provisioning - This should automatically be detected by the App Oven if you have added the Provisioning Profile to Xcode or the iPhone Configuration Tool.
 * 3) App id - This is the unique name of the runner.

Finally, just click on the Bake Me an Ipa button which will prompt you to enter the directory and a file name for saving your Ipa. Once you have this Ipa, you can use iTunes or the iPhone Configuration Tool to place it on your iOS device.

iOS Device Setup
The first time you test something on your iDevice you will have to make sure that the settings are correct. When the YoYo Runner is started you will be presented with a connection screen where you must do the following :


 * 1) Select Settings
 * 2) Select IP and enter your machines IP (If you are not sure of your local IP address, you can find it easily by following the instructions found here)
 * 3) Select Port and ensure this matches the port number you entered within the GameMaker:Studio prefrences (51268 to 51280 by default, and normally don't need changing)

Running A Game From GameMaker:Studio On Your iOS Device
Once you have set up both GameMaker:Studio and your iOS device, you should do the following :


 * 1) Select the Windows/HTML5/iOS/Android drop down from the tool bar and select iOS as your target
 * 2) Click the Green play button to compile your game
 * 3) On your iDevice, launch the YoYo Runner
 * 4) as soon as the loading bar is complete, your game should appear on your device.

Application Oven can't find my Provisioning Profile
Make sure that Xcode or the iPhone Configuration Utility can find your Provisioning Profile and try the Application Oven again.

My iDevice can't connect to my pc
If your iDevice cannot connect to your pc, you can check the connection by starting the browser in the device and then type '''http://YOUR_MACHINE_ADDRESS:51268/GameAssets.zip. If your device can't find that file then there is a problem with your device. Check and make sure that it is visible over WiFi and that you are on the same network as your pc, then try again.