Use Image Injection in AIQ Mobile Testing

The Set Camera

Use Image

Image injection lets a mobile test provide a controlled image to bethe usedapplication under test when triggeringthe scenario needs repeatable camera, upload, or visual-input behavior. Use controlled test images and avoid customer-sensitive content.

When to use image injection

• Testing flows that ask the camera during a test. For example, you could use thisuser to injectupload a QR code into your test script.

  

  Compatibility Summary

  Service

  iOS

  Android

  Requirements

  Device

  Simulator

  Device

  Simulator

  On Premises

  Not supported

  Not supported

  Not supported

  Supported

  Update emulator settings.

  Sauce Labs

  Supported

  Not supported

  Supported

  Not supported

  Add capability: sauceLabsImageInjectionEnabled: true

  BrowserStack

  Supported

  Not supported

  Supported

  Not supported

  Add capability: enableCameraImageInjection: true

  LambdaTest

  Supported

  Not supported

  Supported

  Not supported

  Add capability: enableImageInjection: true

  On-Premises

  Available for Android emulators only when running AIQ locally.

  When running AIQ on an EC2 we don’t have access to JAVA_HOME environmental variable nor the local file system, hence we can’t override the emulator settings.

  Android Emulator Setup

• From Android Studio open the Device Manager.

Click the Edit button for the emulator that you want to use.

 In the Virtual Device Configuration window, click Show Advanced Settings.

 In the Camera section select VirtualScene from the drop down.

Click Finish.

Sauce Labs

Available for Android and iOS physical devices only. There’s support for native apps only.

The config file’s capabilities need to include the following field:

"sauceLabsImageInjectionEnabled": "true"

Sauce Labs' App Config

Login into your Sauce Labs account.

Go to App Management.

Click the Settings button for the app you want to use.

Turn the Image Injection switch on.

Supported APIs

Android System Camera

For Android devices, there are multiple ways toor capture an image,image.

Validation workflow

1. Select a small set of approved test images with known expected results.
2. Configure the following:mobile
   environment

3. ACTION_IMAGE_CAPTURE Opensso the systemapplication camera and notifies the calling app when the image is taken.

camera2 API: Everything is configured and handled from within the app.

cameraX: Leverages the capabilities of camera2, but uses a simpler, use case-based approach that is lifecycle-aware.

Camera API (deprecated): partially supported. As with camera2, everything is handled in the app itself. QR Code readers often use Camera#setPreviewCallback. We pass the injected image to this method, but the rest of this deprecated API is not supported. UI Elements will not likely displayreceives the injected image.

iOS System Camera

For iOS devices, the camera can be configured with different outputs. AIQ supports the following:

AVCapturePhotoOutput: for capturing still images. The results are received via the AVCapturePhotoCaptureDelegateand the method captureOutput:didFinishProcessingPhoto:error: The other methods in this delegate are either deprecated or handle live photos, which we don't support.

AVCaptureVideoDataOutput: for capturing video frames and processing them. The frames are received via AVCaptureVideoDataOutputSampleBufferDelegate and the method captureOutput:didOutputSampleBuffer:fromConnection:.

AVCaptureMetadataOutputfor reading QR-Codes. The QR Codes are passed to the app via captureOutput:didOutputMetadataObjects:fromConnection:. We are detecting the AVMetadataMachineReadableCodeObject and QR Codes are part of that.

Sauce Labs documentation is available here.

BrowserStack

The config file’s capabilities need to include the following field:

"browserstack.enableCameraImageInjection": "true"

Supported APIs

Camera image injection is supportedassertions for the followingscreen, Camerauploaded APIs.file, Checkextracted withtext, youror appdownstream development team to get more details aboutrecord.

Browser Stack full documentation here.

LambdaTest

The config file’s capabilities need to include the following field:

"enableImageInjection": "true"

LambdaTest App Setup

1. Login to your LambdaTest account.

2. Go to App Testing under Real Devices.

3. Hover the Settings icon and toggle the Image Injection switch on.

Supported APIs

Below given is the list of Camera APIs which are supported by LambdaTest Image Injection tool. Please ensure that your app uses these APIs only to enable Image Injection.

LambdaTest full documentation here.