IBM Support

Errors when changing <mainFIle> tag in application-descriptor.xml file

Technote (troubleshooting)


Changing the <mainFile> tag in the application-descriptor.xml file is not supported in v5.0.0.x and v5.0.5.x and causes a negative impact.


The <mainFile> tag represents the name of the starting HTML file that is invoked by the Worklight client runtime when the Worklight application first starts. During the creation of the Worklight application, the file name that is specified as the value of the tag defaults to the name of the Worklight application. Also, a corresponding HTML file with the same name is created under the Worklight application directory.

It is not advisable to change this default value of the <mainFile> tag in anticipation of directing the start file to a different file while still retaining the original name of the application. This approach has a negative impact on the code generation process for various environments and can lead to unpredictable results.

Resolving the problem

To work around this problem, take one of the following actions:

  • Retain the name of the default value specified in the <mainFile> tag.
  • Create a new Worklight application with the name that you want.

Cross reference information
Segment Product Component Platform Version Edition
Mobile- Speech and Enterprise Access IBM Mobile Foundation Application Development AIX, HP-UX, Linux, Mac OS X, Solaris, Windows 5.0, 5.0.0,,,, 5.0.5, Consumer, Enterprise

Document information

More support for: IBM Worklight
Application Development

Software version: 5.0,,, 5.0.5,

Operating system(s): AIX, HP-UX, Linux, OS X, Solaris, Windows

Software edition: Consumer, Enterprise

Reference #: 1623797

Modified date: 29 January 2013

Translate this page: