Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
205 lines (134 sloc) 7.28 KB

Release Notes

GA Release (3.1.2)

THURS AUG 15, 2013

  • Database.install Support
  • Platform.createUUID Support
  • GeoLocation.getCurrentPosition Support
  • Native Module Support
  • Updated and Integrated BlackBerry SDK into Documentation

Notes on Using 3.1.2

See the developer blog post at

Beta Release (3.1.1)

MON JUN 17, 2013

  • Alignment of BlackBerry SDK 3.2.0 to Titanium 3.1.1
  • BlackBerry SDK is now completely integrated into Titanium Studio and SDK (3.1.1)
  • Analytics
  • Geolocation
  • Filesystem
  • ScrollableView
  • Accelerometer

Notes on Using 3.1.1

See the developer blog post at

Beta Release (3.2.0.v20130412191647)

FRI APR 12, 2013 7:16:47 PM PST

  • Alloy Support
  • Node.js Based CLI Build Support
  • Titanium Studio 3.1.1 Updated to use Node.js CLI
  • API permissions are contained in tiapp.xml
  • Numerous Bug Fixes in preparation for Beta

Notes on Using new CLI

The older Python CLI will still work as previously, but BlackBerry now supports the newer CLI that the iOS platform uses. Below are some of the more common build commands.

To create a project:

	titanium create -p blackberry --id YOUR_APP_ID -n PROJECT_NAME -t app

To build and deploy to simulator:

	titanium build --platform blackberry -T simulator -A DEVICE_IP

To build and deploy to device:

	titanium build --platform blackberry -T device -A DEVICE_IP --debug-token PATH_TO_DEBUG_TOKEN/ --password DEVICE_PASSWORD

To build for BlackBerry World:

	titanium build --platform blackberry -T distribute --keystore-password STORE_PASSWORD --output-dir PATH_TO_SIGNED_BAR_FILE

The tiapp.xml configuration file has been extended to make it easier to edit applications settings, and the buildID that had previously be updated in the Ti.Manifest file is now updated through tiapp.xml. Below is sample of the BlackBerry extensions.


New Features in this Release (3.1.0.v20130320125153)

WED MAR 20, 2013 12:51:53 PM PST

  • Media - Audio and Sound Support including Data Streaming and File-system Data
  • Titanium Studio Console Logging Support
  • TextArea
  • ScrollView
  • Map Annotation
  • Tab Active Support
  • Locale Support

Notes on Upgrading BlackBerry Golden Release for Map Annotation Support

This release has added support for Map Annotations. For developers using the Golden Release build or prior builds there are a few important steps that must be followed to make sure your application builds and runs. This only applies to the BlackBerry 10 release not the BlackBerry 10 Beta.

  1. Download and install the latest BlackBerry SDK/NDK from

  2. Make sure to follow the instructions to upgrade the Golden Release builds. We have tested build but any later builds should be fine. The instructions are located at

  3. Download and install the simulator that matches the build number you downloaded. A list of simulators can be found at

  4. Edit the file so the QNX_TARGET matched the updated build for example QNX_TARGET_VERSION=${QNX_TARGET_VERSION:=10_0_9_2372}. You can find the file at the root of the BlackBerry NDK folder. On OSX it's typically /Applications/bbndk/, on Windows it's c://bbndk/bbndk-env.bat.

Notes on Application Orientation

By default your application is fixed in portrait mode. You enable you app to auto rotate to the device orientation add the following to the tiapp.xml file in the project directory:


The orientation element can be:

			- auto (allows full programatic control, empty orientation modes array = all orientations supported)
			- landscape
			- portrait
			- default (lock in the device's preferred orientation; phones -> portrait, tablets -> landscape)

Notes on Project Creation

When selecting multiple deploy targets, do not select Android. If Android is selected the BlackBerry project is not created. You can after project creation add Adroid using tiapp.xml.

New Features in this Release (3.1.0.v20130305173300)

TUE MAR 05, 2013 5:33:00 PM PST

  • Maps Support
  • Keyboard Type Support
  • Orientation
  • Support All Default Studio Templates
  • Relative CommonJS Support and Scoping
  • Overlapping Window Support

Notes on Maps Support

  • Ti.Map.View has been added along with Ti.Map.Annotation. However, in this release Annotations will not work because support for Annotations is not available in the BlackBerry Golden Master build for the Z10. We are working with BlackBerry to get clarity on this issue.

New Features in this Release (3.1.0.v20130213122031)

  • Database
  • WebView
  • 2.0 Layout Engine
  • Touch Events
  • Simple TableViewRow

Notes on Ti.UI.FILL

When using Ti.UI.FILL on root windows, there is a pixel shift towards bottom on top and right on left side. This only appears on the simulator. This is a visual issue and does not effect application functionality.

Previous Releases

  • HTTPClient
  • TCPSocket
  • Window
  • AlertDialog
  • View
  • Button
  • TextField
  • Label
  • TableView
  • ProgressBar
  • Slider
  • Titanium Studio Integration (Project creation, Deploy Simulator/Device, BlackBerry World Publish)

Additional Functionality for GA Release

  • TableViewSection (TIMOB-8840)
  • VideoPlayer (TIMOB-12230)
  • Contacts (TIMOB-12235)

To get the latest Preview Release build, go to and in the branch drop-down choose "master" then select the listed build. Subsequent builds will continue to be updated but the Preview Release has been tested to ensure basic functionality is working as expected. To see how to integrate the nightly with Titanium Studio visit

The TIMOB-* entries refer to tickets in our Jira bug and feature tracking system. The tickets are public and can be viewed at ticket number.