Skip to main content

Uploading Files and Media on Real Devices

LambdaTest's file upload feature provides a convenient way to enhance your testing scenarios by allowing you to upload various media and non-media files directly to LambdaTest's cloud devices. In this section, we'll guide you through the process of uploading files, highlight the supported file types, and explain how to use uploadMedia capability while running your test scripts.

Objectives​

By the end of this topic, you will be able to:

  1. Use Upload File and Media feature in Manual App testing.
  2. Use Upload File and Media feature in App Automation.

Upload File and Media in Real Devices App Testing​

Easily upload media or non-media files onto real devices during active sessions, enhancing your testing capabilities on LambdaTest's platform.

Steps to Upload Files and Media Feature​

  1. Go to App Testing under the Real Devices section provided in the sidebar of your LambdaTest console.

  2. Once the session is started, locate the toolbar and find the Files and Media option.

Image

  1. You can now upload images, videos and files from your local on the device by clicking on the Upload button.

  2. After the upload is completed, you can find the uploaded file or media in the specified paths mentioned below.

File Storage Paths on Devices​

CategoryPlatformLocationFile Type
Media FilesAndroidDefault gallery app, /sdcard/PicturesImages
Default gallery app, /sdcard/MoviesVideos
iOSCamera Roll, /private/var/mobile/Media/DCIM/Images and Videos
Non-Media FilesAndroidDefault Downloads folder of the deviceFiles
iOSApp’s directory: Files app → On My iPhone → Your app's directoryFiles

Supported File Types​

LambdaTest supports various file types for upload, ensuring flexibility in your testing scenarios. Below are the supported file types:

  • Images: JPG, JPEG, PNG, GIF (Maximum size: 10 MB)
  • Videos: MP4 (Maximum size: 50 MB)
  • Files: XLS, XLSX, DOC, DOCX, PDF, CSV, TXT (Maximum size: 15 MB)

Upload File and Media feature in App Automation​

This section provides a comprehensive guide on leveraging this feature within automation tests. It comprises two fundamental steps:

  • Uploading the files and obtaining the media_url.
  • Using media_url into your tests using uploadMedia capability.

Step 1 : Uploading the files on Lambdatest Cloud​

Using REST API​

You can use the following curl command to upload any file media and non-media from your system to the LambdaTest cloud.

curl --user "undefined:undefined" -X POST "https://mobile-mgm.lambdatest.com/mfs/v1.0/media/upload" -F "media_file=@"/Users/macuser/Downloads/image.jpeg"" -F "type=image" -F "custom_id=SampleImage"

Request Parameters

  • media_file: This parameter denotes the media file to be uploaded from your local.
  • type: This parameter denotes file type out of image,video and doc.
  • custom_id: This parameter specifies a custom identifier for the media file.

Below is a sample response demonstrating the return of the media_url parameter value:

{
    "media_url": "lt://MEDIAb48ab11c599944ee9dcd26b3e2978d3c",
    "name": "sample.csv",
    "status": "success",
    "custom_id": "Sample"
}

Using App Automation Interface​

You can also utilize LambdaTest's user-friendly UI to upload the files on Lambdatest cloud and get the media_url using the upload button located at the top of the automation dashboard.

Step 2 : Setting Capability in Your Test Script​

Once the files are uploaded to LambdaTest's cloud, seamlessly integrate files into your automation tests via the capability. Set the uploadMedia capability to the media_url parameter returned in the API response.

desired_capabilities = {
  "uploadMedia": ["lt://MEDIAf446d4170cd946aa9ec307d10cb679b9", "lt://MEDIA8d13e569b3e140c18e82b066022518bd"]
}
note
  • Each automation session permits a maximum of five file uploads.
  • In manual testing, iOS app needs to installed first to upload non-media files.
  • For non-media files, make sure your iOS app's Info.plist file includes the UIFileSharingEnabled and LSSupportsOpeningDocumentsInPlace keys set to true. This configuration is necessary to enable your app's folder accessibility within the Files app.
Last updated on