BlackBerry Dynamics
Runtime library for iOS applications
from the application developer portal

GDState Class Reference

BlackBerry Dynamics run-time state. More...

#import <GDState.h>

List of all members.


Detailed Description

This class represents a number of aspects of the BlackBerry Dynamics run-time state. The representation is compliant with key-value observing (KVO). An instance of this class is also used as the object from which notifications of configuration changes are posted.

The following aspects of run-time state are represented here.

Changes to the following types of configuration are posted from here.

Synchronous access and notifications

To get a current state synchronously, read the instance's properties. To receive a notification whenever an aspect of the current state changes, use KVO or NSNotificationCenter programming interfaces, with the following notes.

Notes on KVO usage:

Notes on NSNotificationCenter usage:

See also:
Key-Value Observing Programming Guide on the developer website.
NSNotificationCenter class reference on the developer website.


Using this class is an alternative to using some parts of using the GDiOSDelegate class.

If the application uses this class to monitor authorization, and doesn't implement GDiOSDelegate, then the BlackBerry Dynamics event receiver check must be switched off. Instructions for switching off are on the Build-Time Configuration page, under the Event Receiver Check heading.

See also:
Sample code in the GreetingsServer application that comes with the BlackBerry Dynamics software development kit for iOS.

Property Documentation

- (BOOL) isAuthorized [read, assign]

The BlackBerry Dynamics runtime sets this property to NO when the application starts.

The BlackBerry Dynamics runtime sets this property to YES when authorization processing completes with success. The property value remains the same when the inactivity time expires and the user interface is locked.

The BlackBerry Dynamics runtime sets this property to NO if the end user's authorization to use the application is permanently withdrawn. For example, when any of the following happen.

  • A remote lock container management command is received from the enterprise management console.
  • An enterprise policy violation is detected.

If this property has the value YES, then the prinicipal programming interfaces of BlackBerry Dynamics can be used by the application code. This includes access to the secure store and secure communication, for example.

See also:
GDiOS for more details on authorization processing and states.
- (GDAppResultCode) reasonNotAuthorized [read, assign]

The BlackBerry Dynamics runtime sets this property when the user isn't authorized, i.e. when the isAuthorized property is NO. The value set represents the reason that the user isn't authorized. It will be from the GDAppResultCode enumeration.

- (GDUserInterfaceState) userInterfaceState [read, assign]

The BlackBerry Dynamics runtime sets this property to GDUIStateGDLibraryInFront when any of its built-in screens is in front of the application user interface.

The BlackBerry Dynamics runtime sets this property to a different value otherwise. See the GDUserInterfaceState enumeration.

- (GDLibraryScreen) currentScreen [read, assign]

The BlackBerry Dynamics runtime sets this property when its user interface is in front, i.e. when it has set userInterfaceState to GDUIStateGDLibraryInFront. The value set gives a limited indication of which screen it is showing. See the GDLibraryScreen enumeration.

- (BBDActivationState) activationState [read, assign]

This property is used to indicate the current state of the BlackBerry Dynamics activation process.

- (NSArray<NSString *>*) activationProcessingDescriptions [read, assign]

NSArray of NSString descriptions of Blackberry Dynamics activation processing states. To retrieve the current activation processing state use activationProcessingIndex

- (NSUInteger) activationProcessingIndex [read, assign]

Use this index to access the descriptions contained within activationProcessingDescriptions

The documentation for this class was generated from the following file: