Running the test of a Mobile application

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Overview
Test in the simulator
Test in the emulator
Test in native
Direct test on the device connected to the development computer
Stopping the project test
Stopping the test of a project in simulator mode
Stopping the test of a project in the emulator
Stopping the test of a project on the mobile device
Remarks
Directory of data files used for test

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Running the test of a Mobile application

Overview

The test of the entire project is used to simulate the start of the application by the user (executable, package, ...). This allows you to run the test of entire application, even if its development is not finished yet.

Summary table of available tests according to the platforms:

	Simulator (Development computer)	Emulator	Native (on the device)

	X	X (on PC)	X (connected device)
	X	X (on MAC)
	X		X (connected device) Debug possible
Universal Windows 10 App	X		X

Overview of the different types of tests
Several types of project tests are available in WINDEV Mobile:

Test in a simulator (Test on the development computer):
This test simulates a mobile device on the development computer. No connection to a mobile device is required during this test. This test allows you to use the debugger. However, this test being run on a PC and not on the real device, the application may behave differently in some ways.
Direct test on the device connected to the development computer.
In this case, the executable corresponding to the project is created, copied onto the device and run. When running the program on the device, the device can be disconnected from the PC. The debugger is not available.

Test in the simulator

To run the test of the current project on the development computer (in simulation mode):

Click among the quick access buttons (or press Ctrl + F9).
Validate (if necessary) the warning window for the simulator mode.
If the first project window was not defined, a window is displayed, allowing you to select the first project window.
The editor is automatically minimized and the project is run.

Remarks:

The result of some features depends on the platform used (operating system, format of character strings, ...). Differences may occur when running the test in simulation mode and when running the application test on the device corresponding to the relevant platform.
Debugging in the simulator: The application can be debugged in the simulator. This mode is used to quickly debug a new function or to check an algorithm but it presents differences of behavior. Some examples:
- path of files: the paths used are the ones of Windows.
- format of character strings.
- functions specific to the mobiles not available.

Test in the emulator

To run the test of the current project in the emulator:

Expand among the quick access buttons and select the corresponding option: "Run the project test (emulator xxx)".
The application is automatically generated.
A window allows you to select the emulator or the device onto which the application will be copied and run. This window is used to create an emulator if necessary.
Select the desired emulator and validate.
The emulator and the application start.

Test in native

Direct test on the device connected to the development computer

To run the test of the current application on the device connected to the development computer:

Expand among the quick access buttons.
Select:
- "Run the application test in real".
If the application has not been generated, the application generation wizard will automatically start.
The application is copied onto the device and it is run.

Stopping the project test

Stopping the test of a project in simulator mode

In simulator mode, several methods can be used to stop the test:

1st method: Close the application whose test is currently run (via an option used to close the application for example). WINDEV displays the editor that was used at the beginning of test.
2nd method: Close the window where the test of the Pocket PC application is run.
3rd method: Go back to the editor with the taskbar (or Alt + Tab) and confirm that the test must be stopped. WINDEV displays the editor that was used at the beginning of test.

Stopping the test of a project in the emulator

To stop the test of a project in the emulator, all you have to do is close the application in the emulator.

You also have the ability to close the emulator. However, the emulator taking quite a long time to be started, we advise you to leave it opened if several tests must be run.

Stopping the test of a project on the mobile device

During the direct test on the device, all you have to do is stop the application on the device.

Remarks

Directory of data files used for test

To configure the data files used when running the site test in the editor:

Open the project description: on the "Project" pane, in the "Project" group, click "Description".
In the "File" tab, select the location of the test files:
- Current directory: The data files will be in the project EXE subdirectory.
- Specific directory: The data files will be found in the specified directory.

Reminder: When running the test of the application, the data files used are those found on the development computer. The file system also corresponds to the Windows system for PC. To avoid any problems when the application is used in a real-case scenario, use InTestMode to differentiate between the access to the data files in test mode and at runtime. See Differences noticed between a simulation and a real execution for more details