My app crashes while offline, will I get the report?


TestFairy keeps crashes on disk if it can't send them immediately. The next time the app runs, TestFairy will send out the saved crash reports and attach them to the appropriate sessions.

Will crashes be caught even after a session stopped recording?


Session max-duration controls how much of the session will be recorded. Many developers won't be interested in video recording beyond the initial 10 minutes. Crashes are caught regardless of the max-duration limit.

In cases where a crash happens beyond the max-duration limit, the report will be attached to the session, along with the part that was recorded.

Back to top

Which architectures are supported?

TestFairy iOS SDK supports the following architectures (CPUs):

  • ARMv7
  • ARMv7s
  • ARM64
  • i386 (simulator)
  • x86_64 (simulator)

Back to top

Which iOS platforms are supported?

TestFairy SDK is a static library, therefore it runs on any platform that uses XCode for compilation. For ease of integration, TestFairy is also available as:

  • Cocoapods
  • Xamarin binding (both 32-bit and 64-bit)
  • .NET assembly (.DLL)
  • .NET assembly via NuGET package
  • Xamarin binding through Xamarin Component Store
  • Unity plugin
  • Adobe Air Extension (.ANE)
  • PhoneGap / Cordova plugin
  • Titanium
  • React-Native

Back to top

Am I required to use the TestFairy SDK?

The TestFairy platform is used for both distribution and for analytics. You can use either both, or just one of them.

App distribution does not require integration of the TestFairy SDK and provides an easy-to-use platform for sending iOS IPA files to testers and colleagues in your enterprise. Simply upload an Ad Hoc or Enterprise signed IPA files and send e-mail invitation to the selected testers.

Using analytics requires integration of the SDK. This is a 2-minute task that involves adding just a single line of code to your project. With analytics enabled, you will able to see a video recording of your app being used, as well as receive logs from the device, analyse usage with checkpoints or loading view controllers and much much more. For more information, please follow the integration manual.

Back to top

How do I fix "App could not be installed at this time"?

"App could not be installed at this time" is a generic error when iOS cannot install the download app on the device. The reasons vary, and may be one of these:

  • The device's UDID is not included in the provisioning profile.
  • Not enough disk space for installation on device.
  • The device's architecture (eg. ARMv7) is not supported by the app.
  • The device's operating system version (eg. 7.0) is too low for the app.
  • The device's platform mismatches (eg. iPad app on an iPhone.)
  • Enterprise team is not included in prefix in embedded.mobileprovision file.
  • App is not signed with an Ad Hoc or Enterprise (in-house) certificate.

TestFairy has a Troubleshooting tool to guide the tester or developer through the debugging of such problems. Simply visit using Safari on your iOS device and follow the instructions.

If all this fails, please contact support by click on the Support button in your account page. We do our best to help debug causes and improve our one-of-a-kind Troubleshooting tool.

Back to top

Why do I see sessions by "User-1"?

When using the TestFairy iOS SDK, all sessions are anonymous. Without access to device information, TestFairy cannot tell what's the email address of the tester.

It does know how to associate sessions by the same testers to the same "User-1". Using a token that is stored when the first session is created, TestFairy can identify sessions by the same tester.

Furthermore, TestFairy supports correlationId. This identifier is any string that makes sense to the developer (you). It can be an email address of the tester, their Facebook id number, or an identifier in your own database. Using the SDK, simply call [TestFairy setCorrelationId:@"my-id-00000000"];, and this identifier will show in all reports, instead of the generic User-1 values. Use this correlationId as you see fit.

Back to top

Why does an app icon disappear right after download?

When downloading an iOS app, the iOS operating system will show a progress during downloading and installation. This progress looks like an analog clock, an empty circle becoming full.

After installation completes, the system then checks if the app is alread installed on the device. If it does, it replaces the old app with the version recently downloaded. You may have this app icon in a different screen tab, or maybe inside a folder.

Tip: Pull down the view to reveal the Spotlight search dialog. You can type the name of the app, and it will locate it on your device, regardless of screen tab or folder.

Back to top

Why does linking fail with ld: symbol(s) not found for architecture arm64?

On various Xcode project configurations, you might receive the following error when linking with TestFairy:

"_OBJC_CLASS_$_TestFairy", referenced from:
ld: symbol(s) not found for architecture arm64

For those projects, please add libTestFairy.a as a framework in your Build Settings.

Back to top

What's the error "You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE)"?

Xcode7 introduced a new feature (virtual architecture) called Bitcode. This is a short for LLVM Bitcode, which is a virtual machine architecture Xcode uses as an intermediate platform for compilation. Instead of compiling apps to armv7, armv7s, arm64 - Xcode can now create a single architecture and the AppStore will generate optimized binaries for mobiles. This will greatly reduce the IPA filesize as an iPhone6+ user won't be downloading the binaries needed for iPhone4, etc.

To compile an app with bitcode, it is required that all libraries and frameworks used will have bitcode enabled as well. Alternatively, you can disable ENABLE_BITCODE in your Xcode project. As of October 2015, it is not required by Apple for app submittion, but might be required in the future.

TestFairy iOS SDK version 1.5.0 has bitcode flag enabled, which solves this problem. Simply upgrading the SDK will resolve this error in compilation.

Back to top

Push notifications work when installed from Xcode, but not with TestFairy.


TestFairy's SDK does not make any changes to your executable or IPA. A very common problem we have been seeing, is that developers make a mistake and develop using sandbox, and release using a production app's environment. Please make sure your configuration is the same for production and adhoc/in-house releases.

Back to top

What is the difference between in-house and enterprise certificates?

These two are the same. When exporting an IPA from within Xcode, you export for Enterprise Development, but in some cases on iTunes Connect, this is refered as In-House.

Back to top