Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics SDK for Cordova 4.2
  3. BlackBerry Dynamics SDK for Cordova Development Guide
  4. Requirements
  5. BlackBerry Dynamics entitlement ID and version
  6. Setting preferences in config.xml for BlackBerry Dynamics

Setting preferences in config.xml for BlackBerry Dynamics

In
config.xml
 you can set certain preferences, as detailed here.

GDApplicationID and version

"GD Application ID" and "GD application version" are older terminology for what are now known as "BlackBerry Dynamics application ID" and "BlackBerry Dynamics application version". (The use of the older terminology in some programming constructs in the SDK and elsewhere remains unchanged.) Add the following lines to
config.xml
 to define your
GDApplicationID
 and
GDApplicationVersion
: 
<preference name="GDApplicationID" value="
Your_Custom_Application_ID
" />
<preference name="GDApplicationVersion" value="
Your_Custom_Application_Version
" />

Enterprise Simulation Mode

To enable or disable enterprise simulation mode, you can use the following preference in
config.xml
: 
<preference name="GDEnterpriseSimulationMode" value="true" />
Valid values for the value attribute are
true
 and
false
.

iOS
 only: Enterprise Discovery Scheme

On
iOS
 only, you need to set a preference for the required discovery scheme. For background, see BlackBerry Dynamics entitlement ID and version. 
<preference name="BBD_Enterprise_Discovery" value="true" />
Valid values for value are
true
 and
false
.

iOS
 only: Face ID usage declaration

This preference allows you to switch off the automatic addition of the NSFaceIDUsageDescription property in the Info.plist file. As a best practice, you should only prevent the automatic addition of the usage declaration if the app uses Face ID for a purpose other than
BlackBerry Dynamics
 integration.
<preference name="addFaceIDUsage" value="Off" />

Example settings in config.xml

Be sure to nest these preferences in the individual <platform name="ios"/> or <platform name="android"/> sections. 
<?xml version='1.0' encoding='utf-8'?>
<widget id="com.good.gd.example.pg.blank" version="1.0.0" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
	<name>Test Application</name>
	<description>
	A sample Apache Cordova application that responds to the deviceready event.
	</description>
	<content src="index.html" />
	<plugin name="cordova-plugin-whitelist" spec="1" />
	<access origin="*" />
	<allow-intent href="http://*/*" />
	<allow-intent href="https://*/*" />
	<allow-intent href="tel:*" />
	<allow-intent href="sms:*" />
	<allow-intent href="mailto:*" />
	<allow-intent href="geo:*" />
	<preference name="GDEnterpriseSimulationMode" value="true" />
	<preference name="GDApplicationID" value="com.good.gd.example.cdv.blank.new" />
	<preference name="GDApplicationVersion" value="1.0.0.1" />
	<preference name="BBD_Enterprise_Discovery" value="true" />
	<platform name="android">
		<allow-intent href="market:*" />
	</platform>
	<platform name="ios">
		<allow-intent href="itms:*" />
		<allow-intent href="itms-apps:*" />
	</platform>
</widget>

Custom icons

You can create custom default icons for
BlackBerry Dynamics
 apps. For more information, see the cordova guide.