Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Revision as of 10:52, 24 April 2013 by isalento (Talk | contribs)

Nokia Asha web apps - known issues

From Wiki
Jump to: navigation, search
Article Metadata
Created: petrosoi (04 Apr 2011)
Last edited: isalento (24 Apr 2013)


App installation

Problems while deploying test apps with Bluetooth Launcher

Get the latest Bluetooth Launcher:

If you have installed Nokia Browser for Series 40 to your phones and still encounter an error note "Ovi Browser by Nokia was not found on your device..." when deploying a test app to the device over a Bluetooth connection, you can still test apps by following chapter 2.6.2 "Deploy by use of a short URL" in Series 40 Web Apps Getting Stated Guide.

In this case you open Nokia Browser for Series 40 manually and enter the short URL as the page address. This will point the browser to your web app preview front page.

Nokia Web Tools

Release Notes

See release notes for possible known issues for Nokia Web Tools

Issues after upgrades

Some users may encounter issues with the deployment, previewing, and uploading of web apps crashing after upgrading from 1.2 to 1.5.

This issue seems to be related to the memory available to Eclipse, in some installations. You should be able to fix the issue by setting MAXPermSize to a higher value. Locate the NokiaWDE.ini file in:

  • C:\Program Files\Nokia Web Tools 1.5.0\Web Developer Environment\ under Windows.
  • /applications/Nokia Web Tools 1.5.0/Web Developer Environment/ under Mac.
  • /usr/local/NokiaWebTools-1.5.0/Web Developer Environment/ under Ubuntu.

Edit the ini file and look for:


Change 256m to 512m, save and restart WDE.

You should now be able to deploy, preview, and upload without issues.

You can check the current settings from the WDE About dialogue (from the Help menu click About NokiaWDE then in the dialogue click Installation Details and open the Configuration tab) as shown here:

Issues with non-standard WDE launches

In some cases, such as BAT execution of the WDE, the “--launcher.XXMaxPermSize” argument seems to be ignored. This results is similar issues to those described above. To fix such issues, in the NokiaWDE.ini file set the parameters to:


Templates include incorrect code for page refreshing

This issue is fixed in Web Tools 1.5

A number of the web app templates provided in Nokia Web Tools 1.5 use the syntax {{{1}}} to implement a page refresh within the web app. This method results in the web app being switched to browser mode and no longer functioning as expected. This code should be replaced with {{{1}}} to ensure the web app behaves as expected. ¨

Preview server

Web app life span on the preview server

A Web App that is uploaded to test server during development, from Nokia Web Tools, is removed after two weeks of inactivity. Note that this does not apply to Web Apps published to Nokia Store.

Web app size limit on the preview server

  • Situation: When previewing a web app in WAS or uploading a web app to the test server, the message Upload failed - 10 Jun 2011 02:47 PM Error Details: Bad Request may be observed.
  • Issue: There is a size limit on *.wgt files of 500Kb. Files of greater size will not be uploaded to the test server.
  • Workaround: Reduce the size of the *.wgt file.

Web app download and execution

Downloadable content size limit in Series 40 web apps

Maximum size for downloadable content is 20MB. Any file bigger than that will result HTTP Error 413: Request entity too large.

Page expired - Reloaded automatically note

A session is initiated, when you start a web app. If you are not using the web app for five minutes session expires, which causes the web app to be reloaded.

Device rendering

  • Issue: web app UI elements may render incorrectly after backstepping to the app from an external URL. This is due an issue with translating CSS styles in this scenario.
  • Workaround: No current workaround. Developers are advised to experiment with alternate CSS styles, if they encounter this issue.


Geolocation API anonymous callback functions

Please note that anonymous functions cannot be passed to getCurrentPosition() as arguments.

//does not work  
//use position
//check error code

Correct way to obtain location is introduced in Series 40 web apps – W3C Geolocation API.

Widget preferences

  • Widget preferences values are not stored and retrieved correctly in some cases when deploying the app using the short URL method. As a workaround Use Bluetooth deployment.
  • In Local preview, widget preferences attribute does not have support for setItem() and getItem() methods. If you want to use preferences in local preview, use widget.preferences["key"] syntax instead.
  • Stored preferences should be under 256 characters long and number of keys for a single web app can use is 500.

For details please see Using widget.preferences in Series 40 Web Apps

Base64 encoding and decoding

Native binary to ASCII, btoa() and ASCII to binary atob() functions are broken. Use JavaScript implementations freely available on internet, instead of native functions. Be cautious when using 3rd party libraries as they might use native btoa or atob functions internally.

Parsing XML document with namespace

<product xmlns:prd="">
</product >

When executing getElementsByTagName("title"); query to above XML file, Simulator local preview returns the Correct NodeList having 1 element. However in Cloud Preview and on the Device zero nodes are returned.

As a workaround GetElementsByTagNameNS('','title'); can be used in both environments.


CSS transitions

Animating multiple properties at once is not supported. For example following CSS property does not work in the device or in the cloud preview.

-webkit-transition-property: margin, height, width ; /*Does not work*/

Solution: Animate only a single property at a time.

For margin animation use explicit margin-top and margin-left instead of margin.

-webkit-transition-property: margin-top;
-webkit-transition-property: margin-left;
-webkit-transition-property: width;
-webkit-transition-property: height;

Text Overflow Mode

text-overflow-mode: ellipsis || clip, does not work in the current version of series 40 Web Apps

CSS overflow hidden rendering issues

This issue is fixed in Web Apps 2.0

Text inside an element having overflow: hidden; and width: 0px; is not rendered correctly. The text should be hidden completely, but instead it is drawn letter by letter vertically. As a workaround limit the element minimum width 1px wide.

CSS Background image

Background images are up- or down-scaled to to match element e.g. DIV size, not repeated. If padding is applied to element, background image is scaled to element size, without taking padding into account. Then the scaled background image is repeated to fill the whole element area.

Web App Simulator preview issues

setItem() and getItem() methods in local previews

This issue is fixed in Web Tools 2.0

In a local preview, the widget preferences attribute doesn’t provide support for setItem() and getItem() methods. If you want to use preferences in a local preview, use the widget.preferences["key"] syntax instead. Alternatively, use a cloud based preview only with web apps using these methods.


The reload button in the simulator toolbar restarts the web app based on the last version launched in the simulator. Using this button doesn’t include any changes in the web app code made in the Web Developer environment after the simulation was launched. This ensures consistence between the local and cloud previews - as the cloud preview will always be based on the last version of the web app uploaded to the server. To include any changes in code in the simulation, it must be run again from the Web Developer Environment.

Preview rendering

This issue is fixed in Web Tools 1.5

  • Issue: Pages with vertical scrolling will cause a scrollbar to rendered in the Simulator. This will also cause horizontal scrolling, since the content is extended to a width larger than the window width.
  • Workaround: Always try to test on Series 40 phones.

Large Images are not scaled for the Simulator preview

Images served to simulator on a cloud preview are original ones in the original size. However for device, large images are resized by the proxy to fit device screen. One must take this into account when previewing a web app in simuluator.

Secure callbacks when previewing apps on the simulator

  • Situation: When submitting information over a secure (SSL) connection during web app testing, in WAS.
  • Issue: Secure callbacks using SSL to servers via the MWL are currently not supported from the simulator. As a result secured data, such as Facebook user name and password, may not be secure when web apps are previewed in the simulator. This isn't an issue when using the app on a phone. As a result it's recommended that only test user accounts, instead of personal ones, be used during development and previewing of applications.
  • Workaround: Use test accounts or change passwords after testing.

Phone based testing

Preference values do not work correctly when deploying apps via short URL

  • Issue: Web apps launched from the short URL are unable to make use of the Widget API preferences attribute to save and restore data between sessions. This means that web app features making use of persistent data — such as preference settings — will not work when a web app is launched in this way during development.
  • Workaround: Use the Bluetooth Launcher to launch the web app on a phone. Alternatively, you can open the original deployment URL in S40 device Nokia Browser (See image below)


176 page views in the last 30 days.