To create the info.plist
file of a widget:
Create an XML-formatted document that conforms to the Document Type Definition (DTD) defined by Nokia.
The properties of a widget are defined in the form of key and value pairs, where a key is a predefined term and a value is a configurable string. The format of the info.plist
file and the syntax of the key/value pairs are illustrated in the following sample code:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Nokia//DTD PLIST 1.0//EN" "http://www.nokia.com/NOKIA_COM_1/DTDs/plist-1.0.dtd"> <plist version="1.0"> <dict> <key>DisplayName</key> <string>WidgetName</string> <key>Identifier</key> <string>com.company.widget.projectname</string <key>MainHTML</key> <string>Main.html</string> <key>Version</key> <string>1.0</string> <key>AllowNetworkAccess</key> <false/> <key>MiniViewEnabled</key> <true/> </dict> </plist>
The easiest way to create the info.plist
file is to copy from a template that already contains all supported keys and then modify each key accordingly.
Save the XML document under the widget project root folder with the name info.plist
.
The following table lists the properties supported in the Web Runtime environment.
Property name |
Type |
Use |
Description |
---|---|---|---|
|
String |
Mandatory |
The name of the widget to be displayed in the application menu. |
|
String |
Mandatory |
A unique string identifier for the widget. The identifier should specify the company’s reverse domain format, for example. |
|
String |
Mandatory |
The name of the main HTML file to be loaded when the widget starts running. |
|
String |
Optional |
The release version of the widget. Widgets support updates where a new version of a widget is provided on the Web and installed on top of the previous widget version on a mobile device. For more information on creating self-updating widgets, see Managing widgets on mobile devices. |
|
Boolean |
Optional |
Access right to network-based resources or data. If the value is |
MiniViewEnabled |
Boolean |
Optional |
Enables a widget for the home screen on compatible devices, such as the Nokia N97. If the device does not support home screen widgets, this parameter is ignored and the widget operates normally in full screen mode. |