BlackBerry Spark Communications Services Guide

Download

You can download the Spark Communications Services SDK from the BlackBerry developer resources web site.

Configure

Your application will use the SDK to connect to the BlackBerry Infrastructure. Before it can do this, you must have a BlackBerry Online Account and you must add your application to that account.

Add your Application

To add your application to your BlackBerry Online Account, visit the Add Application page. Provide the Name and Entitlement ID of your application, and ensure that Communications Services are enabled. When you are finished, click the Add Application button.

Add your Application

Configure your Domain

When you are building and testing your application, you will run it in the Spark Communications Services sandbox environment.

Within the sandbox environment, your application is assigned a private domain. After you add your application, you will be asked to configure your domain to support your user authentication mechanism and how your application will manage its security keys.

To get started using the SDK's example applications, you should configure your new domain as shown below.

Configure your Domain

Ensure that the Enable User Authentication feature toggle switch is in the off position. This means users of your application don't need to authenticate using a real identity provider while you are developing and testing it.

Ensure that the BlackBerry Key Management Service feature is selected.

Finish configuring your new domain with the Create Domain button. The next screen will display your domain's ID and allow you to configure Push Notifications that let the BlackBerry Infrastructure send messages to your application even when it is not running.

Your Domain Details

Platform Guides

The next steps that you take depend on what platform you are developing your application for. Select one of the following guides to help you finish integrating the SDK into your application.

Platform Description
Android Steps to integrate the SDK into your Android application.
iOS Steps to integrate the SDK into your iOS application.
Web Steps to integrate the SDK into your web site or web application.
Node.js Steps to integrate the SDK into your Node.js application or server.
Linux Steps to integrate the SDK into your Linux application or server.

Examples

BlackBerry provides several example applications that demonstrates basic SDK usage such as: