Skip to main content

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 at this time in v5.0.0.x and v5.0.5.x and will cause negative impact

The <mainFile> tag represents the name of the starting html file that will be invoked by the Worklight client runtime when the Worklight app first starts. During the creation of the Worklight application, the file name specified as the value of the tag defaults to the name of the Worklight application and correspondingly a HTML file with the same name is created under the Worklight application folder.

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 will have a negative impact on the code generation process for various environments and may lead to unpredictable results.

Resolving the problem

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

  • Retain the name of the default value specified in the <mainFile> tag as it.
  • Create a new Worklight application with the name 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

Copyright and trademark information

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Rate this page:


(0 users)Average rating

Add comments

Document information

IBM Worklight

Application Development


Software version:
5.0, 5.0.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

Content navigation