Set up your environment - BlackBerry Native
Set up your environment
Before you start developing for BlackBerry 10, there are a few things that you need to do.
Request a vendor account
If you want to offer your app on
the BlackBerry World storefront, you must
request a vendor account on the BlackBerry World vendor portal. When you are a member of the vendor portal, you
can use your primary user account to make your app and its digital goods available for
sale. For more information about applying for an account, see .
If you want to apply for and use
restricted permissions, you must have a vendor account. To learn about permissions, see
When you are a member of the vendor
portal, you can also simulate purchasing and downloading your app using a sandbox user
account. To learn how to simulate the purchase process, see .
Set up your device
To develop apps for your BlackBerry 10 device using the Momentics
IDE for BlackBerry, you must enable Development Mode on your device. This mode
allows you to remotely install and launch apps. If you don't intend to do development
activities, disable Development Mode for increased security. Development Mode expires
automatically in ten days. If you restart your device, Development Mode is disabled
automatically.
To enable Development Mode on your device:
On the home screen, swipe down from the top of the screen or open
the Settings app on your home screen.
Navigate to Settings &
Security and Privacy & Development Mode.
Turn on the Development
Mode toggle button.
If you are prompted, enter the password for your device and tap
You can connect your device to the IDE using Wi-Fi
or with a USB cable.
If you have a media card inserted into your device, you must turn off mass storage
mode to connect your device to the IDE. Navigate to Settings & Storage and
Access and set the USB Mass Storage toggle button
Download and install the IDE
Now you can
with the right version for your operating system. Windows, Mac
OS, and Linux
are supported. The IDE contains the tools that you need to develop apps for BlackBerry 10 devices. To make this download faster, the BlackBerry 10 Native SDK is installed separately.
When you start the Momentics
IDE, you can download and install the BlackBerry 10 Native SDK from within the IDE. The IDE provides a wizard that helps you
select an SDK that matches the connected device. You can also install a previous version
of the SDK to develop your app for device OS versions that are already released.
Versions of the SDK are referred to as API levels. To learn more about API levels, see
If you already have a version of the IDE installed or you’re using an
old workspace, you need to update your SDK after you start the IDE. To get a new version
of the SDK, click Help & Update API Levels. Using the tabs, you can select a
Gold or beta version of the SDK.
Set up the IDE and connect your device or simulator
Now you can set up the Momentics
IDE for BlackBerry. Let's get started!
To start the Momentics
In Windows, start the Momentics
IDE by using the shortcut created by the setup
application.
OS, start the Momentics
IDE by using the shortcut on the Launchpad or by navigating
to the Momentics
IDE application in a Finder window.
In Linux, start the Momentics
IDE by running the qde executable in the IDE installation folder.
If you are prompted, choose a workspace or create a workspace, and click OK. A workspace is a folder where you keep your
The IDE automatically tries to find a device that is connected
to your computer. If your device is not connected correctly, you can use the
Device Properties dialog box to
troubleshoot your connection. To open the Device
Properties dialog box, click
beside the Launch target
drop-down list.
If your device is connected to your computer, you can download a
version of the BlackBerry 10 Native SDK that matches your device. Follow the steps in the wizard
to download and install an SDK version.
On the toolbar, you can select an action using
the Launch mode drop-down list. By
default, the launch mode is set to Debug.
You can create or select a
launch configuration in the Launch
configuration drop-down list. By default, a launch configuration
is created for every project that you create and usually you don't need to
create a launch configuration manually.
You can also
create or select a target for your launch configuration (a device or simulator)
using the Launch target drop-down list.
If you are connecting to a new BlackBerry 10 device, click Add New
Target in the Launch
target drop-down list. Click the Devices tab and follow the instructions in the wizard to pair
your device with the IDE, get your BlackBerry
ID token, and create or import a debug token for your
When you create a debug token, you specify the PIN for each
device on which the token can be used. You can distribute the debug tokens that
you create to developers to install on those devices, or install them yourself.
Make sure that you remember your registration PIN. You need this PIN later in
the signing registration process.
Debug tokens are valid for 30 days. When a debug token expires,
the device no longer allows unsigned apps that rely on that token to run. When a
debug token expires, you can generate a new one from the BlackBerry
ID that's registered on your computer.
If you are testing using the BlackBerry 10 Device Simulator, click Add New
Target in the Launch
target drop-down list. Click the Simulators tab and follow the instructions in the wizard to set
up the simulator.
You don't need a debug token or BlackBerry
ID token to run apps on the BlackBerry 10 Device Simulator.
For more details about signing and
publishing your completed app, see . If you need help getting a BlackBerry
ID token, visit .
Now you are ready to build an app!
Build an app
Let's walk through creating, building, and running a new project in
Create a standard empty project for Cascades
In the Momentics
IDE, on the File menu,
click New & BlackBerry Project.
On the Project Type page,
click Application & Cascades and click
On the Templates page,
click Standard empty project and click
On the Basic Settings page,
in the&Project Name&field, provide a name for
your project (for example, MyFirstApp). Click Next.
On the API Level page,
select the API level that you want to use and click Finish. To learn more about API levels, see .
If you're prompted to open the QML Editing perspective,
click&Yes.
To run the Hello World app, click Run from the Launch mode
drop-down list, and make sure that your project appears as the active launch
configuration. Click .
To preview the UI of your project, open the main.qml file
for the project (located in the assets folder). At the top of the edit area, there are
five buttons. Click the second button (Design
Mode) to preview how your UI looks before you run your app on a device.
The Vertical Split Mode and Horizontal Split Mode buttons let you preview the source
code area side-by-side with the preview area.
Create a simple OpenGL
In the Momentics
IDE, on the File menu,
click New & BlackBerry Project.
On the Project Type page,
click Application & Core Native and click
On the Templates page,
click OpenGL ES 1.1 and click Next.
On the Basic Settings page,
in the&Project Name&field, provide a name for
your project (for example, MyFirstApp) and click Next.
On the API Level page,
select the API level that you want to use and click Finish. To learn more about API levels, see .
If you're prompted to open the C/C++ perspective, click&Yes.
To run the app, click Run
from the Launch mode drop-down list, and
make sure that your project appears as the active launch configuration. Click .
What's next?
Celebrate!&You've set up your environment and built your first app. Now
you can explore the documentation or the sample apps.
To explore the sample apps, click Sample
apps on the Welcome page and select a sample app. Click Download and import on the sample to add it to the
Active Project drop-down list and the Project Explorer view.
To get started building an app from the ground up, try out these tutorials:
Follow the
tutorial and learn about the basic app
structure in Cascades.
Follow the
tutorial and learn
about the basic app structure in C apps.
To learn more about using the Momentics
IDE, including how to test, debug, and profile your app, see
Last modified:
Please enable JavaScript to view the
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. 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. 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. 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.<, , , , News 11, Channel 13 On Your Side, Your Local News, ABC 5, FOX 9, Telemundo 3, Yuma, El Centro, Imperial Valley, News, Weather, Sports, Breaking News - KYMA
loading...}