Getting Started

In this tutorial you will create a project, add our SDK to your app, and upload it to TPA. We assume that you already have an app. You will need permissions to create new projects. In case somebody else already created a project for you, you will either need to be the project owner or you will need administrator as well as developer role to the project. 

Create Your First Project

To create a new project, log in to your account and click on the Create new project button.

Fill in the required information. While adding tracks, you will notice that there is an option to make a track installable. Builds belonging to this track can be made available for installation, through TPA's mobile web site, depending on whether the checkbox is checked or not. You may choose to make a track non-installable if for example the track is destined for an app store, in which case it might not make sense for it to be installable. In particular iOS and tvOS builds signed with a distribution certificate cannot be installed through TPA's mobile web site, and should be put in a non-installable track.

Apps, Tracks, and Builds

Most projects will only contain a single app, but you may add more, e.g. if you have separate lite and pro versions of your app. Whether to have one project with several apps or several projects with one app, mostly depends on your organisation, since access is granted per project. If the lite and pro versions are developed and tested by the same team, it makes sense to have a single project, but if separate teams are responsible for the two apps, you may want to use two projects.

It is good practice to separate the builds of your apps that have been released to the public, and the builds that have been released for internal testing. In TPA we use tracks for this purpose: a build exists in exactly one track. We use the app identifier (the bundle identifier for iOS, iPadOS, and tvOS apps, and the package name for Android apps) to associate an uploaded build with a track. A suggested setup is to have an 'App Store' track as well as a 'Test' track.

When we need to refer to a combination of an app and track, we will use the AppTrack notation.

Click Save, and you will be taken directly to your newly created project.

Add an App to Your Project

Hit Get Me Started and we will guide you through integrating our SDK in to your app, and uploading a build to TPA. During the process we will add an app as well as a track to the project, if required. If you already added an app and/or a track to your project, you can select them from the drop downs.

Follow the instructions to add our SDK to your app.

Uploading Your Build

After adding our SDK to your app, make a new build, and upload it to TPA.

Symbols File

In order to provide you with the most information in case your app crashes, we ask you to upload a symbol file. Depending on the platform this may be a zipped archive of all dSYM packages of your iOS/iPadOS/tvOS app, or a ProGuard mapping file in case of an Android app.

We will validate the uploaded build, extract the app identifier and create the appropriate app and/or track, as well as map the app identifier to the AppTrack. Whenever you need to upload a new build in the future, you can just select Upload New Build from the Manage Project menu or use our REST API.

Install the App on Your Device

You are now set up to install the app on your mobile device. Log in to your account on the device, and you will be greeted with a list of builds you can install. Hit the install button at the right-hand side, and depending on the device you may be required to confirm the installation.

Installation Issues

TPA does not re-sign your app, so you must make sure that you have signed it with a valid certificate, that allows it to be installed on the device.

You can read more about installing apps in these support documents.

Hit the  Live Analytics button in your desktop browser, and open the app on your device. In a few seconds you should see that there is one active device. If you exit the app, it will drop to zero shortly.

If you enabled feedback (the default if you followed our instructions earlier), open the app and shake the device, A screenshot will be taken that you can annotate with a note as well as by drawing on the screen. Hit the Done button and the feedback will be uploaded to TPA. Navigate back to the project page on your desktop browser, and hit the Feedback button to see it. This is a great way for your testers to provide feedback.

Gather Comments from Your Testers

Speaking of testers, it is time to ask them to install and give feedback on your app. The easiest way to do so is to send an installation link to them. Hit the Share Direct Link button and enter the email addresses or phone numbers of your testers.

Hit the Share link button and they will receive a link to install the app shortly. If you enabled update notifications (the default if you followed our instructions earlier), your testers will be notified when you upload a new build in the future.

Invite Colleagues to the Project

It is easy to add additional members to your project, e.g. fellow developers or testers. In the Manage Project menu you will find Invite Users. Hit it, and enter the email address of a colleague. Add appropriate permissions, and hit Invite User.

Your colleague will receive a confirmation email shortly.


When you create a project, it can only be accessed by you, the project owner. As the project owner you have full access. You can add other users, and give them more restricted access to the project itself, and the tracks within.

On the project level, there are three roles: developer, analyst, and administrator. A user may have zero or more of these roles. Users without a project role are still able to install builds in the tracks they can access.

On the track level there are three permissions: no access, only published, published and unpublished. All users associated with a project can access the project, but only the tracks for which they have been granted access.

Getting the most out of The Perfect App

Your app is now hooked in to TPA, and you are ready to dig in to all the other features of The Perfect App.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us