BlackBerry Dynamics run-time state. More...
#import <BlackBerryDynamic/GD/GDState.h>
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.
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:
userInfo
dictionary with the following items.GDStateChangeKeyProperty
constant.GDSt
ate
instance as it was after the change, in the key named by the GDStateChangeKeyCopy
constant.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 GDiOSD
elegate
, 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.
Properties | |
BOOL | isAuthorized |
BlackBerry Dynamics authorization state. More... | |
GDAppResultCode | reasonNotAuthorized |
Reason the user isn't authorized, if they aren't. More... | |
GDUserInterfaceState | userInterfaceState |
Which user interface is in front. More... | |
GDLibraryScreen | currentScreen |
Limited indication of which screen from the BlackBerry Dynamics user interface is in front, if any. More... | |
BBDActivationState | activationState |
BlackBerry Dynamics activation state. More... | |
NSArray< NSString * > * | activationProcessingDescriptions |
An Array containing static descriptions of Blackberry Dynamics activation processing states. More... | |
NSUInteger | activationProcessingIndex |
An integer representing the current activation processing stage. More... | |
|
readnonatomicassign |
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.
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.
|
readnonatomicassign |
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.
|
readnonatomicassign |
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.
|
readnonatomicassign |
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.
|
readnonatomicassign |
This property is used to indicate the current state of the BlackBerry Dynamics activation process.
|
readnonatomicassign |
NSArray of NSString descriptions of Blackberry Dynamics activation processing states. To retrieve the current activation processing state use activationProcessingIndex
|
readnonatomicassign |
Use this index to access the descriptions contained within activationProcessingDescriptions