These release notes apply to an earlier version of the software and the corresponding documentation. Some links may no longer be active.

Native SDK 10.1 Beta Release Notes

This document contains the following sections:

Upgrading to 10.1 beta

When upgrading to version 10.1 of the SDK, it's recommended that you remove all previous versions of the Native SDK before upgrading to the latest version.

You can download the beta version of the Native SDK from the BlackBerry 10 Beta Downloads page page.

New in this release

See also: Changes in this release

APIs

  • Geocoding - You can use the Geocoding APIs to determine geographic coordinates when given a location or determine a location when given a geographic coordinate (reverse geocoding). To find out more, see Geocoding Library.

Advertising Service

Documentation

  • Bluetooth Developer's Guide - Detailed information on how to use the Bluetooth capabilities can be found on the Communication page.
  • Create the Gamepad application - Tutorial on how to use the Screen and Windowing Library to process game controller and joystick events from devices using the Bluetooth Human Interface Device (HID) profile. Find the tutorial at Tutorial: Create the Gamepad application.
  • Monetization Guide - Learn about the options, strategies, and techniques you have to monetize your app on the BlackBerry 10 platform. Detailed information can be found at Monetization.
  • Near Field Communication (NFC) Developer's Guide - Added a section called Contactless registry service (CRS) considerations to describe use of an API function in a scenario involving a Universal Integrated Circuit Card (UICC) with a CRS applet. Detailed information on how to use the near field communication (NFC) capabilities can be found at Contactless registry service (CRS) considerations in the Near Field Communication Developer's Guide.
  • Sensor Developer's Guide - Detailed information on how to use the BPS library to access data from device sensors can be found at Sensor Developer's Guide.

MD5 Checksum validation

We've added the ability to validate the BlackBerry 10 Native SDK installer download using this checksum file. Use any checksum tool that supports MD5 to validate that your download is correct.

Back to Top

Changes in this release

Multimedia Library

  • Added an explanation of how to configure audio devices such as microphones in the input URL to the mm-renderer documentation.
    The mmr_input_attach() method description now lists the many options you can set in URLs beginning with either snd: or audio: to configure microphones when recording audio. The Recording audio data section now explains that the sample code shown not only selects but also configures a microphone when specifying a snd: URL for the input.
  • Fixed the following in the documentation:
    • Previously, the description of the supported URL types incorrectly stated that input URLs beginning with audio: were valid for all three input types. Such URLs are valid for only the track and autolist input types. The documentation has been corrected to explain this design.
    • For input URLs beginning with snd: or audio:, you can set many options to configure the audio capture device (microphone) targeted by the URL. The settings for these options are given as key-value pairs at the end of the URL, following the question mark (?) symbol. One of the supported options is frag_ms, which specifies the fragment size, in milliseconds. Previously, the frag_ms option was not given in the list of supported URL options. The documentation on input URLs now includes this option.
    • For playlist input types, URLs naming M3U files can be used with or without a file: or http: prefix. This flexibility in specifying URLs to playlists is now explained.

Near Field Communication Library

  • nfc.h
    • Removed the following:
      • nfc_bluetooth_handover_data_t
      • nfc_get_bluetooth_handover_data()
      • nfc_get_handover_transport()
  • nfc_types.h
    • Added new enumerations for Trusted Service Manager Proxy States:
      • typedef enum {
        	TSM_PROXY_STATE_IDLE                        = 0,
        	TSM_PROXY_STATE_WAITING_FOR_CONNECTIVITY    = 1,
        	TSM_PROXY_STATE_FETCHING_COMMANDS_FROM_TSM  = 2,
        	TSM_PROXY_EXECUTING_COMMANDS                = 3,
        	TSM_PROXY_ATTEMPTING_TO_CONTACT_TSM         = 4,
        } tsm_proxy_state_t;
        					
        				
    • Added new third-party NFC tag types:
      • TAGVARIANT_ST_LRI_1K
      • TAGVARIANT_ST_LRI_S2K
      • TAGVARIANT_ST_LRI_S64K
    • Removed the following:
      • SERVER
      • CLIENT
      • SERVER_PASSIVE

Screen and Windowing Library

  • Added new on-screen drawing/handwriting support:
    • Added new window properties:
      • SCREEN_PROPERTY_BRUSH - A pixmap that contains the brush to be used
      • SCREEN_PROPERTY_BRUSH_CLIP_SIZE - A pair of integers that define the width and height, in pixels, of a clipped rectangular area within the window buffers where brush strokes are allowed to be drawn
      • SCREEN_PROPERTY_BRUSH_CLIP_POSITION - A pair of integers that define the x- and y- position of a clipped rectangular area within the window buffers where brush strokes are allowed to be drawn
    • Added new sensitivity masks:
      • SCREEN_SENSITIVITY_MASK_POINTER_BRUSH
      • SCREEN_SENSITIVITY_MASK_FINGER_BRUSH
      • SCREEN_SENSITIVITY_MASK_STYLUS_BRUSH
  • Added a new device property:
    • SCREEN_PROPERTY_MAXIMUM_TOUCH_ID - A single integer that indicates the index of the highest possible touch ID
  • Added a new window property:
    • SCREEN_PROPERTY_TRANSFORM - A set of integers that represent the transformation matrix used to convert buffer coordinates to display coordinates

Security Builder Engine

  • Added instructions for complying with FIPS 140-2 by using only accepted protocols and cipher suites.
Back to Top

Fixed in this release

APIs

260503

When writing an NFC tag with a smart poster NDEF message, calls to API functions such as nfc_set_sp_uri and nfc_add_sp_title produced errors.

BBM Social Platform

286953

When you called bbmsp_user_profile_box_retrieve_icon() to obtain the profile box icon that was registered with BBM Social Platform, the icon was not retrieved.

Installation

257540

Installing the Native SDK or simulator failed on a Mac when the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 7 were already installed.

QNX Momentics Tool Suite

261254

In the Device Log view, if you filtered logs by severity, and then changed the severity filtering, the IDE did not display the updated logs.

Back to Top

Known limitations

APIs

  • There is a slight delay between tracks played as part of a playlist (approximately 0.5 seconds), even when the playlist includes only one track that is repeating.

BBM Social Platform

  • When a C-only app uses the BBM Social Platform BPS APIs, the compiler requires additional non-C libraries to be added manually (libQtCore and libcpp).

General

  • Applications using FreeType must add the following include path: $QNX_TARGET/usr/include/freetype2

Installation

  • By default, the Native SDK installer creates the installation folder on Windows systems at the root of the C drive (for example: C:\bbndk). To install to the default installation folder on Windows 7, you must log in as a user who has administrator privileges. If you cannot log in as a user with administrator privileges, you must change the installation folder to an alternate folder that you have write access to.
  • When installing and uninstalling the Native SDK on a 64-bit Linux host computer, you may see an error regarding a missing libc.so.6 file. You can disregard this error message.
  • To run the installer and the IDE on Ubuntu 64-bit, you need to install the 32-bit libraries: sudo apt-get install ia32-libs. During the installation, answer yes to all the questions.
  • On Linux and Mac computers, the installer might crash when launching with an error similar to the following: "An internal LaunchAnywhere application error has occurred and this application cannot proceed." Unset the PS1 variable and restart the installation program to continue.
  • On Mac computers, you may encounter an issue with incorrect permissions on the Native SDK installer executable. To launch the installation program, you will first need to manually change the permissions for the installer.
  • When you execute bbndk.sh to launch the Native SDK on Ubuntu 11.04 32-bit, you might receive an error:
    "QNX Compiler Configuration Error".
    As a possible fix, update Ubuntu to the latest package by using the Update Manager utility. In addition, ensure your VMware version is up-to-date.

OpenAL

  • The OpenAL 1.1 Specification and Reference incorrectly states that the function alcCloseDevice() will fail if the device's contexts and buffers have not been destroyed. alcCloseDevice() actually destroys any contexts and buffers still associated with the device.
  • The function alcGetIntegerv() does not throw an error when retrieving ALC_MAJOR_VERSION and passing an invalid device pointer.
  • The function alcGetString(device, ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER) throws an error when invoked after the device has been closed. It should return the default device and ignore the device parameter.
  • The OpenAL 1.1 Specification and Reference incorrectly states in the description of the function alcGetString(), "Specifying NULL for deviceHandle when asking for ALC_EXTENSIONS will generate an ALC_INVALID_DEVICE error." In fact, no error is generated.
  • The OpenAL 1.1 Specification and Reference incorrectly states in the description of the function alBufferData() that, "An invalid size will result in an AL_INVALID_VALUE error." In fact, calling alBufferData() with an invalid size does not cause the INVALID_VALUE error.
  • When the function alcMakeContextCurrent() is called with an uninitialized ALCcontext pointer, it correctly returns ALC_FALSE, but does not generate an ALC_INVALID_CONTEXT error.
  • The OpenAL Programmer's Guide - OpenAL Versions 1.0 and 1.1 incorrectly lists AL_INVALID_VALUE as a possible error returned by the functions alGenBuffers() and alGenSources() when the array is not large enough to hold the number of items requested. In fact, no error is generated.
  • The function alSource3f() does not throw an AL_INVALID_VALUE error when invalid numbers are passed as parameters. Apps should perform their own validity checking.
  • The function alSourcef() throws an AL_INVALID_VALUE error for valid values when using AL_CONE_INNER_ANGLE and AL_CONE_OUTER_ANGLE.
  • No error is thrown when the function alutLoadWAVFile() is called without a current context.
  • The function alutGetError() does not return ALUT_ERROR_ALC_ERROR_ON_ENTRY when there was already an ALC error on entry to alutLoadMemoryFromFileImage().
  • In the OpenAL Programmers Guide, AL_DATA is incorrectly documented as a valid buffer property. An attempt to retrieve this property through alGetBufferi() and alGetBufferiv() will result in an AL_INVALID_ENUM error.
  • The deprecated function alutLoadWAVMemory() does not return the expected values.
  • The function alGetListenerfv() does not generate an error when called with an invalid value. Apps should perform their own validity checking.
  • The following attributes are set by the device, and cannot be altered using the attribute list of the function alcCreateContext(): ALC_FREQUENCY, ALC_REFRESH, ALC_SYNC, ALC_MONO_SOURCES, ALC_STEREO_SOURCES, ALC_MAX_AUXILIARY_SEN.
  • The OpenAL 1.1 Specification and Reference incorrectly states that the function alGetEnumValue() sets the error code AL_INVALID_VALUE if the specified enumeration cannot be found. In fact, this error is not set when an invalid enumeration value is specified.
  • The OpenAL Programmer's Guide - OpenAL Versions 1.0 and 1.1 incorrectly states that the functions alcSuspendContext() and alcProcessContext() produce the error ALC_INVALID_CONTEXT when called with a null or destroyed context. However, no error is generated.
  • The function alListener3f() does not generate an error when called with a NULL value for the AL_VELOCITY attribute. Apps should perform their own validity checking.
  • The function ALCGetProcAddress() does not return addresses for the specified context extension functions, even for valid functions. It always returns NULL.
  • The function alSourceQueueBuffers() queues invalid buffers. If you pass a NULL buffer to this function, it will queue the buffer and not raise an error, even though the buffer is not valid.

OpenSSL

BlackBerry 10 uses OpenSSL 1.0.1, with the following deviations from the standard implementation:

  • TLSv1.2 is not supported.
  • The heartbeat TLS extension has been disabled. This extension is described by RFC 6520, which is located at http://www.rfc-editor.org/rfc/rfc6520.txt.
  • The list of default SSL/TLS/DTLS ciphersuites has been altered.
    • Applications using SSL/TLS/DTLS connections to get a default set of ciphersuites unless they explicitly specify which ciphersuites they want to support using SSL_CTX_set_cipher_list() or SSL_set_cipher_list().
    • The default set of ciphersuites has been changed to "ALL:!aNULL:!eNULL:!SRP:!SSLv2" which eliminates the SRP ciphersuites from the standard default set of ciphersuites provided by OpenSSL 1.0.1.
  • TLSv1.1 support is disabled by default.
    • SSL_CTX_new(), which is used to create a new SSL_CTX object for TLS/SSL/DTLS negotiations, has been altered to disable TLSv1.1 support by automatically setting the option SSL_OP_NO_TLSv1_1.
    • TLSv1.1 will be disabled by default when using SSLv23_method(), SSLv23_server_method(), or SSLv23_client_method(). Applications that need TLSv1.1 support can clear the option by calling SSL_CTX_clear_options(ctx, SSL_OP_NO_TLSv1_1) or can use one of the following TLSv1.1-only methods: TLSv1_1_method(), TLSv1_1_server_method(), or TLSv1_1_client_method().

Scoreloop

QNX Momentics Tool Suite

  • When you use the Memory Analysis tool, you may see an empty graph with the warning "No graphical input". This is by design for security reasons and this information is unsupported for BlackBerry 10 OS targets.
  • Standard makefile projects cannot be named "makefile". Use a different name for your project.
  • Memory leaks are only reported when an application exits normally. If it is killed or crashes, memory leaks will not be reported. To report memory leaks in this case, the API should be used.
Back to Top

Known issues

This section lists known issues for the BlackBerry 10 Native SDK, version 10.0.9 Gold.

APIs

290059

Drivers on the Dev Alpha C devices are not fully compatible with Bluetooth low energy functionality available with BlackBerry 10. For this reason, you may experience stability issues and you may see calls to Bluetooth low energy APIs fail.

282627

Several core native APIs are used across different products and require privileged access. As such, you may notice that privileged or root access is required in some API documentation. For application development, the BlackBerry OS does not provide you with privileged access as it is a secure platform and therefore, you cannot use these privileged capabilities. The API capabilities that do not require privileged access are sufficient for the use cases required for your app.

220328

You cannot peek through cards correctly when the device is in landscape mode.

204691

If a file's permission is changed to write and invocation is performed, the target application does not get invoked.

BBM Social Platform

275822

In the BlackBerry 10 Device Simulator, if you connect to BlackBerry ID through BlackBerry World, and then connect to BlackBerry Messenger, the simulator stays locked in a connecting state.
Workaround: Connect to BlackBerry Messenger before connecting to BlackBerry World or, while BlackBerry Messenger is locked in a connecting state, go to Settings > BlackBerry ID, and then login to BlackBerry ID.

271425

Images that use transparency might not appear correctly in the user's list of BBM applications.

261200

When BBM Connect (Settings > Security and Privacy > Application Permissions) is toggled from ON to OFF or from OFF to ON the registration and permission states are not updated.

218238

If BBM Connect (Settings Application > Security and Privacy > Application Permissions) for an app is turned off before launching the app, toggling BBM Connect doesn't update the registration status of the app.
Workaround: Turn BBM Connect on before launching the app.

Device

238032

The notifications area of the Hub will constantly flash the red LED when a notification such as entering Development Mode is sent.
Workaround: Wait until the blinking times out after 10-15 minutes OR turn LED off in Settings.

Documentation

We are hard at work creating an awesome UI experience for you! While we are doing this, some references to the BlackBerry 10 UI, including screenshots, may not reflect what you see in the current software.

The documentation that is installed with the BlackBerry 10 Native SDK and available from the QNX Momentics IDE may not be the most recent version. For the latest versions go to http://developer.blackberry.com/native/documentation/bb10/.

In previous releases, the most recent version of the BlackBerry Platform Services library (libbps) was bundled with the Native SDK. This version was newer than the version on the target OS. To ensure the correct BPS library version was used by applications at run-time, projects in the Native SDK 1.0 would:

  • Use BPS headers from the $QNX_TARGET/../target-override location for compilation,
  • Link the libbps.so from the $QNX_TARGET/../target-override location to generate the application executable, and
  • Package the libbps.so from the $QNX_TARGET/../target-override location in the BAR.

As of the Native SDK 2.0.0 release, BPS no longer resides in the target-override location. The BlackBerry 10 OS and BlackBerry 10 Native SDK versions of this library are in sync. If you have applications targeting BlackBerry 10 that you no longer wish to support on PlayBook 1.0.x, you should remove the libbps.so.1 asset from bar-descriptor.xml and target the BlackBerry 10 version of the Native SDK. To verify, select the QNX page in the project properties dialog. Otherwise, packaging of the BAR file will fail because it will not be able to find the libbps.so file to include in the BAR.

Installation

261783

When you run the BlackBerry Native SDK installer on Windows 8, you cannot create a shortcut in the Start menu.
Workaround: You can use options in the installer to create shortcuts on the Desktop and the Quick Launch bar.

257734

When updating the QNX Momentics IDE using the Update Manager, you receive the following message: "Warning: You are installing software that contains unsigned content. The authenticity or validity of this software cannot be established. Do you want to continue the installation?" This message is expected. Accept to continue with the update.

239960

Installing the Native SDK into the same folder as a previous version is not supported. Uninstall the previous version before installing the new version.

170950

The Native SDK Installer does not create an icon on the Dock for Mac OS X Mountain Lion, version 10.8 but the application is still properly installed.
Workaround: Run the bbndk command file from where the Native SDK is installed.

144987

When you uninstall the Native SDK on Mac or Linux, you might get a warning that some files are not removed. This can be ignored and you can manually delete the remaining files.

115276

On Linux systems, if the launch command contains "..", the Native SDK installer fails.

110605

You might get a warning after uninstalling the Native SDK that some directories couldn't be removed. This can be ignored.

97829

The installer provides recommendations on the space required to install the Native SDK. The number may be low and should 4 GB. For more information, see the system requirements.

QNX Momentics Tool Suite

In the bar-descriptor file, the <action> element used in previous versions of the Native SDK has been changed to be used with the Invocation Framework. The <permission> element has been reinstated for use to control permissions for an application. If you need to add permissions to your <action> application, you must change it to use the <permission> element. For more information, see The application descriptor file DTD.

287272

A previously signed BAR file is removed when a new BAR version is created using the BAR export.

286073

Don't set Required Platform in the bar-descriptor to BlackBerry OS 10.0.10.xxx as the application will not deploy on a 10.0.9.xxx device. Use the default Current SDK Target setting instead.

276767

In a Windows environment, uninstalling the IDE does not remove any SDKs installed using the update manager.
Workaround: Manually remove the SDKs from the installation directory.

273238

After building a project, the project may compile correctly but in some cases show header files as unresolved in the IDE editor. This is a result of unresolved symbols in the code.
Workaround: Manually set include paths.

269559

If you try to use the IDE while an SDK installation is running in the background, after the update completes, the dialog prompting you to restart is disabled.
Workaround: Force the IDE to restart.

268872

If you rename an existing project, the IDE does not prevent you from using special characters, spaces, or other invalid naming conventions.
Workaround: To prevent issues, you should avoid using special characters, spaces, and names that are shorter than 3 characters or longer than 25 characters.

262943

If you update the IP address of a BlackBerry Target and click OK without clicking Apply first, the IDE gives an error that it can't connect to the target. However, the IDE does connect.
Workaround: After updating the IP address, click Apply before clicking OK.

259875

The locked SDKs in the Update Native SDK wizard may not accurately reflect the SDKs you are using. Use care when uninstalling SDKs to ensure that you don't uninstall an SDK that you want to continue using.

259269

The IDE update manager does not show an error message if it cannot connect to the update site. Instead it indicates that there are no updates available.

258694

In a Linux environment, if you run the update manager and do not choose the options to switch to the newest SDK or to update the IDE, after the upgrade, the newest SDK is used by default.
Workaround: When you run the update manager, choose the option to update the IDE.

240577

Cancelling the BAR file signing process deletes a previously signed BAR file.
Workaround: Increment the app version before signing the BAR file for the second time.

239383

Postmortem debug is not available for shared libraries. The error message, "'Asynchronous viewer input update' has encountered a problem. An internal error was occurred." is displayed.

225372

Using GNU debugger, your debug session may break with an internal-error (for example, handle_inferior_event).

222155

The GNU debugger crashes when breakpoints are set and you switch from the Breakpoints tab to the Variables tab.

211332

The GNU debugger may not display the variable values in certain circumstances.

206368

If you debug an application with Windows XP, you may receive an error stating there was an "InvocationTargetException".
Workaround: Install the Microsoft Visual C++ 2008 Redistributable Package (x86).

201809

When debugging an OpenGL 2.0 project, the debugger may skip some breakpoints.

200419

It is possible that the debugger may take 5-10 minutes to launch in certain circumstances.

195895

If you try to launch an application in debug mode that is already running on the device, the QNX Momentics IDE may consume 100% of your CPU.
Workaround: Close the application on the device before launching it again.

187614

An application with many assets may timeout when trying to deploy.
Workaround: Try deploying over USB instead of Wi-Fi or reduce the number of assets in your application.

183905

When setting a project-specific SDK, the settings will only take effect the second time you build your project.

157697

A class containing a pure virtual function using variable arguments cannot be inherited virtually. The following error is generated: "generic trunk code fails for method 'virtual void Log::Logger::Debug(const char*, ...)' which uses '...'".

140310

When you create a project with a name that begins with a numeric value, you will see the following error: "Package ID is invalid". Project names cannot start with a numeric value and must start with a letter from a-z or A-Z.

121283

During debug sessions, watchpoints are not supported.

119766

If you launch Run Config and enable the Code Coverage tool, when you check Code Coverage Sessions, there is no coverage of shared and static libraries.

117556

While debugging the "GoodCitizen" sample project using the "Step Into" function, the debugger doesn't step into the handle_events() function. The debugger jumps directly to the update() function and steps into that function.

114986

When using Ubuntu 64-bit and registering with the RIM Signing Authority, you may receive the error "Error registering long term keys Error: null".
Workaround: Update the script at /bbndk-1.0/host/linux/x86/usr/bin/blackberry-keytool to include the line
"-Djava.security.egd=file:/dev/./urandom".

114742

Do not launch your application with the Application Profiler enabled in debug mode. This might cause the IDE to stop responding.

114071

During initialization, the MSYS.dll provided with the Native SDK will try to map network shares. If they are not available, then it will take as long as the network access timeout for each such mapped share for MSYS to start. This can lead to build times being slower if MSYS based utilities are used.

111911

To use the breakpoint command GNU Debugger (GDB) Command Action, you need to switch your debug framework to CDI. Click Run > Debug Configurations. Select your application, and on the Main tab, click Select Other at the bottom of the page. Select CDI Debugging Framework (Traditional) Launcher, and click OK.

111197

The Native SDK ships static libraries for most of the libraries of the platform. However, we recommend using shared libraries where possible to reduce your application footprint and to take advantage of bug fixes in the platform.

77220

If you use the Application Profiler with the Sampling method on a target, all threads must be bound to CPU 0 because the Application Profiler only checks samples for CPU 0.

Back to Top

Looking for release notes for previous releases?

You can find the release notes for previous releases on the following pages:



Last Modified: March 8, 2013

Added previous release note content: June 6, 2013

  1. 1. Choose your focus

    This is the focus controller. Use this controller to choose your primary development approach (Cascades or Core).

    By selecting a focus, you get to decide what content should be front and center on the site.

  2. 2. 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.

  3. 3. 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 check boxes to display the samples relevant to your focus.

  4. 4. Educate yourself

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

    The documentation for your preferred focus always appears at the top of the left-hand navigation, but you can still access the rest of the documentation at the bottom.

  5. 5. 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.