Getting Started

The BlackBerry Runtime for Android apps allows you to run Android apps on BlackBerry 10 devices. Repackaging your Android apps to run on the BlackBerry Runtime allows you to reach a brand new set of potential customers. Once you've repackaged your Android apps as BAR files, you can submit them as BlackBerry 10 apps to the BlackBerry World storefront.

Before you get started

You can use the BlackBerry Runtime for Android apps to run Android Jelly Bean 4.2.2 apps on the BlackBerry 10 OS.

If you're developing for a previous version of the BlackBerry 10 OS, use Android Gingerbread 2.3.3.

For information on repackaging an Android app for the BlackBerry PlayBook, see Plug-in Repackaging Tool for BlackBerry PlayBook.

UI differences in repackaged Android apps

The following information outlines some of the differences that you can expect to see in your Android app's UI after it has been repackaged to run on a BlackBerry 10 device.

UI characteristic

What you can expect

Navigation

Since most BlackBerry 10 devices do not have a Back key, users must tap the Back button that appears at the bottom of the screen to return to a previous screen.

Note: A navigation bar with a Back button appears at the bottom of most Android apps. For apps that use full screen mode (for example, games), users can swipe down from the top of the screen to display a navigation bar.

Application menu

Since most BlackBerry 10 devices do not have a Menu key, users must swipe down from the top of the screen to display the application menu.

Notifications

Application notifications, including the status of activities that are occurring in the background (for example, music that's playing, or files that are downloading), appear in the BlackBerry Hub.

Designing for specific BlackBerry 10 devices

If you want to optimize the layout of your UI for a specific type of BlackBerry 10 device, you can make adjustments to its UI components based on the characteristics of that specific BlackBerry 10 device. Characteristics such as screen size, aspect ratio, display type, and screen density can be found using the links provided below.

For information on specific BlackBerry 10 device screen characteristics, see Different screen sizes.

For information on the UI framework, and visual style of the BlackBerry 10 OS, see UI Guidelines for BlackBerry 10.

Stages of the overall process

Here are the six steps that you can follow to get started with the process of submitting your Android apps, as BAR files, to the BlackBerry World storefront. Carefully follow the instructions in each step before proceeding on to the next step. As you can see the last set of instructions will guide you through the submission process to get your apps into the BlackBerry World storefront.

Screen showing the steps six to get started. Checking the compatibility of APK files Create a BlackBerry ID token Set up your test environment Adjust your Android application Choose your app repackaging tool Publish to BlackBerry World
  1. Checking the compatibility of APK files
  2. Create a BlackBerry ID token
  3. Set up your test environment
  4. Adjust your Android application
  5. Choose your app repackaging tool
  6. Publish to BlackBerry World
comments powered by Disqus