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

Technote (troubleshooting)


Problem(Abstract)

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.

Cause

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.0.1, 5.0.0.2, 5.0.0.3, 5.0.5, 5.0.5.1 Consumer, Enterprise

Rate this page:

(0 users)Average rating

Document information


More support for:

IBM Worklight
Application Development

Software version:

5.0, 5.0.0.1, 5.0.0.3, 5.0.5, 5.0.5.1

Operating system(s):

AIX, HP-UX, Linux Red Hat - xSeries, Linux SUSE - xSeries, Mac OS X, Solaris, Windows

Software edition:

Consumer, Enterprise

Reference #:

1623797

Modified date:

2013-01-29

Translate my page

Machine Translation

Content navigation