About Mobile Checkpoints

How Mobile Checkpoints Work

How to Create Mobile Checkpoints

Specifying Images for Mobile Checkpoints

A mobile checkpoint is a test operation that checks whether the specified UI element is displayed on the mobile device screen. In image-based tests, this may be necessary if you want to ensure that a control is visible on screen before simulating user actions over it. If the mobile checkpoint passes (that is, if the needed image is on the screen), the test engine returns True. Otherwise, it returns False.

In keyword tests, you perform the check by using the Mobile Checkpoint operation.

In script tests, you perform the check by using the ImageSetItem.CheckImage method.

If you are working with an iOS device, your application running on the device must be prepared for testing. Otherwise, TestComplete will not be able to access the device’s screen. For information on how to prepare iOS applications for testing, see Preparing iOS Applications (Legacy).

To add a mobile checkpoint to your test:

Add the Mobile Checkpoint operation to your keyword test.

When creating a mobile checkpoint, you specify the image the checkpoint will search for on the mobile device screen. You can either select an existing image stored in the Image Repository collection or capture a new one. To capture a new image, select it from screen.

You can select an image corresponding to an accessibility element or you can select an arbitrary rectangular screen area.

For more information, see Image-Based Testing.