Becoming a default app

You can enable your app to become the default app for certain types of content, like files (for example, .pdf, .doc, or .cal) 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 application for that type of content.

Registering your app

To register your application as a default application, you must specify bb.action.OPEN as the action and specify either a MIME type and a URI or a MIME type and a 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 a 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: 2013-12-21



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

comments powered by Disqus