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.

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 config.xml file.

For example, to register your app as the default app to open a specific URL (, your app must specify bb.action.OPEN as the action, as the URI, and text/html as the MIME type in the target filter section of the config.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.

Screen showing the Open in sheet providing the user the option to set one of the listed apps as the default.

Last modified: 2014-12-04

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

comments powered by Disqus