> For the complete documentation index, see [llms.txt](https://docs.testwheel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testwheel.com/mobile-test.md).

# Mobile Test

This page describes about the Mobile Test Module in TestWheel application.

The **Mobile Testing** module in TestWheel allows users to manage and execute **mobile automation** testing activities within the platform. Users can navigate to the Mobile Test module by scrolling through the side navigation panel on the **TestWheel dashboard** and selecting the Mobile Test icon, as shown in the screenshot below.

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2FoamOhvZsFyKJ82bZLAT7%2Fimage.png?alt=media&amp;token=39d97313-95a3-45ac-bc24-031210fb2d3d" alt=""><figcaption></figcaption></figure>

### Create Application

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2FtI9HKiIM6UptAdehiJdJ%2Fimage.png?alt=media&amp;token=ea116a50-f02c-4384-9e43-6bc35f3a6e94" alt=""><figcaption></figcaption></figure>

To begin mobile testing, users must create a mobile application by clicking the **Add New Application** button. This opens the Create Application page, where users are required to provide all mandatory details, including the Application **Name,** **Description,** **Environment,** **Mobile Platform (Android or iOS), OS Version,** Target Device, and the application file in **APK** or **IPA** format.

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2Fi2Sj0DLw0rzKzS83x5DG%2FScreenshot%202026-05-07%20174724.png?alt=media&amp;token=87cad601-9aa5-46b9-8846-fc057fc2410d" alt=""><figcaption></figcaption></figure>

After entering all required information, clicking the **Register** button successfully creates the mobile application for further testing activities. The Mobile Applications page provides a centralized view for managing registered applications, enabling users to search, create, edit, and monitor application configurations efficiently.

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2F7mbiOUh5LZiaJv30APj6%2FScreenshot%202026-05-07%20174647.png?alt=media&amp;token=5e94d85a-28e3-4cac-8b4e-9b8dbb6c6cf2" alt=""><figcaption></figcaption></figure>

#### Document Upload

After creating the application, **users** must **navigate to the Document Upload page** and **upload the required testing documents**, including the **Authentication** Sheet, **UI Properties** Sheet, and **User Data** Sheet. Once all required documents are uploaded successfully, TestWheel **automatically enables the Run option** for the mobile application, allowing users to proceed with mobile test execution.

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2FkUbylXBHkrAYFOAvIR8m%2FScreenshot%202026-05-07%20174909.png?alt=media&amp;token=3a003372-8628-4c31-891d-f034e79bf41d" alt=""><figcaption></figcaption></figure>

#### Test Run

To execute the mobile test, users can click the **Run** icon available for the registered mobile application. Once the Run option is selected, the system navigates to the **Test Result** page, where users can monitor the execution progress and view real-time test execution details. TestWheel then initiates the mobile automation execution process using the uploaded configuration files and selected device environment. This process allows users to validate application functionality and execute test scenarios efficiently.

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2FMOJHJqPRLRQFCLgU6Y06%2Fimage.png?alt=media&amp;token=e275ce8c-70ec-499f-ab03-ceea4d669dbe" alt=""><figcaption></figcaption></figure>

#### Edit Mobile Application

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2F9MJy10PqEeHB7txDwb9K%2Fimage.png?alt=media&amp;token=9700ce99-752e-4dc5-89fc-6f40b6baf429" alt=""><figcaption></figcaption></figure>

Click the **Edit icon** to be redirected to the **Edit Application page**, as shown in the screenshot below.

<figure><img src="https://4225752331-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfpdbhL4mnjdXkFbYOzps%2Fuploads%2FkpkpoR4dct3ia7obNIbP%2Fimage.png?alt=media&amp;token=e20178c2-706d-4d45-978b-7179a6cf805d" alt=""><figcaption></figcaption></figure>

Users can modify the required application details and click the **Update** button to save the changes successfully. While editing the application, users must ensure that the **selected OS version matches the uploaded application file version**; otherwise, the application update process may fail in TestWheel.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.testwheel.com/mobile-test.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
