Create your config.xml file

The config.xml file is an .xml file that contains the elements that define your app's properties. The config.xml file defines the BlackBerry WebWorks application namespace; it provides general app information, such as the app name, description, start page, and home screen icon; and it specifies the features and functionality that the app can access.

Every BlackBerry WebWorks app must have a config.xml file located in the root folder of your application archive. The file name is case insensitive.

The root element of the config.xml file is the widget element. The widget element provides a container for all other elements.

For a list of all the elements that you can use in a config.xml file, see Elements in config.xml. The structure and supported elements differ slightly depending on which BlackBerry OS you are developing for.

Sample config.xml file

<?xml version="1.0" encoding="utf-8"?>
<widget xmlns=""
        version="" id="sampleapp">

  <author href="" 
          rim:copyright="Copyright 1998-2012 My Corp">My Corp</author>

  <name>Sample application</name>

    A sample application to demonstrate some features.


  <icon src="icons/icon-150.png"/>

  <rim:splash src="splash-1280x768.png"/>
  <rim:splash src="splash-768x1280.png"/>

  <content src="index.html"/>

  <feature id="blackberry.ui.dialog"/>
  <feature id="">
    <param name="orientation" value="portrait" />
    <param name="backgroundColor" value="0xFFFF0000" />

  <access uri="" subdomains="true">
    <feature id="" required="true" version="1.0.0"/>
    <feature id="blackberry.invoke" required="true" version="1.0.0"/>

  <license href=""/>


Last modified: 2014-03-10

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

comments powered by Disqus