Testing a Mobile App

This tutorial will show you how to upload and install an app on a mobile device using webmate. After following all the upcoming steps, you will be ready to test the app on a real device.

Upload an App via the webmate Web App

Navigate to the devices view of your project and click on the Apps button in the upper right area.

If this is the first time uploading an app to this webmate project, you will only see a button to upload your first app. Go ahead and click on Add new App.

If the project already has Apps uploaded to it, you will now see an overview of all available apps in the project. Here you can click on Add Package.

Now choose if you want to upload the file from your computer or to connect to an MS AppCenter Repository.

After you have uploaded the app, you can see it in the list of installed packages on the left. webmate will automatically generate a so called instrumented version of your app package. This modified package allows webmate to simulate certain functions like GPS, camera, biometrics, and more. You can delete the package (1), upload a new version (2) or download the original and the instrumented version (3).

You now successfully added your app to a webmate project, and it is ready to be used for manual testing.

Choose a Mobile Device

On the Project Dashboard, click on the Device Slot Overview to view a detailed list of the devices and device slots in the project:

From the list of device slots in the project, find one with an icon that depicts mobile devices (as indicated) (1) and click Deploy device on that slot (2):

Select a device from the list, enter a name to be shown in the project (optional), and click DEPLOY to use the device:

Once your device is ready, go ahead and click on the hamburger button beside it. In the dropdown menu, click on Install app.

If your app has an additional instrumented package, you can choose whether you want to install the original (1) or the instrumented package (2). This is only relevant if you need simulation of camera input or biometric authentication within the app, as explained here. If you do not need to use these features, install the original package.

Click Install on device on the package. After the installation is finished, click the Access button to start remote controlling the device.

You will now find your installed package on the device.

You can now control the device remotely through your computer’s keyboard and pointing device. You can also rotate the device (1) and, if you installed the instrumented package, simulate sensor input (2):

Create a Test Run

Start your app on the device. Select Test (1) from the menu to display the Test Management widget and select Start Test Run (2):

Perform your test.

Perform the Test on the Mobile Device

Click on the plus symbol in the Test Management widget (1) and take a screenshot of your test (2):

Click on the plus symbol in the Test Management widget (1) and use Create Issue (2) to write down any test results:

Click Finish in the Test Management widget to end the test:

Evaluate Test Results

Click Open last run in the Test Management widget:

Now you can review all the test artefacts or add tags (1) and comments (2):

Click on the caption to enter a meaningful name for your test, and click the floppy disk icon to save the name:

Clean Up the Device

The final step is to release the devices and the slots after the tests have been completed.

On the sidebar, click on DEVICES to return to the list of the devices and device slots in the project:

In the device list, click Delete for the device and confirm the deletion:

This will unblock the slot, reset the device to its initial state, and make the device available to use again.