BlackBerry Dynamics Bypass Unlock Feature Developer Guide

This guide explains how to implement the Bypass Unlock feature in BlackBerry Dynamics applications for Android and iOS, allowing specific screens to remain…


BlackBerry Dynamics Bypass Unlock Feature Developer Guide - cover page
Brand
BlackBerry
Document type
User Manual
Language
English
Pages
35
File format
PDF
File size
800 KB
Published
27 October, 2026
Updated
27 October, 2026
MD5 checksum
118602A004A034A4FC7B6FB5B7AF4E71

About this manual

Bypass Unlock is a feature within BlackBerry Dynamics that allows developers to configure which parts of an application's user interface remain accessible after the idle time-out expires. By default, the entire UI is locked; this feature permits designated screens (such as VoIP call interfaces) to bypass authentication for swift user response.

The document details the technical requirements for implementation, including declaring specific screens in Android and iOS configurations, embedding a unique registration message provided by BlackBerry, and defining enterprise policies. It covers the authentication cycle states where Bypass Unlock applies and provides code snippets for both platforms.

What's inside

  • Introduction
  • Availability
  • Bypass Unlock in the authentication cycle
  • Division of the user interface
  • Bypass Unlock Policy
  • Registration procedures
  • Implementation Essentials
  • Android implementation details
  • iOS implementation details

Specifications

Supported Android SDK versionsGood Dynamics SDK for Android version 2.3 and later; BlackBerry Dynamics SDK for Android version 3 and later
Supported iOS SDK versionsGood Dynamics SDK for iOS version 2.3 and later; BlackBerry Dynamics SDK for iOS version 3 and later
Product name change pointVersion 3

Frequently asked questions

What is Bypass Unlock?

Bypass Unlock allows the scope of the BlackBerry Dynamics idle lock to be configured, letting part of the application user interface remain accessible after the idle time out has expired.

When does Bypass Unlock apply?

Bypass Unlock applies only in the Idle state, which is entered when the user hasn't interacted with the application for the idle time-out duration.

How do I declare a Bypass screen on Android?

You must add a meta-data tag to the declaration of each Bypass Screen in the AndroidManifest.xml file with the name 'com.good.gd.bypassunlock' and value 'true'.

How do I declare a Bypass screen on iOS?

You must list the View Controller class names for Bypass Screens in a property named 'GDBypassUnlockViewControllers' in the Info.plist file.

Download PDF (800 KB)

More BlackBerry Manuals


View all BlackBerry manuals →