3 | Test your app

Install your app

1. On the device tab, in the device toolbar on the right, click the applications icon .

2. In the Applications dialog box, click INSTALL NEW.

3. In the Install new app dialog box, in the SELECT APP panel, select Computer.

4. Add your file: 

   1. Click ADD FILE.

   2. Browse to the file you want to use.

   3. Select the file and click Open (or Choose on Mac).
      The file loads.

5. Click NEXT.

6. In the CONFIGURE APP panel, turn on any of the following options, as required:

   • Sensor instrumentation

     On iOS, this option also includes re-signing the application.

   • WebView instrumentation

     On iOS, this option also includes re-signing the application.

   • (iOS only) Re-sign an application

     If you have selected any of the other two options, this option becomes unavailable.

7. (Optional) Clear the Launch after installing check box if you do not want to start the app right away.

8. Click INSTALL APP. 
   Perfecto installs the application and launches it (if you selected this option).

Explore testing options

To see how you can interact with the mobile device, watch this short video that shows how to open a browser session.

The device toolbar includes all or most of the options listed in the following table. Take your time to explore and play with them.

Option	Description
	Click to retrieve device information, including OS, device ID (which reflects the real UDID, Unique Device Identifier, here), location, and so on, and generate capabilities. The available information is different for each device type.
	Click to copy the session ID. See also Share a session with an IDE script.
	Click to add a checkpoint at any point during your test. See Add a checkpoint.
	Click to turn on Accessibility mode and perform VoiceOver testing (iOS devices only). See Test accessibility with VoiceOver or TalkBack.
	Click to draw a frame around the desktop image.
	Click to install, run, stop, delete, or look for an application on the device. For details, see Manage apps.
	Click to start and stop image injection.
	Click to inject a fingerprint (iPhone 8 or earlier) or face ID (iPhone X or later). For details, see Inject a fingerprint or face ID.
	Click to set a location.
	Click to set an IP geolocation. This simulates the physical location of the device to a country of your choice.
	Click to initiate network virtualization.
	Click to initiate an SMS to this device.
	Click to initiate a call to this device.
	Click to inject an audio file.
	Click to enter secure text in a sensitive text field, such as a password field. On devices running iOS 13 or later, clicking a secure field automatically opens the Enter text dialog box. On Android devices, you need to open this dialog box manually.
	Click to turn audio on or off for the device. Note that turning on audio when a video is playing on the open device momentarily halts the video while Perfecto retrieves the audio stream. Unavailable if the device does not support audio. Android audio streaming is only supported in enterprise clouds, on devices running Android 12 or later. Earlier Android versions may work as well but are not officially supported.
	Click to restart the device, for example when the device freezes or for a fresh start.
	Click to connect the device to or disconnect the device from DevTunnel.
	Click to rotate the device from portrait to landscape and vice versa.  On virtual devices, rotation only works if the screen supports it. For example, the Home screen only supports portrait mode. If you launch an app, perform a touch action, or press the Home button, the rotation may change. In addition, a rotated device switches back from landscape mode to portrait mode when you access a screen that does not support rotation, such as the home screen.
	Click to transfer, download, upload, or delete a file.
	Click to view the device log.
	Click to perform text analysis.
	Click to perform visual analysis.
	Click to spy objects on the device screen. This opens the Object Spy in the right pane.
	Click to ignore the current test or to end the session.
Session persistence	Depending on the device you select, sessions are either alive for a single session only or persist.

The interactive experience is similar to what you would be getting if using your local browsers:

• To type, click the desired field and start typing. You can type in any language that your workstation supports.

• To view the context menu, right-click.

  The target browser handles the right-click option (not your workstation browser). To use the right-click option handled by your workstation browser, right-click outside of the browser session space.

• Use familiar keyboard shortcuts, such as CTRL+A to select all text or CTRL+C and CTRL+V to cut and paste text, or other combinations supported by the OS.
• Use your mouse wheel to scroll. 
• Use the developer tools of your session browser, usually by pressing the F12 key. The session catches all keyboard activity. To use the developer tools of your workstation browser, click the address bar and then press F12, or select it using the menu in your workstation browser.
• To take a screenshot, use your workstation snipping tool or any other graphic tool of your choice.

• To close a session, click the stop button .

  In the End test dialog box:

  1. Select how to end the test:

     • Ignore it: Select if you don't want to generate a report for this test.

     • Mark Passed: Select if you consider the test a success. Then provide a name and, optionally, copy the link to the report.

     • Mark Failed: Select if the test did not pass. Provide a name and, optionally, enter a description of the failure and copy the link to the report.

  2. Select END AND RELEASE DEVICE. If you are not ready to release the device and only want to end the test, click END AND START NEW TEST.

Watch this short video to see how you can interact with the browser in the desktop web session.

For more information on desktop web testing, see Test web apps on desktop browsers and Share a session with an IDE script.