How to create Mobile Tests
Introduction
You can create Mobile Tests for Android and iOS applications, both native and hybrid.
There are 2 ways to create Mobile Tests:
- With the Endtest Mobile Recorder.
- Manually adding test suites, test cases and steps.
1. With the Endtest Mobile Recorder.
The Endtest Mobile Recorder
allows you to record Mobile Tests
directly in your browser.
In order to record Mobile Tests, you must connect to an external grid which offers real mobile devices.
There are 3 options available:
- BrowserStack
- Sauce Labs
- Kobiton
1. How to use the Mobile Recorder with BrowserStack
You need an account on BrowserStack that has access to App Automate
.
If you do not have an account on BrowserStack, you can sign up for a free trial.
That will give you 100 minutes of App Automate
.
Even if your tests will be executed on BrowserStack, you will get the results and logs in your Endtest account.
Steps
Connect your Endtest account with your BrowserStack account:
- Go to your BrowserStack account.
- If you don't have a BrowserStack account, you can just sign up for a Free Trial.
- Go to the
Products
section from BrowserStack and click onApp Automate
. - Click on the
Show
button from theUsername and Access Keys
section from the left side of the page. - Go to the
Integrations
tab from the Settings page from Endtest. - Add the
Username
andAccess Key
in the BrowserStack App Automate modal. - Click on the
Save
button.
Your Endtest account and your BrowserStack account are now connected.
You won't have to repeat steps 1-7 unless you move to another BrowserStack account.
- Upload your APK or IPA file in the Drive section.
- Copy the
File Download URL
for your uploaded app.
Your app is now stored on the Endtest Drive.
Steps 8-9 will be repeated only when you want to test a new version of your app.
- Go to the Mobile Tests section from Endtest.
- Click on the
Record Mobile Test
button and selectBrowserStack
from theGrid
dropdown. - Select the desired configuration.
- Paste the
File Download URL
in theAPK Download URL
/IPA Download URL
input. - Click on the
Start Recording
button. - Once your app has loaded in the
Mobile Recorder
, you will be able to record steps and execute them. - After you're done recording, you can save the steps into a
Mobile Test
.
You can also upload your APK or IPA file in the Drive by using our Endtest API.
More details are available in the Endtest API chapter.
You can also upload your APK or IPA file on a server or an AWS S3 bucket.
The URL must have the file name and the file extension at the end and the file (app) must be downloaded automatically, without any prompts or confirmations.
Take our APK Download URL for the WIkipedia Android App as an example:
https://endtest-files.s3.us-west-2.amazonaws.com/WikipediaSample.apk
If you want to start the Mobile Recorder from a certain point, you can add a
Miscellaneous -> Start Mobile Recorder
step in your Mobile Test.
2. How to use the Mobile Recorder with Sauce Labs
You need an account on Sauce Labs that has access to the Real Device Cloud component.
If you do not have an account on Sauce Labs, you can sign up for a free trial.
That will give you access to a list of devices.
Even if your tests will be executed on Sauce Labs, you will get the results and logs in your Endtest account.
Steps
Connect your Endtest account with your Sauce Labs account:
- Go to your Sauce Labs account.
- If you don't have a Sauce Labs account, you can just sign up for a Free Trial.
- Go to the User Settings section from Sauce Labs.
- Copy the
Username
andAccess Key
. - Go to the
Integrations
tab from the Settings page from Endtest. - Add the
Username
andAccess Key
in the Sauce Labs modal. - Click on the
Save
button.
Your Endtest account and your Sauce Labs account are now connected.
You won't have to repeat steps 1-7 unless you move to another Sauce Labs account.
- Upload your APK or IPA file in the Drive section.
- Copy the
File Download URL
for your uploaded app.
Your app is now stored on the Endtest Drive.
Steps 8-9 will be repeated only when you want to test a new version of your app.
- Go to the Mobile Tests section from Endtest.
- Click on the
Record Mobile Test
button and selectSauce Labs
from theGrid
dropdown. - Select the desired configuration.
- Paste the
File Download URL
in theAPK Download URL
/IPA Download URL
input. - Click on the
Start Recording
button. - Once your app has loaded in the
Mobile Recorder
, you will be able to record steps and execute them. - After you're done recording, you can save the steps into a
Mobile Test
.
You can also upload your APK or IPA file in the Drive by using our Endtest API.
More details are available in the Endtest API chapter.
You can also upload your APK or IPA file on a serve or an AWS S3 bucket.
The URL must have the file name and the file extension at the end and the file (app) must be downloaded automatically, without any prompts or confirmations.
Take our APK Download URL for the WIkipedia Android App as an example:
https://endtest-files.s3.us-west-2.amazonaws.com/WikipediaSample.apk
If you want to start the Mobile Recorder from a certain point, you can add a
Miscellaneous -> Start Mobile Recorder
step in your Mobile Test.
3. How to use the Mobile Recorder with Kobiton
You need an account on Kobiton that has access to mobile devices.
If you do not have an account on Kobiton, you can sign up for a free trial.
Even if your tests will be executed on Kobiton, you will get the results and logs in your Endtest account.
Steps
Connect your Endtest account with your Kobiton account:
- Go to your Kobiton account.
- If you don't have a Kobiton account, you can just sign up for a Free Trial.
- Go to the
Profile
section from Kobiton and get yourUsername
. - Go to the
Settings
section from Kobiton and get yourAPI Key
. - Go to the Settings page from Endtest.
- Go to the
Integrations
tab. - Add the
Username
andAPI Key
from Kobiton. - Click on the
Save
button.
Your Endtest account and your Kobiton account are now connected.
You won't have to repeat steps 1-8 unless you want to use a different Kobiton Access Key.
- Upload your APK or IPA file in the Drive section.
- Copy the
File Download URL
for your uploaded app.
Your app is now stored on the Endtest Drive.
Steps 9-10 will be repeated only when you want to test a new version of your app.
- Go to the Mobile Tests section from Endtest.
- Click on the
Record Mobile Test
button and selectKobiton
from theGrid
dropdown. - Select the desired configuration.
- Paste the
File Download URL
in theAPK Download URL
/IPA Download URL
input. - Click on the
Start Recording
button. - Once your app has loaded in the
Mobile Recorder
, you will be able to record steps and execute them. - After you're done recording, you can save the steps into a
Mobile Test
.
You can also upload your APK or IPA file in the Drive by using our Endtest API.
More details are available in the Endtest API chapter.
You can also upload your APK or IPA file on a server or an AWS S3 bucket.
The URL must have the file name and the file extension at the end and the file (app) must be downloaded automatically, without any prompts or confirmations.
Take our APK Download URL for the WIkipedia Android App as an example:
https://endtest-files.s3.us-west-2.amazonaws.com/WikipediaSample.apk
If you want to start the Mobile Recorder from a certain point, you can add a
Miscellaneous -> Start Mobile Recorder
step in your Mobile Test.
4. Manually adding test suites, test cases and steps.
Add a test suite
- Go to the Mobile Tests section.
- Click on the
Add Test Suite
button. - Enter the name for the test suite.
- Click on the
Save Test Suite
button.
Add a test case
Test cases can be added only after you have created the test suite.
- Click on the
Add Test Case
button. - Enter the name for the test case.
Add steps inside the test case
A test case is made up of steps.
To add a new step, just click on the Add Step
button.
Every step is defined by its Action.
Some actions are tied to the entire page (actions such as Lock
, Hide Keyboard
, Take Screenshot
, etc).
While other actions must be tied to a specific element (actions such as Single Tap
, Flick
, Write Text
, etc).
To tie an Action to a specific Element, you must use a Locator.
A Locator is basically an attribute which identifies the element (Accessibility ID, Class Name, XPath, Text Inside, etc).
For Touch actions, you can also use Coordinates as a Locator.
The easiest way to find a Locator is to use the Get Element Inspector
option from the Miscellaneous
action.
You can read more about that in the Finding elements in Mobile Applications chapter.