A header image for Merged BlackBerry Native documentation.

Native documentation revisited

Published: March 31st, 2015

Read the documentation

Check out the new and improved Native website

We have merged the Core and Cascades documentation and removed the focus controller between the two sets of documentation. One BlackBerry 10 Native SDK! One set of documentation to teach you everything you need to know!

What does this mean?

The old Cascades and Core documentation focus controller in the header is gone! Everything is in one place on the Documentation tab. That doesn't mean that anything has disappeared though.

Screen shot showing the focus controller.

Screen shot showing the radio buttons on the Sample apps page.

You can still navigate in the API Reference by using the Cascades and Core radio buttons.

And you can still filter your favorite Sample apps to see only Cascades or Core sample apps.

Screen shot showing the radio buttons on the Sample apps page.
Image of the disqus logo.

Unfortunately, the complexity of this change to our site means that some Disqus comments are no longer available. If you've left a comment, you might find that trying to access the page with that comment generates a "Page not found" error. For more information, see our Disqus FAQ.

Where did the documentation go?

It's all still there, but language-specific details appear in tabs. You can find information about how to add functionality to your app, plus code samples in QML, C++, and C.

Screen shot showing the tabs.

We merged the Core and Cascades content in many places. For example, everything you want to know about using the camera in your app is all in one place.

All of the information that you need appears here in this documentation or the topics that it links to. We describe general concepts and tasks that you might want to do in your app. Then we get into details with code samples.

The Cascades code samples are in the QML and C++ tabs, and code samples that previously appeared in the Core documentation now appear in the C tab. One of these tabs is selected when you land on a page, and this tab is called the active tab. You don't have to go to two separate places to find out how to add camera features to your app. The code samples provide equivalent or nearly equivalent ways of doing tasks in each language.

Here's an example:

Screen shot showing the Trigger photo capture documentation that includes tabs.

How do I find anything?

The following categories will help you find the documentation that you need:

Getting Started

Screen shot showing a set up image.

This section hasn't changed very much. But you may want to check out the tutorial to create your first Cascades app. It's been updated to work on all BlackBerry 10 devices, and it's a good place to start if you want to learn about design units and asset selectors.

Development Fundamentals

This is where you'll find all of the basics that you need to know, including Cascades fundamentals and Using low-level functionality (if you love to code in C). Don't forget to check out Device characteristics to make sure that you're designing your app for all BlackBerry 10 devices.

Creating User Interfaces

Screen shot showing the Cascades logo.

Here's where you'll find out about your favorite Cascades controls. The documentation is the same but better because there are more code samples in both QML and C++ throughout.

Best Practices

These best practices will help you design apps that optimize performance and accessibility. Don't forget to follow the best practices for handling Personally identifiable information in your apps.

Gaming and Porting

Screen shot showing the Core logo.

Here's where you'll find everything you need to know about porting your apps and games from other platforms. You can also develop a game from scratch or use a third-party development framework such as Unity. Don't forget to add support for game controllers and gamepads.

Graphics & Multimedia

This set of documentation has expanded to include more details about adding graphics, audio, video, and camera features to your app.

Device & Communication

Screen shot showing the blue rotating cube of the Good Citizen sample app.

We've merged the documentation from Cascades and Core to give you the highlights for communicating with devices. The biggest change is in the Input methods documentation where you'll find out how to implement every kind of input method for every BlackBerry 10 device.

Platform Features

Here's where you'll find platform features that you can incorporate into your app. Check out the BlackBerry Hub integration documentation to learn how to use the Unified Data Source (UDS) library to add data from your app directly to the BlackBerry Hub.

Are you sure that it's all there?

Screen shot showing the old layer image with the Cascades and Core focus controllers.

Yes! And there's even more! Where it's possible, we've added code samples in QML, C++, and C. Where it's not possible to complete the task in a particular coding language, you'll see Not applicable. If we're still working on updating the code samples, you'll see Coming soon.

The QML and C++ code samples typically use Cascades APIs. The C samples use C APIs. But don't forget that you can use C APIs in your C++ code as well. Check out the BlackBerry Platform Services documentation for useful techniques. And don't forget to try the Using BPS tutorial to learn how to use C APIs in your C++ app.

Now you can have your cake and eat it too!