Sample apps

You can use the sample apps available in the 
BlackBerry Dynamics SDK for Android
 to help you plan the development of your apps. The source code samples demonstrate how to apply 
BlackBerry Dynamics
 functionality. The most basic is the skeleton app, which can be used as a starting point for implementing your own projects with 
BlackBerry Dynamics
 using Enterprise Simulation Mode.
The samples are located in 
<sdk_install_directory>
/samples/, or you can download them from the BlackBerry Developers for Enterprise Apps site.
All sample apps have 
Android
 Gradle configurations. You can load any of the apps in 
Android Studio
. When you troubleshoot a 
BlackBerry Dynamics
 app, you should enable detailed logging from theconsole or build configuration.
It is recommended to make a copy of the source code in another location before making any changes. Reinstalling or upgrading will overwrite or even remove the sample apps in the default location.
Sample app
Description
Apache
 HTTP client
Provides an example of how to use 
BlackBerry Dynamics
 Secure Communication APIs to access resources behind the enterprise firewall. These secure communication APIs can be used to exchange data between the mobile app on the device and an application server using the secure 
BlackBerry Dynamics
 proxy infrastructure.
In 4.0.0 and later, this sample supports HTTP PATCH requests.
AppBasedCertImport
Demonstrates how to create an app that can import a user's PKI credentials using the 
BlackBerry Dynamics
 Certificate Credential Import API.
For more information, see Package com.good.gd.pki and Creating user credential profiles for app-based certificates in the 
UEM Administration Guide
.
AppKinetics Shared Services
Provides three examples of how to use the 
BlackBerry Dynamics
 Shared Services Framework.
App policy
Provides an example of how to use application-specific policy APIs. App policies control specific features of a single app, compared to built-in policies that apply to all apps.
This app also demonstrates how to support Night Mode. 
Bypass Unlock
Illustrates how to program for the Bypass Unlock feature. For more information about Bypass Unlock, see User authentication.
Interaction
Provides an example of how to interact with the 
BlackBerry Dynamics
 Library and use the Remote Settings API. Displays which 
BlackBerry Dynamics
 events are happening. This can be helpful when using 
BlackBerry Dynamics
 for the first time.
This app also demonstrates the use of the GDAndroid.executeBlock and GDAndroid.executeUnblock APIs that can be used to locally block or unblock a user’s access to the UI of a BlackBerry Dynamics app. 
Greetings client/server
Demonstrates how to write a client and server that use the 
BlackBerry Dynamics
 Inter Container Communications (ICC) API. The ICC system exchanges data securely between two 
BlackBerry Dynamics
 applications running on the same mobile device so that data is not compromised during the exchange.
The Greetings server app demonstrates how to support Night Mode. 
Push channel
Demonstrates how to use the 
BlackBerry Dynamics
 Push infrastructure, including how to control the connection, create channels, and send messages in a loopback manner to the client. The Push Channel framework is a 
BlackBerry Dynamics
 feature used to receive real-time notifications from an application server.
Secure copy-cut-paste
Compares the use of secured 
BlackBerry Dynamics
 UI text controls (GDTextView, GDEditText, GDAutoCompleteTextView, GDSearchView, GDWebView) and the corresponding default UI text controls. Text data is encrypted or decrypted before copy or paste operations are performed.
For more information, see Data Leakage Prevention.
Secure SQL
Demonstrates how to use the secure SQL database, showing how to add, edit, delete, and list contacts. All data stored in the secure SQL database is encrypted on the device by the 
BlackBerry Dynamics
 Runtime.
Skeleton
Provides a basic skeleton application that you can use as a starting point for application development.
Wearable framework secure store
Demonstrates how to use the 
BlackBerry Dynamics SDK
 to create, manage, and access files stored in an app’s secure container. Both the file names and file contents are encrypted, stored on the device, and can only be accessed when the 
BlackBerry Dynamics
 app is unlocked.
The secure store app consists of three sub-projects, and is best loaded into 
Android Studio
 IDE:
  • /handheld_app: Code specific to a 
    BlackBerry Dynamics
     handheld application.
  • /common: Code built into both the 
    BlackBerry Dynamics
     handheld and 
    BlackBerry Dynamics
     wearable applications.
  • /wearable_app: Code specific to a 
    BlackBerry Dynamics
     wearable application.
Importing this sample app into 
Android Studio
 causes an error message that can be ignored. The application builds correctly despite the error.