It seems like the browser you are using has JavaScript disabled. As a result, the site will not function properly. We really want you to enable it so you may experience our site as we intended it. If you have no idea what we are talking about or if you need help, visit http://www.enable-javascript.com×
This website uses cookies. By continuing to browse this site you are agreeing to our use of cookies. Find out more on our cookie page.×

Oops, it seems like you're using an old browser that we do not fully support. If you're able to, please upgrade your browser here.×
This website uses cookies. By continuing to browse this site you are agreeing to our use of cookies. Find out more on our cookie page.×

Becoming a default app

You can enable your app to become the default app for certain types of
content, such as files (for example, .pdf, .doc, or .cal files) and data (for example,
an HTTP link, text, or a phone number). When the user opens the specified content for
the first time, your app is listed as an option to be the default app for that type of
content.

Objective C doesn't work with the attributes
listed below.

Registering your app

To register your app as a default
app, you must specify bb.action.OPEN as the action
and specify either a MIME type and URI or a MIME type and file extension in the
bar-descriptor.xml file.

For example, to register your app
as the default app to open a specific URL (http://www.example.com), your app must
specify bb.action.OPEN as the action, http://www.example.com as the URI, and text/html as the MIME type in the target filter section
of the bar-descriptor.xml file.

If you are registering for a URI or file extension and do not have
a specific MIME type to declare, you should specify a wildcard character (*) for the MIME type.

Setting a default app

After you register your app as a default app, the
user still needs to set it as the default app for that type of
content. The user can set the default app by selecting the
Use as default check
box in either the Open in
sheet of the context menu or in the Open in system dialog box.

The user can configure the default apps in the
Settings app by selecting App
Manager > View
Default Apps.

Last modified: 2015-03-31

Got questions about leaving a comment? Get answers from our Disqus FAQ.

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.