Camera Image Injection

This document provides details about the camera image injection feature of Katalon TestCloud.

Camera image injection supports the following systems and interfaces:

• iOS: 13 or higher.

  • The didFinishPickingMediaWithInfo class of UIImagePickerController iOS SDK class for capturing an image. See: Apple documentation.

  • The AVCapturePhoto iOS SDK class for receiving captured photos from AVCapturePhotoOutput class. See: Apple Documentation.

• Android: 9 or higher.

  • The CameraX API: CameraX.

  • The Camera API: Camera.

  • The Camera2 API: Camera2.

  • The ACTION_IMAGE_CAPTURE Intent action: ACTION_IMAGE_CAPTURE.

One limitation of testing with cloud-based mobile devices is the ability to capture images. Camera image injection tackles this issue by simulating the action of taking images through a mobile application.

Some common use cases of camera image injection are:

• Scanning a check for a banking application.
• Scanning a QR code.
• Taking a user profile picture.
• Taking a photo and store in a gallery app.

To perform image injection, you need to specify the desired capability, prepare the images and declare the keyword. Follow these steps:

1. Open your project in Katalon Studio and go to Project Settings > Desired Capabilities > Remote. Add the boolean property enableImageInjection=true.
   
2. Save the images that are required for image injection in the Data Files/TestCloud folder of Katalon Studio project.

   The images must be in PNG, JPG, or JPEG formats, and does not exceed 4.5 MB.

   
3. Add the keyword to your project.
   Note:

   The keyword is also accessible through the Katalon TestCloud Keywords plugin on Katalon Store. You can install the plugin to automatically load all TestCloud keywords into your Katalon project, without having to manually define them. For more details, visit:

   • Katalon TestCloud keywords
   • Install plugins online from the Katalon Store

   In the Keywords folder, create and declare the CameraImageInjectionExecutor class under package com.katalon.testcloud.

   

   public class CameraImageInjectionExecutor {
       /**
        * Injects an image from "Data Files/TestCloud" into the camera for testing purposes.
        *
        * @param fileName The name of the file to inject.
        * @return true if the injection was successful, false if there was an error.
        */
       @Keyword
       def injectImage(String fileName);
   
       /**
        * Checks whether a file with the given name exist in "Data Files/TestCloud".
        *
        * @param fileName The name of the file to check.
        * @return true if the file exists, false otherwise.
        */
       @Keyword 
       def exist(String fileName);
   }

You can now use the keyword to inject images.