Step 2: install the testable Android app

The Android app can only be tested if it is made testable. The app is made testable by installing it through the Jamo Cloud. For doing so, upload the apk file of the app to the Jamo Automator cloud.

Select the Apps tab in the tab bar of Jamo Automator and click on the button ‘upload application’.

Jamo screenshot upload application

A form opens to upload a new app.

step2-image2

Specify a general description of the app together with a description of the version. The tablet checkbox needs to be checked if your app installation file is installable on tablets only. The app version is a free text edit box. The version string might be the same as the version string given by the developer or it might be a total different string if the versioning applied by the developers is not matching the view or needs of the QA engineer. Click on the ‘Select a file’ button and select the apk file of the app under test. Once all this information is filled in, click on the ‘Done’ button in the upper right corner of the form.

step2-image-3

While the upload of the apk file takes place, a dialog box with a busy activity indicator appears.

step2 image 4

Once the upload is done, the dialog box disappears and the app is added to the list of apps to test.

Now download from the Jamo Automator cloud the testable app and install it on the device/emulator by executing following steps:

step2-image-5

Open the details of the just recreated app by clicking on its name. The app detail form opens. In the upper part for the form, the information regarding the app is listed. You can change this information by clicking on the ‘Edit’ button in the upper right corner of the form. In the lower part, the different releases of the app are listed. The tool Jamo Automator supports the management of the different releases of an app and the related test cases. Since this app is a newly uploaded app, there is just one release listed.

Click on the name of the release do open the detail window of the release.

step2-image-6

One release can contain different versions. For example versions that fix specific bugs. Since only one .apk file is uploaded, there is only one version available. The versions are listed in the lower part of the form displaying the details of the release of an app. The upper part contains the descriptive information of the release. This information can be edited after clicking the ‘Edit’ button situated in the upper right corner of the form.

step2-image-7

Open the detail form of the version by clicking on the version string. The detail form of an app version opens.

step2-image-8

Install this version of the app on the Android device/emulator by clicking on the ‘New app installation’ button. A form with the list of active devices opens. If your device is not listed, check if the agent is still running and logged into the Jamo Automator cloud. If not, open the agent and login, then refresh the list by clicking on the ‘Refresh’ button in the upper right corner of the form.

step-2-image-9

Install the version of the app by clicking on the ‘install’ icon in the right most column. A dialog box opens to remind you that you might need to confirm the installation of the app on the device.

On the Android device you will get a pop-up window to confirm the installation of the app. The pop-up window looks like for Android 5 and higher:

step2 image 10

The tool will install two apps. The first is your app, the second is the Jamo Automator app launcher. The app launcher is named using your app name extended with the ‘Automator’ word as displayed in the above screenshot. Confirm the installation of both apps by clicking on the INSTALL button of both pop-up windows.

It might that the Android device is configured to block installations from unknown sources. If so, a dialog box will display a message. The dialog box contains a button to the settings of the device. Click on this button and change the settings to allow the installation of an app from unknown sources. The below screenshots are for Android 5 and higher. On Android 4.x no setting has to be changed but a dialog box asks to confirm the download form an unknown source.

step2 image 11

Now the testable app is installed. You get two icons in the list of installed apps. One icon is the icon of your app and the other icon is the launcher app. To test your Android app, you have to start the launcher app.

step2 image 12

After starting the launcher app, your app under test will open. You can easily check that this is the app under test. For the Android app under test, a ‘Jamo Automator’ button is added to the screens of the app. This button is located in the upper left corner of the app’s window.

step2 image 13