mobile-testing.md

Mobile Testing

To test a mobile build, the tester requires access to specific services and must know how to locate the relevant build. This applies to all teams.

This article aims to equip testers with the knowledge necessary to test any mobile build.

{% tabs %} {% tab title="iOS" %}

iOS

For iOS testing, the tester will need an Apple ID, as well as an invite to TestFlight, which can be downloaded directly from the App Store. Organize with a Mobile Developer to get the proper invitations.

{% hint style="warning" %} Make sure to create the Apple ID using your Rocket.Chat email account. {% endhint %}

{% hint style="info" %} You may also want to download the App Store Connect app to monitor the app's reviews on Apple, but that's not a requirement. {% endhint %}

After downloading the apps, and being properly invited, you should be able to see the list of apps you have access to in your TestFlight app

It should look similar to this:

Normally, both the Experimental App and the Official App should be tested from here. To determine which version to test, refer to the CircleCI Workflow related to the task in question.

Confirming the tester has the right build

Below, there's a common CI workflow that has both iOS and Android Experimental builds ready for testing.

An example of a CircleCI Workflow

To find and confirm the iOS experimental build that the tester needs to install on their device, click on ios-build-experimental.

On this new screen, you may see the number of the build on the breadcrumbs on the top of the page like so:

An arrow points to the number 25575

{% hint style="info" %} Pro Tip: You may see the number through the url preview that appears at the bottom of your browser while hovering the ios-build-experimental button.
{% endhint %}

The tester may use this number to find the specific build on TestFlight by tapping on the app and going to Previous Builds, If necessary.

Once Installed, the tester may confirm the version number in a couple of places inside the app, before and after logging in.

{% endtab %}

{% tab title="Android" %}

Android

For Android, testing is done through Google's Internal App Sharing.

The development team uploads the app bundle or APK through that service, and the tester downloads it using the specific link generated during the CircleCI workflow.

The tester must be added as an "Authorized Tester". Organize with a mobile developer to get the proper authorization.

{% hint style="warning" %} Remember to use your Rocket.Chat's email through the authorization process. {% endhint %}

Once the tester is properly invited, they will be able to access the link provided by the DEV team to download the app bundle or APK.

Without authorization, Google won't allow them to download the app even If they have the link.

Getting the link and downloading the app

The simplest way to obtain the link to the uploaded AAB to internal App Sharing is through the CircleCI workflow.

Below, there's a common CI workflow that has both iOS and Android Experimental builds ready for testing.

An example of a CircleCI Workflow

To find and confirm the Android experimental build that the tester needs to install on their device, click on android-internal-app-sharing-experimental.

Once redirected, scroll down to the Fastlane Play Store Upload section and copy the link as shown below.

This link should be opened through the mobile device.

{% hint style="info" %} To make it easier and faster, a QR Code generator could be used. Like this one. {% endhint %}

Confirming the tester has the right build

On the same CircleCI workflow, click on android-build-experiemental and check the number at the top of the page.

Once Installed, the tester may confirm the version number in a couple of places inside the app, before and after logging in.

{% endtab %} {% endtabs %}