Skip Navigation

Troubleshooting common issues

Problem
Possible solution
Linking problems (for example, undefined symbols)
To verify that you included the necessary frameworks and libraries, check the appendix of the 
BlackBerry Dynamics SDK for iOS
 API Reference
.
Access and password screens are poorly rendered
Verify that 
GDAssets.bundle
 has been added to the 
Copy Bundle Resources
 build phase and that the copy of the bundle distributed with the framework has been added to the project.
App crashes
  • A crash in the early stages of the app lifecycle is most likely caused by a configuration issue. Review the errors printed in the logs for details.
  • Initialize the 
    BlackBerry Dynamics
     libraries before calling any other 
    BlackBerry Dynamics
     API.
Provisioning error
The email address or access key (PIN) has been incorrectly entered, or an old access key has been used. Double-check the credentials and, if necessary, send a new access key from the 
BlackBerry UEM
 management console.
Blank screen with keyboard when the app is launched
The 
BlackBerry Dynamics
 user interface is not correctly integrated with the app. Verify that 
awakeFromNib
 is implemented without warnings.
Blank screen after the password is entered
The app was authorized but failed to continue because the 
GDAppEventAuthorized
 event passed to 
handleEvent
 was not handled correctly.
A device command from 
BlackBerry UEM
, such as wipe or lock, did not go into effect immediately
The app was unauthorized but failed to stop running because the 
GDAppEventNotAuthorized
 event passed to 
handleEvent
 was not handled correctly.