Install an app using the Manual Testing UI

Use the Manual Testing UI to install an app on a Perfecto device. This is useful for validating app behavior during manual testing sessions or reproducing issues before running automated tests.

Prerequisites

• For virtual iOS devices: Use an .app file compressed as a .zip file. Upload the .zip file during installation.

• App file size must not exceed 1050 MB.

Step-by-step instructions

To learn how to install an app on a Perfecto device using the Manual Testing UI, watch the following short video or perform the steps following the video.

1. To open the Applications dialog box, on the device toolbar, click the applications icon .

2. To start the installation, in the Applications dialog box, click INSTALL NEW.

3. To select the app source, in the Install new app dialog box, in the SELECT APP panel, choose one of the following:

   • Repository (default): Locate and select a file from the Perfecto repository.

     You can search by tag name, if applicable. A tag icon appears below tagged files, along with the number of tags associated with the file (example: ). Hover over the icon to see tag names.

   • Computer: Upload a file from your local machine.

     Click ADD FILE, browse to the file, select it, and click Open.

4. To configure instrumentation, click NEXT.

5. In the CONFIGURE APP panel, turn on any required instrumentation options.

   Virtual devices do not support instrumentation, with the exception of secured screen instrumentation.

   iOS options

   • Sensor instrumentation 

     Required if your app interacts with sensors (camera or fingerprint). This option also includes re-signing the application.

     When instrumenting apps with biometric authentication, see also Biometric authentication on iOS devices.

   • WebView instrumentation: Use if your app displays content in WebViews (includes re-signing).

   • Resign an application: Use if the app must be signed with a Perfecto provisioning file. This option is disabled if either of the above iOS options is selected.

   Android options

   • Camera sensor instrumentation: Required for camera access.

   • Biometric sensor instrumentation: Required for biometric features like Face ID or fingerprint.

   • WebView instrumentation: Use if your app uses WebView components.

   • Secured screen instrumentation (Android 12 and later): Use if the app includes secured screens. This removes the FLAG_SECURE setting.

6. (Optional) If you want the app to open automatically, select the Launch after installing check box.

7. Click INSTALL APP. 

   Perfecto installs the app and launches it if the option was selected.