If you don’t have an account yet, please sign up. It's easy, and free!
If you have a TestFairy account, please log in.

Uploading Your Application

Once your account is created and verified, you are ready to upload your app.

Uploading is just as simple as it sounds! Just click on the Upload button on the top-right side of the upper menu, and follow the on-screen instructions.

 alt upload

We recommend using our Upload API to enable our Jenkins plugin, Gradle plugin, or Command line uploader.

The code of our command line uploader, Jenkins and Gradle plugins is open source, so you can feel free to change and improve on it.

This guide will describe the manual upload process.

Selecting Your Project Settings

You can define your testing settings right on the upload process.

Selecting Your Project Settings

Following are the parameters you can set up directly on the Upload process, when you reach the "Build Settings" section. Simply click on the "Advanced Settings" link under the comments, to check or uncheck the parameters you are interested in for this testing round.

  • CPU
  • Memory
  • Network
  • Application logcat
  • Phone signal (Android only)
  • Battery (Android only)
  • WIFI (Android only)
  • Network HTTP request (iOS only)

In addition, you can set the following parameters:

-- Auto-Update - When auto update is enabled, users using previous versions of this app will get a notification about the new version next time they open up the app. The new version will be downloaded automatically, so the user doesn't have to actively download it. Please note that in this case no email notification will be sent to the testers.

-- In-app reporting - Check this box to enable/disable the "shake to report" feature in your app. When enabled, users can simply shake their device to send out a feedback report, along with a video recording, screenshots, logs and metrics of their testing session.

-- Custom Comments - Use this section to add release notes, describe the updated/changes and write about anything else you would like your testers to be aware of.

 alt testfairy-upload

Additional settings can be configured from the Project Settings page.

Updating an app

If you wish to update an app, all you have to do is simply upload it again, the same app with the same version. The new file will override the old file.

Uploading a new version

If you wish to upload a new version of the same app, all you have to do is upload the new version the exact same way you've uploaded the old version. Our service will identify that both apps have the same package name (budle id) and group them together in the same project.

What you should read next: How To Invite Testers.