Testing Your Game on your iOS Device

We'll be phasing out the MAC address restriction by Stencyl 3.0 in favor of simpler, more secure means.

Step 1: Obtain the MAC Address

In order to test your game on your iOS device, you must enter in each device's MAC address into Stencyl. A MAC address is a unique identifier for a device.

You can find this under Settings > General > About > Wi-Fi Address

The value looks like this:

90:45:FD:4E:43:E7

Step 2: Enter the MAC Address in to Stencyl

Enter in the MAC address in Preferences > Mobile

If you wish to run on multiple devices, enter in each address, separated by a comma. For example...

90:45:FD:4E:43:E7,12:34:56:78:90:AA

Step 3: Run the Game

Requirements

• An active iOS Developer License from Apple ($99/yr)
• Your computer must have your developer certificate installed
• The device must be hooked up to your computer
• The OS version on the device must match the SDK version on your computer.

1) Click on Test Game (Device)

2) Xcode will open up.

Troubleshooting - I can't test games on my device.

Reason #1 You must have an iOS developer license from Apple to test on your device.

Buy one or obtain an academic version if your university participates.

Reason #2 - The iOS SDK installed on your computer must match the major/base version on your device.

For example, if you have a device with iOS 4.x, your computer must have iOS SDK 4.x to test on that device. This is a restriction that Apple imposes.

So what if you have a mix of devices on iOS 4 and iOS 5? Install the SDK that matches your preferred testing device and use server builds to test on the others.

Reason #3 - Xcode does not recognize your device.

In Xcode, go to Window > Organizer and then right-click your device in the list and select 'Add Device to Provisioning Portal'

Reason #4 - Your device isn't hooked up to your computer.

Don't overlook the obvious. Does iTunes recognize that your device is hooked up?

Reason #5 - You didn't wait for Xcode to recognize the device.

Xcode takes a few seconds to recognize the device each time. It will typically say "Fetching debug symbols" which is your cue that it's about to find the device. After that finishes loading, then click on the Scheme dropdown and your device should be there.

Reason #6 - You're trying to test an iPad-only game on an iPhone.

Reason #7 - You see "CodeSign error: Certificate identity 'iPhone Developer: YOUR NAME (##########)' appears more than once in the keychain. The codesign tool requires there only be one."

The solution is to go into Organizer - under library - provisioning profiles, delete all of them and then reinstall any profiles still needed.

Troubleshooting - I published an Ad Hoc build. It errors out when installing on my device.

This happens when your game gets built with your App Store profile, rather than your Ad Hoc profile. Games built for the App Store can only be submitted to Apple - they never run on the device.

There is a bug in Stencyl 1.3.4 where building for Ad Hoc mistakenly pulls from the App Store field. This has been fixed for Stencyl 1.4.1. To work around it for now, you can supply the Ad Hoc profile in *both* the Ad Hoc and App Store fields under Preferences > Mobile.

Troubleshooting - Why does testing on the device take so long?

If you test on your device from Xcode, there is a long lag time between when your hit run and when the game begins loading (the loading bar shows up).

This is not Stencyl's fault - it's an inherent part of the Xcode debugging process in which the app is transferred to the device and is set up in debug mode.

Your apps will load much quicker in real-world situations, and the only load time that is attributable to iStencyl is the time between when the loading bar shows and the game begins.

mguido730
If you're like me and do not have access to a mac, go to this link, follow all the instructions but disregard all the stuff about Flash Builder(you don't need it). Once you have all of the certificates and stuff, just put the info into stencyl as shown and hit publish iOS Ad Hoc and they'll email you the build of your game. http://www.adobe.com/devnet/air/art icles/packaging-air-apps-ios.html
0 11 months ago

haim
can i test iOS on PC?
i do have iOS dev account...
0 11 months, 1 week ago

IWC Delvelopers
What do you do next?

0 1 year, 4 months ago

ArtemisFowl2nd
They mean the settings on your iOS Device. The icon with the gears?
0 1 year, 4 months ago

lights0123
where's settings? i only have system preferences.
0 1 year, 5 months ago

Commenting Guidelines