Taking the pain out of ad-hoc testing

This post is more of a public service announcement. Prior to Tilt to Live’s Game Center/Retina update we wanted to extensively test the game with a wider tester base. So we ran a small ‘open beta’ (as open as Apple’s ad-hoc program would allow us). Prior to iOS 4.0 users had to do a cumbersome dance to get an ad-hoc game on their devices. And by cumbersome, I mean anything dealing with the desktop iTunes client. There was a lot of room for error, and for those (like me) that loathe syncing with iTunes, it creates a barrier because the act of adding an ad-hoc pretty much wipes my personal device since I buy all my apps 100% on the device and never sync.

Enter iOS 4.0. I discovered this tidbit on Twitter one day. Sadly, I can’t recall who tweeted or retweeted it, but thanks!

With the new iPhone iOS 4, you can distribute apps wirelessly without iTunes intervention. You still need to collect the appropriate devices id’s and create the appropriate provisioning profiles but if you already have those sending out files is easy.

The benefit? Oh where to start? Your testers no longer need to be tethered to a desktop to actually test your app! Our beta e-mails contains direct links to the provisioning and ipa file. The user simply has to tap on both and the game installs over the air! It’s almost easier than buying an app on the app store. The barrier to beta testing has been dramatically lowered because of just this one feature. You can almost coin it as ‘one-click beta installs’. It’s good stuff.

The other upshot? You get more feedback. Some beta testers may simply be out and about and won’t remember to connect to their iTunes client when they return home for the day. We had a lot more responses this go around and even some quick back and forth e-mail discussions as people installed, played, and replied all in one sitting.

Another good thing is we were able to get some ‘field data’ on our Game Center implementation. I would imagine most people have wifi on their homes nowadays. We were getting some feedback from some testers that were on EDGE or 3G that Game Center was causing a long ‘pause’ between games. This was something that didn’t turn up in our internal testing because we’re always on Wifi. Turning over to 3G to test still didn’t give me any hang ups. So just the knowledge that a good portion of people were getting a significantly slower response from GC prompted me to investigate better ways to mitigate this and ‘hide’ the response time delay so users weren’t met with an unresponsive UI.

Downsides? It’s a bit cumbersome to create a build for wireless distro as you’re required to do a ‘build and archive’ from XCode. I have an automated build process for the old-school ad-hoc way. I wish there was a way to automate this as well. I feel that there might be a way, but not sure if ‘build and archive’ is doing any magic behind the scenes. If anyone’s got any info on this or whether xcodebuild has some way of doing this all through the command line please let me know!

A quick guide to build a wireless distro game or app

1. Choose Build->Build and Archive

2. If it already isn’t open, open the Organizer window (window->Organizer) and choose ‘Archived Applications.

3. Highlight the build you just archived and click on “Share Application”

4. Select “Distribute for Enterprise”. The correct provisioning profile should be automatically selected. If not, correct it.

5. At this point you’re presented with a form (pictured below) that you need to fill out.

  • URL: You need to decide beforehand what the name of the ipa and the location on a webserver the file will reside at. For this example we’ll use ‘http://www.onemanleft.com/tilttotlive/Tilt_to_Live.ipa’
  • Title/Subtitle: self explanatory.
  • Large/Small image URL: not needed. But since I had this on hand I just put them in the same folder on the web server as the ipa file.

Now when you click ‘OK’ it will ask you to save the file. Be sure to save it as the same file name you gave it in the URL (in our previous example it was ‘Tilt_to_Live.ipa’).

Now upload both the ipa and plist file to the URL you put in the form. Drop the index.php file created by Jeffrey Sambells in this post to the directory you uploaded the IPA file and you’re good to go. This index file will generate the links for both the provisioning and ipa files.

Now any user that is in the provisioning profile can visit that link in safari on their device and download the app directly. Or more conveniently, you can just copy and those links into an e-mail :).


  1. It won’t do everything you want here, but I’ve written a shell script that should perform a valid Build & Archive from the command line.

    I’ve got it hooked into CruiseControl.rb, and whilst it’s pretty hardcoded to my personal requirements, I’ve released it as a gist under the MIT Licence, so feel free to fork it and make improvements.


    Let me know if it’s useful!

  2. I recently did this with a client and they were completely blown away at how much easier it was to install a developer build than previously. Recommended.

  3. I’ve been doing recently a Ad-Hoc beta for the first time and many users said they didn’t test the app because it required them to sync their iPhone to the desktop iTunes.

    I wish I’d have known about the wireless ad hoc distribution 2 weeks ago 🙂

    Thank you for the post!

  4. Hello,

    I follow the intructions step by step but when I click on my ‘Install Application’ link, I did not get my app installed. It seems that the web browser doesn’t recognize ‘itms-services’ protocol in PC and iPhone.

    How did you fix the problem?

    1. @vdaubry Thanks a lot for the heads up and the article. I’ll definitely be looking over this in a few days as I’ll be updating my build scripts, it looks like exactly what I was looking for :D.

  5. Pingback: ShMarker.com
  6. I have tried this several times and for some reason the provisioning file I keep getting the error “cannot install profile, safari could not install a profile due to an unknown error.” – so clearly something is up with the provisioning file.. any more detail on how to do this correctly

  7. hi am able to open the page but when i click on provisioning profile link, it says safari cannot download the file. I generated the provisioning profile in my developer account of apple and uploaded in the webserver.

    Any clue why this is happening?

  8. I think you should get into the habit of syncing your devices! This should not wipe the apps you purchased on your device … when I sync, iTunes asks me if I want to copy items purchased on the device back to my computer and I say yes. You might want to reset your alerts to make sure you see this option.

    One benefit of syncing is that iTunes backs up your device, including all your app data, contacts, etc. So if you lose or break your device, or just buy an upgrade, setting up a new device to match your old one is painless.

  9. Lindsey:

    I had the same problem. Once I put the correct provisioning profile on my server (the profile for distribution, with my device listed in it), it worked fine.

  10. I am getting the error “Cannot connect to mydomain.com” when i am clicking on the link in iPhone browser. However i can browse my domain in iPhone browser. any help?

  11. Webserver was causing problems, but when I ran it on a local server it finds the files OK – still won’t install, though. AGGGG

    1. For this ad-hoc testing, while I would spend the time troubleshooting it months ago, I think at this point you are *much* better off just using TestFlightApp.com. Let them deal with server-side issues and developers can focus on testing, getting feedback, and rolling out new builds quickly and painlessly. They even have an API if you want to have automated builds.

  12. Pingback: Anonymous
  13. Checkout, AppBox, a mac application that uses your dropbox account to distribute you ad-hoc and enterprise apps, if you want to install form any other browser.

    Auto E-Mail App Distribution Link
    Auto Shutdown Mac after Distribution
    Maximum Upload Size => Equal to your Dropbox account storage
    Uploaded App Expiration => Until you delete from your Dropbox
    Installations Per App => Unlimited


Leave a Reply

Your email address will not be published. Required fields are marked *