×

Publishing your web app

This topic explains the steps you need to take to deliver and publish your web app to Nokia Store. Adding your web app to Nokia Store is the best way to make it visible to the largest number of users.

Background

The Nokia store provides users with access to downloadable content and applications, which it delivers and installs on a phone. Unlike applications, Nokia Asha web apps are not stored in the phone's memory. Instead, they are stored on and run in the Xpress Browser Proxy server. A Nokia Asha or Series 40 phone displays the results of the processing undertaken on the Proxy server. Nokia Asha web apps do run some code locally on the phone, such as the code to dynamically alter the UI content. However, this code is resident on the phone only temporarily. Since there is no Nokia Asha web app component to install on a phone, a Nokia Asha web app cannot be made available in the Nokia Store in the usual manner. Instead, a small system-generated Java application is delivered to the Nokia Store.

This Java application, once installed on a phone, adds an icon and the application title to the phones usual app launcher screens and menus. When the user runs this application, it passes the URL of the web app to the Xpress Browser, which communicates with the Proxy server to run the web app. In this way, the small Java application makes the web app available in the Nokia Store and also makes the web app easily accessible in the phone's UI.

Publishing your web app in the Nokia Store

For detailed information about publishing a web app to the Nokia store, see the Become a Nokia Store Publisher web page. From this page you can download the following documents:

  • Publisher Guide, which provides detailed information on the publication process and the application submission requirements
  • Nokia Store Content Guidelines, which provides the technical requirements for various content types and describes the types of content that Nokia considers to be inappropriate and will not publish.

All new or updated web apps should be designed to run on the latest version of the Xpress Browser. Because the Browser is under constant development, different Nokia Asha platform and Series 40 phones will run different versions of the Browser. When a user runs a web app that requires the latest version of the Browser on a phone that has an earlier version installed, the user will be prompted to install the new version.

Before packaging your web app for submission to the Nokia Store, you must define an icon, a favicon, and a name for your web app.

Defining a name for your web app

You must provide at least two names for your web app:

  • short name
  • long name (“display name”)
The short name is for the Java application that launches your web app. This name displays in the phone UI. The long name displays in the favourites list of the Xpress Browser. If you have created your web app in the Web Developer Environment (WDE) New Nokia Asha web app (wgt) option, the long name is defined in the Display Name field and the short name is defined in the Short Name field, shown in the figure below.

Figure 1. Display Name and Short Name fields in the WDE Nokia Asha web app wizard

The display name should be as short as possible so that it fits well in the display when translated in many languages. The short name must be 16 characters or shorter in length and can use the following characters only: ASCII characters, dashes, underscores, digits, and spaces.

Note: If the short name contains characters other than the permitted characters, the publishing process could fail to create the Java application that launches the web app. If the Java application is not created, your web app will be rejected from the intake process and will be returned to you for correction and re-submission to Nokia Publish.

Defining icons for your web app

Two different icons represent your web app on a phone:

  • a launcher icon which is used in various application lists in the phone's UI.
  • a favicon which is used in the Favourites, History, and free web apps folder views of the Nokia Xpress Browser.
The launcher icon for your web app depends on the nature of the UI on the target phone. More information on the icons can be found in the Icons section of the Design Library's Launching web apps topic. Once the icon has been stored in the web app project, it need to be specify in the config.xml file by defining a path in the icon element as follows:
<icon src="img/icon.png"/>

During the publication process, this icon file is retrieved and incorporated into the Java application that is made available in the Nokia Store. Icons for some popular web apps are shown in a sample apps menu below:

Figure 2. Example icons in the applications menu

The favicon for your web app is a 16 x 16 pixel image file named favicon.png. Specify the favicon by including the following in the index.html file of your web app:

<link rel="icon" type="image/png" keyref="id4f3dfef4-f3f5-481c-992f-a0240614e004">

A sample favicon for the TicTacToe web app is shown in a Favourites menu as follows:

Figure 3. Example favicons for web apps in the Favourites list

Packaging your app for submission to the Nokia Store

The Nokia Store publication process requires you to submit the *.wgt file of your web app.

During development, the WDE automatically packages an app before previewing it. Packaging an app prepares it for upload to the Xpress Browser Proxy server. From the Proxy server, the web app can be run in the simulator or on a phone. You can create a package for your web app without running a preview. To do this, in WDE, right-click on the project name in the Project Explorer pane and select Package Web app in the resulting shortcut menu, which is shown in the figure below.

Figure 4. Shortcut menu for packaging a web app without previewing it

Creating the Java application

After you submit the *.wgt file to the Nokia Store, your web app goes through an approval process. If it is approved, the Nokia Publish system generates the Java application and publishes it in the store. The following flowchart provides an overview of the web app publication process.

Figure 5. Overview of the web app publication process

Once published you can obtain a copy of the Java application using the option on the Publish and Share page in the Web Developer Channel.

Publishing updated web apps

When you update your web app, you must define a new version number within it. Submit the updated version with the new version number to Nokia Publish according to the same process used to submit the initial version. The publication process adds the new version to the Xpress Browser Proxy server. The earlier version is not overwritten; therefore, users continue to open the previous version until they update the Java application that launches the web app. You might consider providing a mechanism within your web app to alert users when a new version is available and to encourage them to visit the Nokia Store to install the updated version.

Finding and downloading a web app from the Nokia Store

To discover and install a web app onto a phone, a consumer follows these steps:

Opens the Nokia Store, either directly from the Nokia Store icon or through a browser.
Browses the content available.  
Chooses a web app to learn more about.  
Purchase (if necessary) and download the web app. Nokia Store delivers the web app's Java application to the consumer's phone and installs it.  
Start the Java application from the applications list on the phone. If Xpress Browser is not installed, the user is directed to a location from which the Browser can be downloaded.  

Last updated 7 October 2013

Back to top

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×