Installing a Test App via TestFlight

TestFlight Guide 2015

As of 26 Feb 2015 the old browser version of TestFlight (the one with the 6 propeller icon) will no longer be a valid method of app distribution. The only way to install pre-approved apps will be via the TestFlight interface within iTunes Connect or by sideloading the ad hoc .IPA file to iTunes and then syncing your apps to device.

The best thing about the new iTC TestFlight distribution is that it does not require you to have your device UDID’s registered in the ad hoc provisioning profile (although this is still required if you are sideloading the ad hoc build via iTunes method). What it does is share the binary that you uploaded using Application Loader with you.

NOTE: for this type of distribution to work it requires the app build to contain an App Store Provisioning Profile that was generated after 23 October 2014. If you happen to see this warning on the “Prerelease” page:

then this means that you have an old App Store provisioning profile uploaded. Regenerating this profile, uploading to the "Credentials" section in Oomph Publish and re-building the app will solve this problem (there is no need to re-generate and upload the Ad Hoc Provisioning profile).

Steps for distributing Test App versions:

1. Add testers in iTC. In the top level “Users and Roles” section of iTC and in the “TestFlight Beta Testers” tab select the Oomph account (usually “appleappsupport+[XYZ]@mogeneration.com”) and save.

2. Build and upload your app using Application Loader just as if you were submitting an app update.

3. Navigate to the “Prerelease” tab in iTC. (it usually takes about 5-10min after upload before your new build will show in this section)

4. Enable TestFlight Beta Testing for the version you want to test (you can only have one enabled for testing at a time)

5. Navigate to the “Internal Testers” tab and ensure your account and any others that you want to share the app with are checked and then save. At this stage you can also invite “external” testers. External testers are basically anyone that you want to give access to that does not have an iTC login under this account.

6. The internal and external email addresses will then be sent an email inviting you to test. This email needs to be opened and actioned via the device.

NOTE: You will need the TestFlight app installed (available on the App Store). This will not work if you are using the old TestFlight browser app. The New one has an icon with 3 propellers as opposed to 6.

7. The TestFlight app will allow you to install the test app. If you have multiple devices you need to make sure that all devices are logged into the TestFlight app with the same Apple ID in order for the app to show in each device’s TestFlight app.

NOTE: If everything is setup correctly but the correct version of the app fails to show in TestFlight sometimes it can be helpful to go to the “Builds” screen in iTC, turn off “TestFlight Beta Testing” and then enable it again. This should trigger the email invite again and also refresh the app version being shared with testers.