Test using passcode-protected devices

A guide for use cases that need passcode-protected devices to automate tests on BrowserStack App Automate.

For certain use cases, you might need to perform tests on devices that are passcode-protected. Some apps that deal with sensitive data, such as banking apps, require devices to be protected with a passcode as a layer of security.

Since BrowserStack remote devices are not passcode-protected as a default, App Automate provides the capability to use in the test script for getting access to passcode-protected devices.

In this guide, you’ll learn:

• Supported OS versions
• How to set the browserstack.enablePasscode capability
• How to unlock device during test execution

Supported OS versions

Currently, this feature is supported on the following OS versions:

• Android: version 8.0 and above
• iOS: version 13.0 and above

Set the capability

Use the passcode capability to enable the passcode protection in your test scripts:

DesiredCapabilities capabilities = new DesiredCapabilities();
HashMap<String, Object> browserstackOptions = new HashMap<String, Object>();
browserstackOptions.put("enablePasscode", "true");

var capabilities = {
    'bstack:options' : {
        "enablePasscode" : "true",
    },
}

desired_cap = {
	'bstack:options' : {
		"enablePasscode" : "true",
	},
}

capabilities = {
    'bstack:options' => {
        "enablePasscode" => "true",
    },
}

AppiumOptions capabilities = new AppiumOptions();
Dictionary<string, object> browserstackOptions = new Dictionary<string, object>();
browserstackOptions.Add("enablePasscode", "true");

DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
desiredCapabilities.setCapability("browserstack.enablePasscode", "true");

var capabilities = {
    "browserstack.enablePasscode" : "true"
}

desired_cap = {
	"browserstack.enablePasscode" : "true"
}

desired_caps = {
    "browserstack.enablePasscode" => "true"
}

DesiredCapabilities capability = new DesiredCapabilities();
desiredCapabilities.SetCapability("browserstack.enablePasscode", "true");

Sample code to unlock device

To unlock a device during testing, if required, use the information in the following tabs.

// your test script goes here
driver.pressKey(new KeyEvent(AndroidKey.DIGIT_1));
driver.pressKey(new KeyEvent(AndroidKey.DIGIT_2));
driver.pressKey(new KeyEvent(AndroidKey.DIGIT_3));
driver.pressKey(new KeyEvent(AndroidKey.DIGIT_4));
driver.pressKey(new KeyEvent(AndroidKey.ENTER));

// your test script goes here
await driver.pressKeycode(8);
await driver.pressKeycode(9);
await driver.pressKeycode(10);
await driver.pressKeycode(11);
await driver.pressKeycode(66);

# your test script goes here
driver.press_keycode(8);
driver.press_keycode(9);
driver.press_keycode(10);
driver.press_keycode(11);
driver.press_keycode(66);

# your test script goes here
@driver.press_keycode 8
@driver.press_keycode 9
@driver.press_keycode 10
@driver.press_key 11
@driver.press_keycode 66

// your test script goes here
driver.PressKey(new KeyEvent(AndroidKey.Digit1));
driver.PressKey(new KeyEvent(AndroidKey.Digit2));
driver.PressKey(new KeyEvent(AndroidKey.Digit3));
driver.PressKey(new KeyEvent(AndroidKey.Digit4));
driver.PressKey(new KeyEvent(AndroidKey.Enter));

Need some help?

If you need any help with this feature, get in touch with us.