- 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
- Directory of data files used for test
Testing a Mobile application
To test the current project on the development computer (in simulation mode):
- Click in the quick access buttons (or press Ctrl + F9).
- If the first project window was not defined, a window is displayed, allowing you to select the first project window.
If the application is intended to be used on phones and tablets, two windows are displayed:
- a window used to define the first project window on the phones.
- a window used to define the first project window on the tablets.
- Validate (if necessary) the warning window for the simulator mode.
- The editor is automatically minimized and the project is run.
- 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. For example:
- path of files: the paths used are the ones of Windows.
- format of character strings.
- functions specific to the mobiles not available.
- You can pass a command line to the application during the test: on the "Project" tab, in the "Test mode" group, expand "Test mode" and select "Configure test mode". In the window that appears, enter the desired command line (personal or common to all users). For more details, see Testing a project: setting.
- Testing an iOS 14 widget application: You can directly test iOS 14 widget windows in the WINDEV Mobile simulator. The characteristics of Widget windows are taken into account.
To test the current project in the emulator:
- Expand in the quick access buttons and select the corresponding option: "Test project (xxx emulator)".
- 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.
The Android emulator is supplied with the Android SDK. To use an emulator, you must first create it in Android Studio (refer to the Android Studio documentation for more details). If the emulator has been created, it will automatically appear in the list of available devices for testing via the "GO" option.
- The emulator may take a long time to start. It is recommended not to close the emulator between 2 project tests.
- The debugger is not attached to the application. The breakpoints are ignored.
- This type of test does not take the speed of the phone into account. The test takes the speed of the development computer into account.
- Some WLanguage functions are not available in the emulator. The documentation of the different functions indicates whether the function can be used in the emulator. The functions fail when they are not available.
iOS emulator (Xcode)
- iOS 14 widget: When testing from Xcode, a widget mode is forced by default. If necessary, you change the configuration in Xcode (refer to the Xcode documentation).
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 or WINDEV Mobile displays the editor that was open when the test was started.
- 2nd method: Close the application test window.
- 3rd method: Go back to the editor via the taskbar (or Alt + Tab) and stop the test. WINDEV or WINDEV Mobile displays the editor that was open when the test was started.
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.
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" tab, 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 testing 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.
This page is also available for…