MY ACCOUNT / MY ORGANIZATON
Troubleshooting
BEST PRACTICES

Create a Distribution Profile and Sharing with Testers

In order to share your builds with testers, you can create distribution profiles and assign testing groups to the distribution profiles.

A distribution profile corresponds to the multiple versions of the same application for iOS and Android.

Create a distribution profile

Select the Distribution Profiles module from the left and click on the Add New button. Give a name to your distribution profile.

For best practice, we recommend using one single distribution profile for both iOS and Android versions of the same application.

Once you create the distribution profile, you can now customize its settings. Click on the settings icon (three dots) on the profile card and select Settings.

Using authentication for distribution

You can use a preferred authentication method for sharing your your application.

  • None: No authentication, anyone with the link can download binary files

  • Individual Enrollment: Each tester will enroll their own user account to log in and download the binary files

  • Static Username and Password: One single username and password for all testers

Auto send your build to testers

Auto send feature lets your applications to be distributed to specific testing groups as soon as a successful build is complete.

To enable the auto send feature, you need to create testing groups and add testers into these groups.

Go to Distribute module from the left menu and click on the settings icon (three dots) of the distribution profile you want to enable auto send and select Settings from the dropdown menu.

In the profile settings, select Auto Send tab. Here, you can see the testing groups you have created earlier. Simply enable each testing group you want to have your application sent automatically after a successful build.

Your application will be sent to the related testing groups as soon as your build is complete.

Manually upload your version

If you have pre-built iOS or Android applications and want to distribute or preview for testing, you can simply click on the + button on top of the left column to upload your files into Appcircle. After the file is uploaded, it is checked for errors and parsed for metadata. If there is an error, it is displayed on the upload area.

Manually uploaded binaries will not be auto-distributed since they are not the part of the regular build & distribute flow.

Once the upload is complete, you will see the new version added to the top of the list with parsed metadata. You can now share this version with the testers or preview it on a virtual device in your browser.

New version from build module

With a successful build, a new version of your application will be added to your distribution profile.

Simply go to Build Module > Build Configuration > Distribution and select a distribution profile you want your build to be sent.

Only signed builds will be distributed. Unsigned builds cannot be distributed.

Android applications with multiple flavor

If your Android application has multiple product flavors, Appcircle will create a build for each flavor of your application and let you distribute them at once. A common usage to multi-flavor applications can be free and paid versions of the same application.

When you build and distribute an application with multiple flavors, and .apk file will be created for each flavor. On our testing portal, your testers will be able to download each .apk file separately and test it on their devices.

If your Git commit has any messages, they will be included in the distribution in Message To Testers area.

Share your application to test groups manually

When you have your build ready or uploaded your binary file to Appcircle, you can manually send the file to testers to let them download, install on their devices and run the application for testing purposes.

Click on the Share with Testers button and select the testing groups you created previously that needs to receive this version of your application. Alternatively, you can enter email addresses of the testers here to send them the application regardless of the testing groups.

You can also add a message to testers including testing instructions and release notes.

Tracking your distribution

After sending your application to testing groups, you can track the actions of testers:

  • Pending - Means your tester didn't click on the link they received yet

  • Clicked, No Login - Means your tester clicked on the link they received but has not logged in to the system yet (only for authenticated distributions)

  • Login, No Download - Means your tester has logged in (for authenticated distributions) and at the download screen but has not downloaded the binary file yet

  • Downloaded - Means your tester clicked and downloaded the binary file

‚Äč