Skip to content
This website uses cookies. By continuing to browse this site you are agreeing to our use of cookies. Find out more on our cookie page. ×
  • BlackBerry Developer
  • Useful links
  • Blog
  • YouTube
  • Forum
  • Signing
  • Login
  • Register

Would you like to tell us how we are doing?

You bet No thanks
Native SDK for BlackBerry 10
Release Notes for SDK
  • Downloads
  • Sample apps
  • Documentation
  • Reference
Oops, it seems like you're using an old browser that we do not fully support. If you're able to, please upgrade your browser here. ×
This website uses cookies. By continuing to browse this site you are agreeing to our use of cookies. Find out more on our cookie page. ×
Native SDK for BB10
  • Downloads
  • Sample apps
  • Documentation
  • Reference
  • Release Notes for SDK
A header image for the UDS library.

Featured library: Unified Data Source

Published: October 21st, 2013

View the documentation

Add your app data to the BlackBerry Hub

Integrating your app with other apps on a BlackBerry 10 device, to give users quick and easy access to your app's data, is a key principle of BlackBerry 10 development. This week, we take a look at the Unified Data Source library and how you can use it to give your app (and its data) some extra visibility.

The Unified Data Source (UDS) library is sometimes called Hub Integration, and that's a good name for it. This library, which uses C, lets you add data from your app to the BlackBerry Hub. You can add, update, and remove custom entries that represent any data from your app that you want to display in the BlackBerry Hub. You could add alerts for events that affect your app (such as available updates), or you could simply provide another location for users to access the data in your app, without having to actually open your app at all.

Elements of the UDS library

The library is built by using several key elements, each of which can help you organize and manage the items that you add to the BlackBerry Hub:

Screen showing the BlackBerry Hub.

Accounts

An account represents a grouping of related items that can be displayed together in the BlackBerry Hub. If you open the BlackBerry Hub on a device, you'll notice that there are already some accounts that are predefined, such as "Notifications", "BBM", and "Text Messages". These accounts appear as tabs in the BlackBerry Hub, and you can add your own accounts to this list.

Inbox list items

An inbox list item is an individual item that appears in an account in the BlackBerry Hub. You can add data from your app as inbox list items, and you can associate these items with accounts in the BlackBerry Hub so that they're displayed on that account's tab.

Categories

A category is a grouping of items within an account. You can use categories to sort and filter inbox list items in the account. For example, a messaging account might contain folders for different types of messages, and each folder is considered a category.

Account actions

An account action is an option that users can select when they view a particular account in the BlackBerry Hub. Account actions can appear in the action bar at the bottom of the screen, in the overflow menu, or in both locations.

Inbox item actions

An inbox item action is similar to an account action, but applies to the inbox list items that appear within an account in the BlackBerry Hub. Inbox item actions appear in the context menu when a user presses and holds an inbox list item.

Give me some examples, already!

Knowing how the UDS library is structured is a good place to start, but what are some typical situations where you might want to add your app's data to the BlackBerry Hub?

  • A messaging app: Create an account in the BlackBerry Hub that represents your messaging app, and then add any new messages or conversations to that account as inbox list items. Your users see new message notifications for your app's account when they view the BlackBerry Hub, and they can access the messages right away.
  • A game: Use an account in the BlackBerry Hub to let users know that information about your game has been changed or updated. You could alert them that someone beat their high score, or let them know that their friends are online and waiting for them to join the game.
  • A productivity app: Make sure that users never miss an important entry in your app by adding reminders to an account in the BlackBerry Hub. You might remind users that their taxes are due, or prompt them to set aside their monthly contribution to their retirement fund.

To get started with the UDS library, check out the documentation in the API reference.

Momentics IDE 2.0 is here!Training for Native Developers

Archive

  • Native documentation revisited
  • 3.0 Gold plug-in for Visual Studio
  • Featured sample: Belt
  • 10.3.1 Gold is here!
  • That's so Classic!
  • Static asset selection
  • Get on the grid
  • Design units in 10.3
  • Momentics IDE 2.1 Gold is here!
  • Networking 101
  • Plug-in for Visual Studio is Gold!
  • Lights, sounds, previews!
  • New on the Dev Blog - January 2014
  • Updates to start off the New Year
  • Money, money, money!
  • We want your feedback!
  • New plug-in for Microsoft Visual Studio
  • Dev Blog - Blast from the past
  • Featured API: String pattern registry
  • New on the Dev Blog - October 2013
  • Momentics IDE 2.0 is here!
  • Featured library: Unified Data Source
  • Training for Native Developers
  • What's new on the Developer Blog
  • Do you read the release notes?
  • Featured sample: XandOs
  • Featured library: Cocos2D-X
  • Featured API: Identity Service
  • Updates in 10.2 Gold
  • Analyze your apps using profiling
  • Featured sample: Pull My Beard

Technologies

  • Native
  • HTML5
  • AIR
  • Android
  • PlayBook
  • BlackBerry OS

Programs

  • Partner Program
  • Academic programs
  • Developer groups
  • BlackBerry 10 Dev Alpha
  • Built for BlackBerry
  • BlackBerry Builder

Support

  • Code Signing Help
  • YouTube Channel
  • Developer forums
  • Knowledge Base

BlackBerry World

  • Sign your app
  • Submitting your app

Follow us on:

  • Facebook
  • YouTube
  • Twitter
  • BlackBerry Blogs
  • BBM Channels
BBM Channels

BBM Channels

Developer Relations is on BBM Channels! Join the conversation by signing up for the beta program and scanning the barcode to the right.

Register for BBM Channels beta ›
  • Legal & Trademarks
Copyright © 2021 BlackBerry Limited, unless otherwise noted.
  1. 1. Download the tools

    Before you start developing, you'll need to visit the Downloads tab. Here you'll find downloads for the BlackBerry 10 Native SDK, BlackBerry 10 Device Simulator, and some other useful tools.

  2. 2. Try the sample apps

    Now featuring a filter control, the Sample apps tab allows you to search for samples by name or by feature.

    Select either the Core or Cascades radio buttons to display the samples relevant to you.

  3. 3. Educate yourself

    The Documentation tab contains tons of examples, tutorials, and best practices to guide you along the path towards building an awesome app.

    You can access all the documentation that you need in the left-hand navigation.

  4. 4. Start developing

    The Reference tab is where you'll find essential details about how to use our APIs.

    You can use the left-hand navigation to choose how you would like to browse the reference: by module, by topic, or alphabetically. If you have an idea of what you are looking for, start typing it in the Filter box.