[Mobile] Use Fingerprint


  • Katalon Studio version 8.3.0 onwards.


Simulate a fingerprint touch event on Android emulators.


  • To enable this keyword, at least one fingerprint must be enrolled on the emulator via Android Debug Bridge (adb).
  • To learn more about adb, refer to this document on the Android developer site: Android Debug Bridge.
  • To learn how to enroll a fingerprint with adb, please refer to the following Android developer guide: Fingerprint Authentication.


Parameter Parameter Type Mandatory Description
fingerprintId Int Yes An Android fingerprint ID (from 1 to 10).
flowControl FailureHandling No Specify failure handling schema to determine whether the execution should be allowed to continue or stop. Refer to: Failure Handling.


Throw Precondition Message
IllegalArgumentException If the input value for Android fingerprint ID is invalid. Please enter a valid Android fingerprint ID (from 1 to 10).
StepFailedException If the useFingerprint keyword is not performed on an Android emulator. The useFingerprint keyword supports Android emulators only.
Warning If the useFingerprint keyword is run on unsupported environments. The useFingerprint keyword is not available for physical mobile devices.


import static com.kms.katalon.core.checkpoint.CheckpointFactory.findCheckpoint
import static com.kms.katalon.core.testcase.TestCaseFactory.findTestCase
import static com.kms.katalon.core.testdata.TestDataFactory.findTestData
import static com.kms.katalon.core.testobject.ObjectRepository.findTestObject
import static com.kms.katalon.core.testobject.ObjectRepository.findWindowsObject
import com.kms.katalon.core.checkpoint.Checkpoint as Checkpoint
import com.kms.katalon.core.cucumber.keyword.CucumberBuiltinKeywords as CucumberKW
import com.kms.katalon.core.mobile.keyword.MobileBuiltInKeywords as Mobile
import com.kms.katalon.core.model.FailureHandling as FailureHandling
import com.kms.katalon.core.testcase.TestCase as TestCase
import com.kms.katalon.core.testdata.TestData as TestData
import com.kms.katalon.core.testng.keyword.TestNGBuiltinKeywords as TestNGKW
import com.kms.katalon.core.testobject.TestObject as TestObject
import com.kms.katalon.core.webservice.keyword.WSBuiltInKeywords as WS
import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import com.kms.katalon.core.windows.keyword.WindowsBuiltinKeywords as Windows
import internal.GlobalVariable as GlobalVariable
import org.openqa.selenium.Keys as Keys

'Start application on the current selected Android emulator'
Mobile.startApplication('/Users/katalon/Downloads/Fingerprint.apk', true)

'Simulate fingerprint touch with the desired fingerprint ID'

'Authentication is valid, do some actions'

'Close application on the current selected Android emulator'