How to invite beta testers

HockeyApp provides various mechanism to invite testers and distribute your apps. Depending on the visibility of your app's download page, testers are or are not required to have an account, can be invited via email, or recruited via a dedicated recruitment page.

No Account

If you already have a group of testers, all you need to do is to share the link to the public download page. You find it in the info section of your app's page. Your testers will be able to download the latest version and install it directly onto their device from that web page.

Note that if you use ad-hoc provisioning on iOS or macOS, the testers' device UDIDs need to be included in the app's provisioning profile.

Advantages

  • Testers do not need an account.
  • Testers get an alert when they launch the app and a new version is available (requires HockeySDK on iOS and Android, Sparkle on macOS).

Disadvantages

  • If a tester has a new device, he needs to send the UDID via email to you.
  • Testers do not get email notifications about new versions.

Invite New Testers

You can add testers to your app by inviting them via email. To do this, select your app on the dashboard, then click on "Invite User". Select a role, fill out the email field and confirm with "Save".

If you want to invite a set of email addresses in one step, choose the "Import" button on the top of the users page. Put all the email addresses into a file on your desktop, one address per line. Then upload this file using the "Import File" function on the page.

iOS only

If your iOS app already has a provisioning profile and HockeyApp finds existing users for the UDID in this profile, it will allow you to invite these users directly from the import page.

Each invited user will get an email invitation. He will have the option to create a user account or use another existing user account or connect with Facebook. The tester can also accept the invite directly on his device, HockeyApp then guides him through the steps to add the device's UDID to his account without having it the enter manually.

Once the user accepted the invitation, the pending badge on the user icon will be removed and you can select the user to get the UDID for adding it to the iOS provisioning profile. Alternatively you can choose the "Export" button on the Users page to download a file with all UDIDs not being part of the current provisioning profile. This file can then be imported into Apple's Provisioning Portal.

Advantages

  • Testers get email notifications about new versions.
  • Testers get an alert when they launch the app and a new version is available (requires HockeySDK on iOS and Android, Sparkle on macOS).
  • You can set the visibility of the download page to private.
  • You get email notifications if testers add new devices.
  • You can import and export all email addresses of your testers.
  • You can export all or all new UDIDs of your testers.

Disadvantages

  • Testers need a to create a free account for HockeyApp.
  • You need to invite your testers.

Recruiting New Testers

If you are looking for new testers, HockeyApp provides the recruitment feature. To use this, select your app on the dashboard, then click on the tab "User", then on "Applicants". Fill out the description text with some information about the app or your expectations for new testers. Then set "Active" to "Yes" and hit "Save". The following page will provide you a unique link that you can share with potential testers, e.g. on your website, via Facebook or Twitter.

Potential testers can apply to become a testers of your app by following the link. They need to create a new account or use an existing account for HockeyApp. All applications will be listed on your recruitment page and you can either accept or deny the requests.

Advantages

  • New testers can apply for your app.
  • You get email notifications if new testers apply.

Disadvantages

  • Potential testers need a to create a free account for HockeyApp.