About this group

The core value of this group is to bring developers up to speed with BB technology, concentrating on BB10.Exploring efficiency, beauty and power BlackBerry provides to its users by designing Apps that can be used globally and that improves developers life as it improves community life.

Contact Name: Michael Kimathi
  Contact the manager of this GroupSpaces group
Category: Other

News & Announcements

BlackBerry Developer Meet-up September (Built For BlackBerry Revitilized)

  • Saturday, 14th September 2013 at 3:30pm - 8:30pm
    Location: ihub Bishop Magua Building George Padmore Lane Nairobi, Nairobi KE

    Register Here

    • 12 people attended

Built For BlackBerry and Certification

  • Saturday, 3rd August 2013 (all day)
    Location: Ihub 4th Floor Bishop Magua Centre

    Now that everyone is looking forward to build application which qualifies for built for BB We…

    • 45 people attended


  • Saturday, 4th May 2013 at 10am - 5:30pm
    Location: IHub Nairobi

    It was amazing to get great ideas hit the floor as we get new developers started as well as…

    • 22 people attended

Previous items

RSS Feed

Manny on the Road: AppsWorld North America


Written by:  Manny Elawar

Last week my colleagues and I took part in the AppsWorld North America 2015 conference in San Francisco.  The event had 350+ Exhibitors, and roughly 10,000 attendees; needless to say, there was a lot going on, and I want to recap the week with you by sharing some nuggets of info I picked up along the way.

If you have followed my previous blog posts over the last year, you may have seen a theme developing: I’m big on mobile apps for the Enterprise.  My argument has been based on research and personal experience indicating that remaining lucrative in the mobile app game requires a shift to targeting the Enterprise audience.  AppsWorld reinforced that line of thinking for me in a few key ways:

  1. The Enterprise World Track – AppsWorld dedicated one of the five 2-day tracks entirely to the Enterprise (the other four being gaming, developer, connected car, and droid worlds). This track contained a host of talks and panel discussions focused on the challenges, solutions, trends, and new innovations in the enterprise space as it pertains to mobility.  I had the pleasure of speaking on a panel discussing the challenges of device and application management in the Enterprise, and it was an interesting and lively session.  Other areas touched on were Secure Containers (by my colleague Shikhir Singh), Cloud, Mobility in the Government, Mobility and Security, UI and UX for Mobile in the Enterprise, Tools, Messaging, and more!
  1. The CIO Leadership Summit – AppsWorld didn’t stop at the Enterprise World track. The increase in demand for Enterprise Mobility led the organizers to develop a one-day track on day #2 specifically for CIO’s.  In this track, my colleague Brent Thornton gave the keynote address discussing Building a Strong Foundation for the Future of Cross Platform Enterprise Mobility.  In his talk he emphasized the need to embrace cross-platform development methodologies in order to build a lean mobility strategy for Enterprises, allowing the employees of an organization to become more productive.  The message sincerely resonated with the CIO’s in attendance, and directly aligned with what they have been experiencing within their businesses.
  1. The Exhibitors – Not only were the organizers dedicating stage time to discussing Enterprise topics, but the multitude of exhibitors were showcasing products and services that were directly targeting the Enterprise. I saw companies that provide Enterprises with the ability to perform remote automated mobile testing for their applications, companies that allow for extremely scalable two-way push notifications, companies that have created mobile content platforms that increase Enterprise productivity, and provide data security and compliance, and much, much more.  It was clear to me that the companies that are succeeding and want to share their products and services with others were targeting the Enterprise audience to succeed.
  1. The Huge Interest in BlackBerry – My colleagues and I took part in panel discussions, talks, and keynote addresses, but we also had a dedicated BlackBerry booth on the exhibition floor to engage with the 10,000+ attendees present at AppsWorld. To say we were busy is an understatement; the booth had non-stop traffic, which is something I haven’t experienced in a while in the Bay area! People involved in the mobility space are quickly realizing BlackBerry is the leader in Enterprise Mobility Management (EMM).  Not only were they interested in application development, but also in the solutions we provide, our expertise in security, and what the future holds for EMM solutions.  From our BES12 service, to our continuously evolving IoT strategy, the questions and interest were non-stop, and extremely refreshing!

So the message is clear: when it comes to mobility, the Enterprise is the big thing.  Whether you are developing mobile applications, targeting wearables, or looking to break into the IoT space, the Enterprise audience is where it’s at.  To learn more about developing for the Enterprise, and to gain access to the benefits of BlackBerry’s Enterprise Partner program, visit https://partner.blackberry.com/



1 day ago
A Simple Bluetooth Smart (Low Energy) iBeacon Cordova Plugin

main pic

Image “Beachy Head Lighthouse” by Adam Hickmott / FreeDigitalPhotos.net

Written by:  John Murray


In the time that I have been writing about Beacons they seem to have become all-pervasive with new use-cases appearing almost every day. I’ve already discussed iBeacon technology in previous posts such as this one: Where’s My Beacon, so if you need to refresh your understanding of the technology you might like to take a look at that article or the others in the series which I’ve linked in the Resources section of this post.

These earlier articles and associated GitHub samples generally took the Native code approach, so, I thought that it would be a good idea to meld this iBeacons work with the Cordova Plugin approach that I’ve been writing about recently. If you want to refresh your memory about how I’ve been integrating Bluetooth, both “legacy” and “Smart” variants, with Cordova on BlackBerry 10 you might like to take a look at this article: A Simple SPP Plugin, or one of the others I’ve linked in the Resources section below.

The Bluetooth iBeacon JavaScript API

iBeacon is really a de-facto standard that was defined by Apple Inc. using the Manufacturer specific field in the Bluetooth Low Energy Advertising frame. As such there isn’t an official Bluetooth SIG specification covering iBeacon and APIs generally have evolved to cover the main aspects of Beacons:

  • Discovery of Beacons
  • Exposure of the key iBeacon attributed of: UUID, Major Number, Minor Number, Received Signal Strength Indication (RSSI) and a reference transmitted power

iBeacon vendors generally supplement these with their own Bluetooth Smart management APIs that are generally proprietary and different from one vendor to the next. In this plugin I’ll implement only the common aspects of iBeacon discovery and attribute determination – iBeacon management is out of scope for this simple example.

Both the iBeacon Cordova plugin that I’ve written along a simple application that uses it are available as a project on GitHub here:


You’ll find instructions on how to build and use the project here:


And, lastly, but by no means least, I’ve documented the iBeacon JavaScript API here:


I’m not going to go through the details of each element of the JavaScript API since it’s been documented in the link above and you can read all the details there. Rather, I just want to point out one or two features of how it works and was designed.

There are two types of elements in the API:

  • Synchronous functions
  • Asynchronous functions

Synchronous Functions

I use this form when some operation, such as initialising Bluetooth Smart, needs to be performed and I’ll know whether this has been successful or not by the returned value from the call.

code 1

So, the returned value from “initialiseBluetooth” would be one of these:

code 2

Note that, in line with my previous plugins, all return values are of this general pattern: JSON format with common interpretation of attributes such as “status” and “desc”! I’ve chosen to use JSON preferentially since it’s easy to parse both in WebWorks and the plugin itself using the “Json::FastWriter” class and its relatives.

Asynchronous Functions

I use this type of function when some operation needs to be initiated. I’ll be able to tell whether the operation has been successfully started by the return value from the call to the function; and, as the operation itself is completed I’ll receive information back from the plugin using a call-back. A good example of this pattern would be the call, startMonitoring() that starts the plugin listening for inbound heart rate notification events that are delivered via the beaconCallback call-back.

code 3

I’d use it something like this:

code 4

I can test the variable “foo” to check that the request to start monitoring for iBeacons has been initiated correctly; and then, when an inbound iBeacon advertisement is detected by the plugin, the call-back “beaconCallback()” is called by the plugin. The data that is passed back as an argument to beaconCallback() might look something like this:

code 5

This represents a typical iBeacon advertisement event. The “data” attribute matches the data expected from the iBeacon attributes embedded within the Bluetooth Smart Advertisement Frame. This represents an advertisement from an iBeacon with a UUID of “CCBF9400E2C011E48A001681E6B88EC1”,  major and minor numbers of 1 and 1 respectively as 16-bit unsigned integers, an RSSI of -84 dBm and a reference transmitted power (txpower) of -64 dBm.

iBeacons typically advertise every 100 ms but I’ve chosen to throttle how often Bluetooth actually scans for new devices by setting the scan interval to 1000 ms using bt_le_set_scan_params() since it’s easier to see what’s happening in this example by throttling the rate at which events are delivered to the application.

Check out the API reference for details: https://github.com/blackberry/WebWorks-Community-APIs/blob/master/BB10-Cordova/simplebeaconplugin/documents/API-Reference.md .

The Plugin Itself

As with all of the other plugins I’ve written I’ve cheated, in a sense – I have to admit that I didn’t write this plugin from scratch myself. I had help. What I did was to use the excellent Cordova Plugin Template for BlackBerry 10 that you can find on GitHub here:


It comes with an Ant script that you can use to customise various aspects of your plugin including its name. What you get, after you’ve done this, is a project that you can import into Momentics and a matching sample WebWorks/Cordova application that you can build. You should take a look at this in GitHub since it comes with a great explanation of how a plugin is architected and organised.

I’m going to assume that you have done this and now have a grasp of how a plugin works. What I’m going to explain now is how I’ve overlaid this model on top of the BlackBerry 10 Bluetooth iBeacon event model.

It’s probably sufficient to look at how one single operation is implemented since the others follow the same pattern. I’ll look at startMonitoring(), which I described in the previous section.

If you take a look at the usage example again you’ll see that I get some immediate status as to the initialisation of the scan for advertisements in the variable “foo” and subsequently the “data” argument of the beaconCallback() function will contain the result of the scan.

You have to provide some JavaScript “glue” first for any function or property that you implement.

code 6

Much of this is boilerplate code (see here for this code in GitHub), setting up the “success” and “fail” call-backs and thee plumbing to handle the synchronous and asynchronous aspects of the function call. The exec() call makes a call to the next level of the “glue” layer that is shown in the image below.

code 7

The actual call into native code is made in the fragment above (see here for this code in GitHub) – again pretty much boilerplate code where a PluginResult() object is obtained and a reference to it saved for later when the asynchronous operation returns. The actual call to native code is made using the object returned from simpleBeaconPlugin.getInstance().

Once you drop into native code you have to call the appropriate method based on the name of the function you’re calling represented as a character string – something like this in the image below (see here for this code in GitHub), which calls the appropriate method on an instance of a class the template has provided for us.

code 8

In essence this method is quite simple – all it does is call bt_le_add_scan_device()which starts the process of scanning for Bluetooth advertisements from any Bluetooth device address (BT_LE_BDADDR_ANY) and return the appropriate JSON to the caller indicating whether the operation was initiated correctly or not. In the snippet below “writer” is an instance of Json::FastWriter — see here for this code in GitHub.

code 9

Thereafter, any matching device advertisement is presented to the plugin through a call-back that had been established earlier and the advertising frame parsed in parseBeaconData()—click here to see the actual code on GitHub.

Parsing the actual iBeacon data in the advertising frame involves some bit-stuffing but in principle it’s quite straightforward: locate the Manufacturer’s field in the frame, ensure that the Manufacturer’s field contains a flag identifying its contents as a iBeacon data, and then extract the iBeacons attributes from the rest of the field.

Once that’s done return the appropriate JSON to the caller with the iBeacon attributes using Json::FastWriter.

code 10

The Sample Application

Finally let’s take a quick look at the sample application that I’ve packaged with the Plugin in GitHub to see how it uses the plugin — click here to see it on GitHub.

The user interface is fairly basic with a couple of buttons to start and stop monitoring form iBeacons, a static area to show the most recent iBeacon event received and a log area to show any activity related to newly discovered or lost iBeacons.

code 11

The first challenge in an application like this is that it’s effectively servicing a time-sequenced stream of events (iBeacon advertisements). You could handle these yourself in a fairly brute-force way but I like to use a small functional reactive programming (FRP) library for JavaScript called Bacon.js – have a look at the API reference and tutorial here: https://baconjs.github.io/ .

I won’t go through Bacon.js in detail since you can put it on your reading list if you don’t already know anything about it; rather I’ll just talk through a couple of the simple code snippets that use it and are in the sample application.

In essence Bacon.js allows you to manipulate time-sequenced event streams as first-class objects. That is you can manipulate then in just the same way as, say, integers and strings. Let’s take a look – the code below can be found in GitHub here:

code 12

This is the JavaScript code that processes iBeacon events from the plugin. Notice though that I do nothing with the event other than push it onto a Bacon.js object called beaconStream; this represents an event stream and I’ll process this elsewhere in the application. In fact the code fragment below shows the definition of beaconStream (an instance of Bacon.Bus()) and how it’s used – have a look on GitHub here.

The first thing I want to do is create another event stream that contains only those iBeacon events that represent newly discovered iBeacons. This means that I have to remember what ones I have seen before and when I last saw it. This information is maintained in the associative array beaconList.

The new event stream is called discoveredBeacons and the code fragment below shows how this is defined. In essence if I’ve seen the iBeacon before I remove the iBeacon event from the discoveredBeacons event stream and if it’s new I add it to beaconList and add it to the discoveredBeacons event stream.

That’s all there is to it!  Now I have two event streams: one representing all iBeacon events and one representing newly discovered iBeacons.

code 13

The next thing I want to do is determine when an iBeacon has gone out of range. For the sake of this example I’ve arbitrarily used an interval to 20 seconds of “silence” to represent this – it would probably be a different value in the real world but this sample is for educational purposes.

code 14

In Bacon.js you model almost everything as an event stream, so I create another one called lostBeacons – it’s here on GitHub. See if you can understand how it works.

Every 10 seconds (I really ought to make this more event driven but that’s a task for later) I check to see if any iBeacons I know about haven’t been seen for more than 20 seconds. If so I delete it from beaconList and emit an event representing the lost beacon.

It’s easy to use these event streams to update the user interface of the application. The code fragment below shows how I do this – see here on GitHub. It should be fairly self-explanatory.

As an exercise, take a look at the additional event stream I’ve created, but not described – the one called movedBeacons. I’ll leave it to you to figure out how I created a Bacon.js event stream representing a proximity measure for iBeacons that would trigger as I walked towards and away from an iBeacon.

code 15

Well, that’s about it! A Bluetooth iBeacon Cordova Plugin using Bacon.js as a way of handling streams of events which is one of the patterns that needs to be mastered when working in the world of the Internet of Things.


I’ve released v1.0.0 of the SimpleBeaconPlugin plugin containing the features described in this article and so you can download, review and reuse the full source code – you can find the URL in the “Resources” section below. I hope this has been interesting and will help set you on your way developing real-world event driven Bluetooth applications for Blackberry 10.

Please feel free to contact me, @jcmrim, via Twitter if you need any help on anything Bluetooth Smart.


BlackBerry Bluetooth LE Developer Resource Index Page









John Murray – @jcmrim

1 day ago
Developing Secure Camera for iOS Secure Work Space


BlackBerry Secure Work Space (SWS) is a containerization solution, which allows enterprises to manage iOS and Android devices. SWS essentially extends BlackBerry security to protect corporate data at-rest as well as data in-transit through the global and secure BlackBerry Infrastructure. Apps in SWS are secured and separated from personal apps and data, providing IT departments the capability to manage a BYOD environment.

SWS Defaults Apps, Partner Apps, and In-House Apps

BlackBerry SWS for iOS and Android includes an integrated email, calendar, and contacts app, an enterprise-level secure browser, a secure document viewing and editing app, and Work Security ID to connect with RSA Soft Token security. Since the announcement of SWS with BES10, our enterprise app catalogue has grown rapidly, offering more trusted apps than any other MDM vendor. Many popular and essential enterprise apps are available for users to download such as Box, Harmon.ie, and WebEx. A full list of apps is available on Enterprise Mobility Marketplace for SWS.

SWS also enables enterprises to develop and deploy secure in-house apps that meet their own set of requirements to protect sensitive business information, and prevent data leakage. The data within the “work space” cannot be copy/pasted, forwarded, offloaded or accessed outside the work space.

All apps deployed in SWS are to be wrapped as shown in a diagram below:

wrapping diagram

Wrapping an app will secure and encrypt its local data, and facilitate the management of the app. After an app is wrapped, standard network and system calls are intercepted and replaced with secure calls from SWS libraries. For more details of the app wrapping process is described on this blog here.

Developing a Secure Camera App for iOS

We recently developed sample secure camera apps for Android and iOS to show case how to take confidential photos and securely store and share via email in SWS. A secure camera app can be useful in enterprise space to protect sensitive images and prevent data leakage.

To deploy a camera app in SWS on the iOS platform, the app doesn’t need to be rebuilt or require additional source code. However, there are some design considerations to handle images securely. Non-secured camera apps usually store images to “Camera Roll” or “Photos” allowing other apps to access the images via Photo Library. When the camera app is wrapped and deployed to SWS, users won’t be able to save images to the shared photo library. We designed the secure camera app to store images to its local data storage so that images are encrypted, not accessible by other apps, but can be emailed securely as an attachment via Work Connect, . When the app is deleted, all images are removed from the device.

Here are the steps with code snippets:

Step 1: Invoke a built-in camera to take a photo and store the image locally. The photos are not accessible by Camera Roll or Photos on the personal side.

code 1

Step 2: Present a list of previously taken photos in the app’s data storage.

code 2

Step 3: Display a photo via UIImagePickerConroller class

code 3


Step 4: Use “Open In” to transfer the currently viewing photo to Work Connect. When the app is deployed in SWS, Work Connect will be available. For details on how to use UIDocumentInteractionController class, refer to Document Interaction Programming Guide.

code 4

After building the secure camera app using Xcode, the app must be wrapped, resigned and deployed to SWS via BES. The details of resigning and deploying iOS apps are described hereSWS is also compatible with iOS8. Once the app is installed in SWS, you should be able to take photos and share them securely without the images being visible on the personal side.

The following screens show when running the secure camera app in SWS.

image 1

Left: Images are listed within the Secure Camera app

Right: Images are not listed from the Photos app


image 2

Left: Preview an image

Right: When users tab “Open In”, Work Connect is displayed

You can download the complete iOS secure camera sample as well as Android sample from the Secure-Work-Space project on BlackBerry’s GitHub.

3 days ago

Create a site like this for your own group.
Take a Tour or Sign Up



May 2015
« »
Mon Tue Wed Thu Fri Sat Sun
27 28 29 30 1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 31

BlackBerry Enterprise Developers Kenya

Powered by GroupSpaces · Terms · Privacy Policy · Cookie Use · Create Your Own Group