×

Publishing tool quick guide

Publish apps in Nokia Store

This is a quick guide to publishing apps to Nokia Store with Nokia Publish tool. The publishing flow in the tool differs depending on, for example, what platform you are submitting apps for, and if you are submitting or updating apps.

This guide gives a quick overview over two flows: publishing Nokia X apps with Nokia In-App Payment items or HERE keys, or without Nokia In-App Payment items or HERE keys.

Briefly described, the publishing flow for both goes as follows:

  1. Register as publisher.
  2. Provide bank details if you plan to submit apps with Nokia In-App Payment.
  3. Prepare your app, icons and screenshots.
  4. Start the publishing process in Nokia Publish tool.
  5. Add metadata, icons and screenshots, and upload the application file.
  6. Submit your app for Nokia Quality Assurance.
  7. When your app has passed the Nokia QA it is published in Nokia Store, and you can start to view download reports in the Publish tool.

The flow for updating Nokia X apps and Asha / Series 40 apps is described in Nokia Store Publisher Guide. The Publisher Guide also provides additional instructions on preparing your app for publishing, and on what to fill in to the Publish tool.

See additional support material and guidelines at:

Register to Nokia Publish tool

You can sign in with your Nokia account, and then register as a Nokia publisher. If you do not yet have a Nokia account, you need to create one when you start to use the Publish tool.

  1. At https://developer.nokia.com/publish click Publish your app.

  2. Click Sign into your account. a

  3. Sign into your Nokia account, or click Register to create one.

  4. Fill in your developer details into the screen that opens.
  5. In the next screen you create your publisher profile. First select if you wish to create a personal or corporate publisher profile. If you represent a company and you wish several people to be able to use the same publisher account, you can create a corporate account and link many accounts under it.

  6. Fill in the requested details accurately. Use the tips in the fields to guide you with what you need to fill in.
  7. Fill in the security code.
  8. Check that you have read and agree to the Nokia Store Publisher terms and conditions.
  9. After you have filled in all details, save your profile. The tool will inform you of any missing or invalid information.
  10. Your Publish tool home page opens with your publisher dashboard open. In this view you can view your account statistics, such as estimated downloads by countries or phone types, and revenue estimates. You can also edit your account details or bank info, or add new users under your company account, and find links to necessary support information and documentation.

Provide bank details

If you plan to publish content consumers must pay for, you must provide your bank details before you will be allowed to submit content to Nokia Publish tool.

Nokia X software platform applications are free, but you can provide purchasable functions in your applications through Nokia In-App Payment. Read more about Nokia In-App Payment in Nokia In-App Payment Developer Guide.

Bank accounts must be able to accept Euros (€) as Nokia can only pay in Euros. The admin user of each company is able to edit the account details.

  1. Click the Accounts tab.
  2. Click Bank information.
  3. Fill in the bank details. For more information on what to fill in, use the on-screen helps and the instructions in Publisher Guide.

Note: The instructions for filling in the bank information in the Publisher Guide are general, and you should pay special attention to filling in the details to meet the specific requirements in your country. If you are not sure of what to fill in, contact your bank.

Here are some common as well as country specific errors that may delay payments, and their solutions:

  • Bank code/number is wrong
  • Bank city wrong or does not match with the other bank information
  • Bank account no. field contains bank code
  • Bank control key missing, wrong, or not required (not mandatory or used in all countries)
  • SWIFT code has wrong number of characters, should be 8 or 11
  • IBAN missing, does not match with the bank account, or entered into the Bank account no. field

China:

  • Bank code/number, wrong number of characters. Use CNAPS code which is 12 digits.
  • Tax number 1, wrong number of characters. Use 15 digits long tax code or 18 digits long personal code.

India:

  • Tax number 1, tax code missing. Provide your personal PAN as tax code.
  • Bank code/number, wrong number of characters. IFSC (India Financial System Code) must be 11 characters (4 letters and 7 digits). In case of individuals, MICR number (9 digits).
  • Address in the Accounts > Publisher tab contains invalid address. Enter a valid street address, or if you use a PO Box you need to indicate clearly it is a PO Box number.

Kenya:

  • Address in the Accounts > Publisher tab contains invalid address. Enter a valid street address, or if you use a PO Box you need to indicate clearly it is a PO Box number.

Russia:

  • Publishers from Russia and the Ukraine need to sign a special agreement before payments can be made. Contact developer.support(at)nokia.com.

Prepare your app for publishing

Before you start submitting your apps to Nokia Store, you need to:

  • test that your app works
  • make sure your app complies with the Nokia Store Content Guidelines. Apps that do not comply with these guidelines fail Nokia QA testing and have to start the QA round again. You lose time to market, but even more importantly, good quality apps receive better ratings and more downloads.

You also need to prepare the following items carefully before you start submitting your apps, to speed up the submission process and the QA:

A name and description

A descriptive name and a good description ensure good visibility and searchability for your app.

Additional keywords

Use more keywords than just the default keywords to make it easier for consumers to find your app in Nokia Store searches. Add translated keywords in the same field.

Price of your Nokia In-App Payment items

Nokia X software platform apps are free but you can use Nokia In-App Payment items. In this case, in the publishing tool you select a price point for each item, from free to one of the 15 pre-set price points. Nokia has set the prices for the points for each market according to the local buying power. This makes distributing applications globally easy. You can check the prices for each market from the Billing Matrix. Items can also be added afterwards.

Language and countries

Language and countries your app supports. Submitting a global English version and separate country specific versions often help to reach maximum end user coverage.

Note that if you set the language for example as en-us, the app will only be distributed in the USA. If you want a global reach for your app, you have to select English.

To check to which countries you can submit apps in other languages than English, see Nokia Publish Support FAQ section App submission > Language/Region Distribution mapping .

Customer support email address

Contact email address for customer support and questions about your app. Support website is not mandatory, but helpful.

Icons and screenshots for Nokia Store

Logos, icons and screenshots visible to end users in Nokia Store. Read more about the requirements in Add icons and screenshots.

Signing your application

Signed application files. For instructions on signing your application, see signing instructions.

Publishing Nokia X apps without Nokia In-App Payment or Here keys

When you have planned and prepared the necessary information, you are ready to start submitting your app. If you are submitting a Nokia X app that does not use Nokia In-App Payment items or HERE keys, the process continues from registering as follows:

  1. On your Publish tool home page, click +Publish app.

  2. Select Nokia X - Quick Publish as the content type.

  3. Upload the application file (.apk). The system automatically verifies that the file is ok to be published. Max size for the file is 500 MB.
  4. Click Continue.
  5. Fill in the requested details including app details (name, content descriptions, keywords), icon and screenshots, country distribution and languages, contact info, legal, and privacy and age rating. Use the tooltips and the Publisher Guide to help you with what to fill in. Make the information good, as it is needed to represent your app as well as possible in Nokia Store.
  6. Click Submit for publishing to submit your content for Nokia Quality Assurance (QA) review. Plan for a turnaround time of three to four business days.
  7. When the app has passed Nokia QA it is pushed to the Nokia Store servers through a scheduled export process.
  8. When the app is available in the store you can view statistics such as downloads through your Nokia Publish account.

Add icons and screenshots

When defining the content item you need to add icons and screenshots that will represent your content in Nokia Store. Screenshots identify your app to shoppers when they are browsing Nokia Store. In the quick flow only two screenshots are allowed, but you can add up to eight screenshots later.

Mandatory:

  • An icon representing the content in size 512x512.

  • Two JPG or PNG screenshots from your app, portrait images of size 480x800 recommended for best quality. Nokia Store client shows app screenshots in portrait orientation. If you upload a landscape image of size 800x480, Publish Tool rotates the screenshot into portrait. The max size of the file is 4 MB.

The Nokia Publish Tool will scale down and resize your images to fit the Nokia Store client. However, the images may have gray borders on the sides or on top and bottom.

Optional:

  • Six additional screenshots in size 480x800.
  • 1024x500 mobile promotional banner. Note that content name will be shown on top of the banner in the Nokia Store, so do not include text in the banner, it would look messy.

Add age rating

Age rating is meant to ensure child protection in mobile devices and the mobile internet. Setting age rating for apps is mandatory for Nokia X software platform content.

Content that has been forbidden from Nokia Store in the past may now be allowed if it is assigned a 17+ rating in the publish tool, but certain material still remains forbidden, for example, adult content such as pornography. Forbidden material is listed in the Content Guidelines.

To get an age rating for your app, you need to make a selection for all valid options describing your app. The options are none, infrequent/mild or frequent/intense for the descriptors, and Yes/No for the features.

For example, if you submit a chatroom app which contains mature themes, in addition to Mature themes you may also need to select descriptor Social media without safety features. Based on your selections the Nokia Publish tool assigns your app an age rating which is shown in Nokia Store.

To help you make accurate selections when submitting your app, see the explanations and examples of the descriptors and features in Publisher Guide Age rating descriptors section.

Nokia QA

When you have submitted the content files to the system, the Nokia QA process starts.

  • If there are no failures in the Nokia QA, on average it takes three to four business days to get your files and metadata moderated, tested, and published.
  • If your content fails, you will get an email notification with details about the reasons for the failure, and you are asked to fix the problem and resubmit the content.
  • You can contact for support with publication issues.

Publishing Nokia X apps with Nokia In-App Payment items or HERE keys

When you are submitting Nokia X apps with Nokia In-App Payment items or HERE keys, the flow and look of the Nokia Publish tool differ from the flow for submitting Nokia X apps without Nokia In-App Payment or HERE keys.

  1. At https://developer.nokia.com/publish click Publish your app.
  2. If you have not registered as a Nokia publisher before or filled in your bank details for revenue payments, you need to do it at this point. See instructions for registering: Register to Nokia Publish tool.
  3. Select your content type: Nokia X - Standard Publish.
  4. Select Nokia X as content type.

  5. Answer the Legal questions. If there is encryption in your content, certain paperwork is needed if you distribute your content to the US.
  6. The page for defining content item metadata opens.

Define content item

  1. Fill in all the mandatory details in this form with the help from this quick guide, on-screen help texts, and the Nokia Store Publisher Guide. For example, add a name, description, and keywords for your content.
  2. Click Enable In-app payment if you wish to use the Nokia In-App Payment API.
  3. Define the Age rating for your content.
  4. Add icons and screenshots for your content. Read more about the requirements in Add icons and screenshots
  5. Click Create.

The content item is now created. Next you can add Nokia In-App Payment items, HERE keys, additional metadata, and after that upload the content files (.apk packages).

Add Nokia In-App Payment items

At this point you can add functionality or features purchasable from within your application with Nokia In-App Payment.

When you start to develop a Nokia In-App Payment enabled application, you should use test IDs for the Nokia In-App Payment items to avoid being charged when testing the purchase flow. Actual product IDs cost money whereas test IDs do not initiate financial transactions. For more information, see Product IDs for testing purposes.

Verify the Nokia In-App Payment functionality with actual product IDs before submitting your complete application to Nokia QA in the publishing tool. You get the IDs in the In-app payments tab in the publishing tool when you create the items. After the system has processed and published the items, you can use them in your application.

To submit the Nokia In-App Payment items to Nokia QA

  1. Go to the In-app payments tab.

  2. Fill in the fields. Follow the rules for, for example, the length of the texts in the on-screen help.
  3. Click Create. The publishing tool gets product IDs for your Nokia In-App Payment items.

  4. Copy the numeric Product ID or its alias to your application source files.

When the items have been published, you can test your application with the added Nokia In-App Payment items. If your application works, you can continue to submit the content files. More items can also be added afterwards.

Read more about Nokia In-App Payment items in Nokia In-App Payment Developer Guide.

Operators supported for operator billing on Nokia X software platform are listed country by country in table Supported operators for Nokia X software platform.

To set the price for your Nokia In-App Payment items

Select a price point from Free to one of the 15 pre-set price points for your Nokia In-App Payment items. Nokia has set prices for these points for each market, according to the local buying power. Note: only operator billing is supported for Nokia In-App Payment items.

You can check the prices for each market from Nokia Billing Matrix.

Note that you can only charge for Nokia In-App Payment items, otherwise Nokia X software platform apps are free.

Add HERE keys

If your application uses mapping and location features from HERE, do the following to get a HERE API key.

  1. On the HERE Maps tab, click Request HERE Maps Key.
  2. The tool gives you two keys: App ID and App code.

  3. Add the keys to your manifest file in the following format:

    <meta-data android:name="com.here.android.maps.appid" android:value="YOUR ID"/>
    
    <meta-data android:name="com.here.android.maps.apptoken" android:value="YOUR TOKEN"/>

Submit files to Nokia QA

You have now the following ready, and you can submit the content files to the system:

  • all necessary metadata defined,
  • Nokia In-App Payment items that have been through Nokia QA and added to the source files
  • HERE keys that have been added to the source files.
  1. Go to the Content files tab, and upload your .apk-file. Max size for the file is 500 MB.
  2. Click Validate to scan the files.
  3. If validation is ok, you can click Upload and continue.
  4. After uploading the files, page opens for defining the distribution.
  5. Select the available Nokia X phones for distribution and click Next.
  6. Select suitable country distribution and supported language(s) and click Save. The tool reviews your distribution settings and checks that there is a matching country in your distribution for each of the languages you have defined.
  7. You can now click the content item name to go back to the main view. In the main view you can review and edit the metadata, for example, add more screenshots.
  8. Click Submit to QA and the Nokia QA process starts.

Nokia QA

  • If there are no failures in the Nokia QA, on average it takes three to four business days to get your files and metadata moderated, tested, and published.
  • When the app has passed Nokia QA it is pushed to the Nokia Store servers through a scheduled export process.
  • If your content fails, you will get an email notification with details about the reasons for the failure, and you are asked to fix the problem and resubmit the content.

Avoid the common QA failures for Nokia X

The following list contains the most common reasons why apps submitted for Nokia X fail the Nokia QA.

  • The app cannot be launched successfully, or crashes after launching.
  • The app crashes, for example, while using its main features, or after tapping Full screen icon in a video playing page.
  • The app sound is not suspended when answering an incoming call.
  • The app does not response when short-pressing HW Back-key in app main-level, and the app itself does not provide the option to exit.
  • The game is not suspended after the device screen is locked. This causes multi-level games to be over after the device screen is locked, and the player must restart from the beginning.
  • App restarts automatically after locking/unlocking the device.

To avoid these issues, test your app thoroughly on the phone models you intended it for. If you don’t have access to all phones, you can use RDA, Nokia Developer Remote Device Access service, to test your app. See also Nokia X design guidelines.

View your app and download reports

You can view your published content in the device's Nokia Store client. Nokia X content is not viewable in the desktop web browser Nokia Store.

When your app is available in Nokia Store, you can start to view statistics such as downloads through your Nokia Publish account. To view the reports, click the Reports tab in your Publish tool.

You can view more detailed reports by clicking Detailed reports on the bottom of the page. For more information on the detailed reports, see View a detailed report for a content item in Publisher Guide.


Last updated 25 April 2014

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.

×