Manage the repository

The Perfecto Repository is the storage where you keep and manage all your digital assets, such as Android and iOS apps, images, audio files, scripts, or any other files you may need for testing purposes. In the Repository management view, you can upload, download, and delete files, search for files, or modify file information.

The repository has a flat structure. It does not include any folders or subfolders. If you need to distinguish between files that have the same filename, you can change the file name. If you need to keep the file name, you can change the locator, which essentially serves as a virtual path. The locator is the file path that is included in your automation code and API calls. If you migrated from a repository in the legacy Perfecto UI, the locator also represents the former folder structure or hierarchy. It allows you to find files that once used to reside in the same folder.

You can keep files private, make them publicly available, or give access permission to people in your group. These categories are represented as dedicated tabs at the top of the Repository management view.

The folders on the left provide access to specific file types: All apps, Android apps, iOS apps, Simulator apps, images, audio files, and other miscellaneous files. You can also view all files recently used, provided you have view permissions for them.

Perfecto supports or recognizes files with the following extensions: .3gp, .7z, .aab, .amr, .apk, .apks, .bat, .bmp, .cer, .cmd, .cpl, .crt, .csv, .data, .dart, .db, .der, .dll, .doc, .docm, .docx, .feature, .fms, .gif, .gz, .har, .heic, .heif, .hta, .html, .img, .ipa, .ipak, .jar, .java, .jpeg, .jpg, .jmx, .js, .json, .key, .local, .log, .logs, .m4a, .m4v, .mcr, .mibsettings, .mkv, .mobileconfig, .mobileprovision, .mov, .mp3, .mp4, .msi, .nib, .numbers, .opus, .pages, .pcap, .pdf, .pem, .pif, .pkg, .plist, .pl, .png, .pom, .ppt, .pptm, .pptx, .properties, .py, .rar, .rtf, .scr, .sh, .sim, .svg, .tar, .tcl, .text, .tif, .tiff, .tmp, .ts, .tsx, .tsu, .txt, .wav, .webm, .webp, .xls, .xlsm, .xlt, .xml, .xapk, .yaml, .zip, .tmo

Important: The Simulator apps folder is reserved for files of type .zip that contain .app files for installation on virtual iOS devices. Be aware that on Windows, .app files appear as folders, so when creating a .zip file, you need to do this at the level of the .app folder.

The maximum file size is 1 GB for applications and 150 MB for all other files.

For Perfecto's active accounts, files remain in the repository as long as they are being used. Usage includes injection from the repository as part of automation or manual testing, but it does not include editing. As part of Perfecto's retention policy, files that have not been used for a year will be removed from the repository. 

Tip: You can also work with the repository via the Perfecto REST API. For details, see Legacy | Repository Operations.

You can add tags to repository files to make them easier to find and handle. Tags facilitate better search and orientation, especially in large repositories where new files are added constantly. File tags are displayed in a dedicated table column and in the info panel for a file.

When you upload a new app file, Perfecto extracts and then displays the application's version number in the dedicated App version column. This helps you determine which app file version to use in testing.

Repository files are available to you when you use features such as audio injection, image injection, and image analysis.

Watch this short video to get an overview of repository management. For detailed steps, expand any of the following procedures.

  1. Under Assets and Setup > Repository management, at the bottom right, click the upload icon .
  2. Browse to the file you want to upload, select it, and click Open.
  3. In the Upload file dialog box, specify the following:

    • The file name: By default, the existing name of the file, but you can change it as needed.

      Restriction: The file name cannot contain any of the following characters: /\:"*?<>|”
    • The folder: The virtual folder. It specifies who has view access. Do you want to keep the file private, make it public, or restrict access to your group?

    • The locator: The virtual path that you will use in your automation code. By default, it consists of the virtual folder name and the file name (for example: My group: sample-app.apk), but you can insert additional levels between the virtual folder and the file name.

      Restriction: The locator field cannot contain backslash (\) characters.

      To edit the locator: Click the pencil icon , enter the additional level or levels, and then click the disk icon  to save your change.

    • Tags: Tags can be helpful when you need to find and handle your media files in the repository. They facilitate better search and orientation, especially in large repositories where new files are added constantly. You can use tags for searching in the repository, for example when you install an app, perform visual analysis, or inject an image or audio file during live testing.

      To add a tag: Click Add tag . In the text field that displays, enter a tag name and press enter. Add more tags as needed.

  4. Click UPLOAD to complete the process.
  1. Select the checkbox to the left of the file that you want to edit.
  2. On the toolbar above the table, click Edit.

  3. In the Edit file dialog box, make the required changes.

  4. Click SAVE.

Restriction: The size limit for downloading multiple files is 700 MB. For individual files, no size limit exists.
  1. Select the checkbox to the left of one or more files.
  2. Above the table, click Download.
  1. Select the checkbox to the left of one or more files.
  2. Above the table, click Delete.
  1. Click a file in the list.
  2. In the information panel on the right, do any of the following:
    1. Under Locator, click Copy to clipboard to use this information in your automation scripts.
    2. Edit the locator or file name.
  • At the top right, in the Search field, start typing.
    Search results are dynamic and update as you type. You can search by file name or any other field information.