This documentation relates to previous versions of Titanium Studio.

To see the latest documentation, visit docs.appcelerator.com.

Skip to end of metadata
Go to start of metadata
Chapters

BlackBerry Development Prerequisite

There are a few items that have to be in place before the BlackBerry development can begin.

OS Requirements

Currently, BlackBerry development is enabled on Windows OS only.

Java Requirements

  • JDK 6, update 14 or greater (can be downloaded from http://www.oracle.com/technetwork/java/javase/downloads/index.html)
  • A 32bit Java version is required, even if you are running on a 64bit machine.
  • A JAVA_HOME directive should be placed in the system's environment-settings.

  • A setting for the bin and lib Java directories in the PATH directive of the system's environment-settings (%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;)

Eclipse/Studio Requirements

A 32bit Eclipse version is required, so in case you are installing the Titanium Studio as a plugin, make sure you do it on top of a 32bit version of Eclipse installation.
In case you got a stand-alone version of the Titanium Studio, no action is required, as the Studio is already shipped with a 32bit Eclipse.

BlackBerry Developer Credentials

In order to install the RIM plugin, you will need to be a registered BlackBerry developer. You can do so at https://www.blackberry.com/bdsc/?lang=na#register.

BlackBerry Signing Keys

The BlackBerry plugin requires signing-keys in order to install the application on the device, or package it for distribution.
You can order those keys on the BlackBerry site at: https://www.blackberry.com/SignedKeys/

It may take a few days to get the ordered keys

BlackBerry Mobile SDK

BlackBerry development requires a Titanium Mobile SDK version 1.7 and above. The SDK is essential for the Titanium Studio interactions with the RIM plugin, and in fact, you will not be able to create a BlackBerry-enabled project without it.
Use the Titanium Studio to check for updates (through the Help menu -> 'Check for Titanium SDK Updates...'). The installed SDK versions will be visible when you create a new project, and you'll have to select version 1.7 (and above) to allow a BlackBerry project creation.

In case version 1.7 was not grabbed as part of the update (may happen in the first days of its release), install it manually by following the instructions at Manually downloading Titanium SDKs from a URL , and paste this URL into the dialog: TODO - PROVIDE THE 1.7 URL HERE

BlackBerry Desktop Software

The BlackBerry Desktop app is required for installing the mobile-applications into the device.
Download and install the application from https://swdownloads.blackberry.com/Downloads/entry.do?code=A8BAA56554F96369AB93E4F3BB068C22.
(If you are having problems running the latest version, try a previous one)

Installing the BlackBerry RIM SDK

The Studio is using the official RIM Eclipse plugin for the BlackBerry development.
Once you got the Studio installed, open the preferences at Titanium Studio -> Titanium and click the Get SDK... button. This will initiate the RIM plugin installation.

Select the latest RIM plugin version from the install dialog, and hit Next to start the download and install. You will be asked to fill in your BlackBerry developer credentials, so make sure you have it in hand at this point.

The downloaded RIM plugins are over 240mb in size, so the installation process may take a while.
Once it's done, restart the Studio. The fields in the Titanium preference page will be populated with the SDK location (which is the current Studio's install directory) and the BlackBerry's simulators types (defaulted to the 9550 simulator).

Creating a BlackBerry Project

Open the new Mobile Project wizard and select 'BlackBerry' as a deploy-target. Note that you'll have to have the BlackBerry mobile-SDK already installed at this phase, otherwise, the deploy-target will be disabled.

Running the Project in the Simulator

Once you have the project created, it's possible to run it in the BlackBerry Emulator.
Select the project in the App Explorer or Project Explorer and click the Launch button to select the BlackBerry Simulator.

Clicking that button will start the simulator and install your application into it.
You may switch to the Debug perspective to see the process of that launch.

That launch will create a Run Configuration that can later be edited through the Run Configurations... dialog.
You may also create new configurations directly from that dialog.

Running the Project on the Device

IMPORTANT: Please read the Troubleshooting section at the bottom of this article to resolve any path issues that we currently have with the BlackBerry SDK support.

Please follow the instructions above and have your BlackBerry keys ready and the BlackBerry Desktop Software installed. Both are required for a successful launch and installation into the device.

Once you have everything in place, set up your BlackBerry keys location in the Titanium preferences page. Then, launch the BlackBerry Device from the Project Explorer or the App Explorer toolbar.

Packaging/Distributing the Project

IMPORTANT: Please read the Troubleshooting section at the bottom of this article to resolve any path issues that we currently have with the BlackBerry SDK support.

To package your project for distribution, first set up your BlackBerry keys location in the Titanium preferences page. Then, launch the Distribute - BlackBerry from the Project Explorer or the App Explorer toolbar.
Follow the dialog instructions for a successful packaging.

Troubleshooting

The current implementation of the BlackBerry SDK has an issue (http://jira.appcelerator.org/browse/TIMOB-3908) that prevents a normal execution of launching an app on a device, or packaging it for distribution.
In order to make it work till it gets fixed:

  1. Go to the Titanium Studio installation folder and locate the plugins directory.
  2. Create this directory structure: plugins\net.rim.ejde\vmTools\
  3. Copy the files from plugins\net.rim.ejde.componentpack5.0.0_5.0.0.25\components\bin\ into the vmTools directory you created.
Labels