This walkthrough shows you how to use App Functional to test a native Android or iOS app or mobile website. You use the App Functional console to create a project, upload a build in the form of an .apk or an .ipa or choose a default one, select devices, run a suite of standard tests, and then view the results.
Sign in to the Console
You can use the App Functional console to create a project, upload a build, select devices, run test suites, check results. You can learn about projects, builds, devices, test suites, results later in this walkthrough.
Step 01: Sign in to App Functional Console at http://demo-appfunctional.mozark.ai/
You will see a page as shown in Figure 01. Provide your user id, password and click on login to sign in to App Functional Console successfully.
Figure 01: Sign in to App Functional Console
Step 02: Signed in App Functional Console
After you successfully sign in to App Functional Console, you will see the page given in Figure 02.
Figure 02: Signed in App Functional Console
Once you are signed in to the App Functional Console, you can create or select existing projects, upload or select default or existing builds, upload or select scripts, select test suites, choose devices, run or schedule tests, check status of test runs, view results, configure your App Functional Console.
To test a mobile app or a mobile website, you must create or select an app project.
Create App Project
If you are using App Functional for the first time, you will have to create a project by clicking on Create New App Project in Figure 03 or by going to Configure in Figure 04.
Figure 03: Click on Create New App Project to Go to Configure
- In the Create New App Project, enter a name for your project (for example, MyDemoProject) and description in Figure 04. Both Name App Project and Description are mandatory fields.
- Click Create App Project to create a project with the given project name and description in Figure 04.
Figure 04: Create New App Project
- Select App Project and you will see your newly created app project in the dropdown as shown in Figure 05.
Select App Project
If there are projects associated with your account, then select App Project as shown in Figure 05.
Figure 05: Select App Project
Now that you have an app project, the next step is to upload a new build or select a default build or an existing build.
Upload New Build
If you are using App Functional for the first time, you will have to upload a build by clicking on Upload New Build or by going to Configure in Figure 06.
Figure 06: Upload New Build or Configure
- In Upload New Build, select an app project from the dropdown (for example, MyDemoProject) and attachment(.apk or .ipa) from your system in Figure 07. Both Select App Project and Attachment are mandatory fields.
- Click Upload Build to upload new build for an app project in Figure 07.
Figure 07: Upload Build
Select a Build – Default
If the builds are already available in the test devices, then select a Build.
The pre-requisite to select a default build as shown in Figure 08 is to ensure that the builds are available in the test devices. Otherwise, it will result into an error.
Figure 08: Select Build – Default
Select a Build
If there are builds associated with your projects, then select Build as shown in Figure 09.
Figure 09: Select Build
Add a device on Apple developer portal In order to ensure that .ipa works on the iOS devices of your choice while testing on App Functional. The steps to add the same are as follows:
- Login into apple developer account(https://developer.apple.com)
- Select Certificates, Identifiers & Profiles option
- On Left side click on “Devices” menu
- Click on Blue “add” button on top
- Choose platform (iOS,tvOS,watchOS)
- Enter device name like “iPhone 12”
- Enter UDID of that device(Contact MOZARK representative to get the UDID of the devices for your instance)
- Then click on “Continue” Button
- Now your device has been added successfully on apple developer account
- Multiple devices can be added in the below format:
|Device ID||Device Name||Device Platform|
Now that you have select a build, the next step is to upload a script or select an existing script that can automate the user journey you want to test your mobile app or mobile website for.
Upload New Script
If you are using App Functional for the first time, you will have to upload a script by clicking on Upload New Script or by going to Configure in Figure 10.
Figure 06: Upload New Script or Configure
- In Upload Journey Script, enter a name for journey script, description, features tested, select framework, language, OS, project from the dropdown (for example, MyDemoProject) and attachment from your system in Figure 11. All the fields except selecting an OS are mandatory fields.
- Click Upload Journey Script to upload new script for an app project in Figure 11.
Figure 11: Upload Journey Script
Select a Script
If there are scripts associated with your projects, then select a script as shown in Figure 12.
Figure 12: Select Script
If there are test suites associated with your projects, then select a test suite or ALL test suites for running them on test devices as shown in Figure 13. TestSuites are not available for Appium with Java TestNG scripts.
Figure 13: Select TestSuite
Enter Test Description
If you want to provide a name for this test run, then write a test description as shown in Figure 14. It is not a mandatory field.
Figure 14: Enter Test Description
Now that you have selected project, build, script, test suite, test description, the next step is to choose devices to test your mobile app or mobile website.
Click on Continue as given in Figure 15.
Figure 15: Click on Continue
By clicking on Continue, you will see Select Devices page as shown in Figure 16.
You can select devices in two ways –
- Select device group
- Select devices
Figure 16: Select Devices
Select from existing device group
Select a device group of choice by clicking on the dropdown as shown in Figure 17.
Figure 17: Select Device Group
You can also select devices by viewing each device in either List or Grid view, by going to different pages, by putting filters.
View – List
- Click on the list icon to enable the list view as given in figure 18.
Figure 18: Select Devices in List View
- Select by clicking on the check box in the list view as given in figure 18.
View – Grid
- Click on the grid icon to enable the Grid view as given in Figure 19.
- By hovering over the card, you will be able to see the device details as given in Figure 20
- Select by clicking on the check box in the grid view as given in Figure 21
Figure 19: Select Devices in Grid View
Figure 20: Hover over the device card
Figure 21: Select Devices in Grid View
You can browse and select devices by going to different pages by clicking the arrows at the bottom of the list as given in Figure
Figure 22: Pagination
Figure 23: Pagination
You can select devices further based on filters such as OS, Make, Model, Network, Resolution, Location as shown in Figure 24.
Figure 24: Filter By
Remove a Selected Device
By clicking on X, one can remove a selected device before beginning any test run as given in Figure 25.
Figure 25: Remove a selected device
After selecting a project, build, script, devices, you can now run tests. There are two options to run tests. One is Start Now, where you can execute the test now and other one is Schedule Test where you can run continuous tests as shown in Figure 26.
Figure 26: Run Tests – Start Now, Schedule Test
When ‘Start Now’ is selected, then the test starts instantaneously.
Figure 27: Start Now
When ‘Schedule Test’ is selected, then the following fields are required to be populated as shown in Figure 28:
- Start Date and Time
- End Date and Time
- Time interval (in minutes)
Put sufficient interval between test runs based on test execution time
Figure 28: Schedule Test
Next Section: Reviewing Test Results