How to get your app published quickly

Cao Thai Phong Technical Support Manager Nokia, Indochina

1

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Nokia Publisher guide
Finally the Nokia Publisher guide in Vietnamese is out: http://support.publish.nokia.com/wpcontent/uploads/2012/02/R19.8.2_Nokia_Publis her_Guide_VI.pdf It covers most important things you should know before publishing your app to Nokia Store: • • Steps to register a Publisher account How to submit a new application in each platform (Java, S40 Web App, Qt Based, Symbian) Ways to promote your app Analyzing Nokia Store reports efficiently

• •

2

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Global Price Point

1 EUR  5.000 VND 2 EUR  10.000 VND 3 EUR  15.000 VND

Operator Billing NOW live in Vietnam!

3

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Application Signing

Java supporting documentation and detail of content submission http://www.developer.nokia.com/Distr ibute/App_Declaration_Document_v2. 4.pdf Flow diagram http://support.publish.ovi.com/wpcontent/uploads/2011/03/Sample_Di agram1.png Upload a .zip file containing both to the Additional Documentation field in your content file.

The publisher provides up to five phone IMEI’s to be used to create a certificate installer for the Publisher’s phones to Nokia Developer Support (developer.support@nokia.com). Nokia Publisher Support sends the Publisher a list of UID’s, a certificate installer, and a developer certificate/key pair for testing a qualified app. Additional UID’s can be requested by contacting Nokia Developer Support. The publisher packages the app's unsigned SIS file using the UID provided and tests it on a phone and against the Symbian Signed Test Criteria. The publisher submits the app (the unsigned SIS file with the UID provided) using Nokia Publish site

4

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Remote Device Access
Remote Device Access (RDA) is a service that allows developers to test their mobile applications and services remotely on various Nokia devices based on Symbian and Maemo OS. The main features of the service are remote controlling a device, installing and running applications, transferring files, and analyzing log files in real-time. RDA is an Internet-based solution and the basic requirements for using the service are • • • A Nokia Developer website user account A standard Web browser Java Web Start (comes typically with JRE; version 5.0 or newer is required)

Usage is free of charge for all Nokia Developer members.

5

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Publishing
Issue #1 – Not having a support website
Description
For games and applications, a valid support website is required to provide our end users with a support channel for troubleshooting purposes.

Failed cases
• • • • Invalid support website Page contains any link to external websites Page contains advertisement about competitor applications Create a support website that:  Has valid contact information such as support email address  Should include introduction about the main features and how to use them Sample support website: https://sites.google.com/site/khmermeego/

Solution

6

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Publishing
Issue #2 – Not having a device marked “FULLY TESTED” per platform
Description
Publishers are responsible for ensuring their application fully functions on at least one device. For each platform you wish to distribute your content you must have at least one device FULLY TESTED.

Failed cases
• • • • • Some platform in Distribution does not have FULLY TESTED device Press Edit File button Check the Compatibility declarations for each platform of devices Select device compatibility FULLY TESTED for at least one device in the platform Press Submit changes to QA button

Solution

7

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Publishing
Issue #3 – The selected language and country distribution do not match
Description
When you upload content to Nokia Store, the country and device distribution you choose must correspond to the language used in your content.

Failed cases
• • • Distribute content to a country that is not listed for your language If you want to distribute your content globally to all countries, the content must be in English If the content is in another language, you may distribute it to specific countries only, which are listed in the Language region distribution mapping:  English: Global  English (US): Canada, US  Vietnamese: Vietnam

Solution

8

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Publishing
Issue #4 – Local application doesn’t appear in search result of Nokia Store on supported device
Description
The published application shows up in search result of Nokia Store on PC but it becomes invisible on supported device.

Failed cases
• • Users won’t be able to download it For applications published in Vietnam country, make sure to also select English language. So there will be Vietnamese and English are marked in language section

Solution

9

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Technical
Issue #5 – The content does not display correctly when it changes orientation from portrait to landscape
Description
Content is not required to switch from portrait to landscape mode when the consumer turns the device sideways. However, it shouldn’t cause bugs when orientation changes.

Failed cases
• In landscape mode, the side of the image must not be cropped. The display image must always use the full screen area available

Solution
• • The display can remain permanently locked in either portrait or landscape mode The display must scale properly

10

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Technical
Issue #5 – The content does not display correctly when it changes orientation from portrait to landscape
Reference
Qt • • • • • http://www.developer.nokia.com/Community/Wiki/CS001514_-_Rotate_picture_in_Qt http://www.developer.nokia.com/Community/Wiki/CS000866_-_CBitmapRotator http://www.developer.nokia.com/Resources/Library/Symbian_Design_Guidelines/rotation.html http://library.developer.nokia.com/topic/S60_3rd_Edition_Cpp_Developers_Library/GUIDB02C762B-C452-4184-ABEA-4753E6CD47D2.html http://www.developer.nokia.com/Community/Wiki/CS001438_-_Listening_for_screen_ orientation_change http://www.developer.nokia.com/Community/Wiki/CS001263_-_Rotating_images_in_Java_ME http://harmattan-dev.nokia.com/docs/library/html/guide/html/Developer_Library_Best_ practices_for_application_development_Controlling_rotation.html Symbian

Java • • MeeGo 1.2 Harmattan

11

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Technical
Issue #6 – The content does not use the full screen area
Description
The content must always use the device screen to its full extent.

Failed cases
• The content doesn’t fill the entire display area or cropped

Solution
• The display must scale properly

12

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes - Technical
Issue #7 – When the content is suspended in the background, the content sound is not disabled
Description
Sound from the content should not play when it is suspended unless the content is a music player or a radio app.

Reference
Qt • • http://doc.qt.nokia.com/4.7/phonon-audiooutput.html http://www.developer.nokia.com/Community/Wiki/TSQ001585_-_Detecting_focus_lost_&_ gained_events_in_Qt_for_Symbian http://www.developer.nokia.com/Community/Wiki/Detecting_Focus_Change http://library.developer.nokia.com/topic/Java_Developers_Library/GUID-574FCC00-89F1-4A21BE03-3BB5D4151DE3.html http://harmattan-dev.nokia.com/docs/library/html/guide/html/Developer_Library_Application _development_framework_Application_lifecycle.html
© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Symbian • • Java

MeeGo 1.2 Harmattan •

13

Company Confidential

Common mistakes – Technical (Java)
Issue #8 – The MIDlet-Name parameter in the .jad file uses nonalphanumeric characters (S40 devices only)
Description
For Java apps that are destined for S40 devices, the MIDlet-Name parameter in the .jad file must use the following characters only: (A – Z), (a – z), (0 – 9). You may use spaces between characters but you cannot, for example, use (:), (;), or (‘).

Issue #9 – The app submitted for signing does not include About, Help, or Exit options
Description
If you are submitting a Java app to be signed by Nokia, the app must include About, Help and Exit options. If you are submitting an app that is already signed, you do not need to include these options.

14

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes – Technical (Java)
Issue #10 – The submitted flow diagram is not accurate
Description
The flow diagram is used for testing purposes and should include information such as the navigation of all operational flows, display of all screens, activation of main features, triggering of main events, etc.

15

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes – Technical (Java)
Issue #11 – Missing MIDlet-Permissions in jad file when using special APIs
Description
Before testing, Nokia QA always signs jar/jad files. When running signed jar/jad files on device, if the application uses any special API (network connection, bluetooth…) without declaring it in MIDlet-Permissions, that API will be blocked.

Failed cases
• The application runs well on publisher’s device but freezes or hangs in QA testing. The main cause is usually network connection is blocked so it keeps connecting to any website Declare appropriate APIs in MIDlet-Permissions field in the jad file:  MIDlet-Permissions:javax.microedition.io.Connector.socket, javax.microedition.io.Connector.http  MIDlet-Permissions:javax.microedition.io.Connector.bluetooth.client, javax.microedition.io.Connector.bluetooth.server

Solution

16

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes – Technical (Java)
Issue #12 – The touch screen keypad is not disabled by default (S60 devices only)
Description
For devices that have both a touch screen as well as a mechanical keypad, the touch screen keypad must be switched off by default. Also, the consumer must be able to play the game or app without using the touch screen keypad.

Solution
To turn off the touch screen keypad by default in Java: 1. Open the application .jad file 2. Add a parameter called Nokia-MIDlet-On-Screen-Keypad. 3. Set this parameter to no, that is, Nokia-MIDlet-On-Screen-Keypad: no 4. Save the changes

17

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes – Technical (Symbian)
Issue #13 – The content does not prompt for an installation drive
Description
The installation process should prompt the consumer to choose a drive on which to install the content.

Failed cases
• The Symbian package file hardcodes the installation drive. Be aware that some older Qt tools generate a Smart Installer wrapper package file that hardcodes the installation to drive C. For example, specifying c:\private\2002CCCE\import\MyApp.sis means that the Smart Installer always installs MyApp to drive C once the content is downloaded from Nokia Store. Use the “!” character in the directory path for the installation. This allows the content to be installed on the consumer’s preferred drive: !:\private\2002CCCE\import\MyApp.sis

Solution

18

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Common mistakes – Technical (Symbian)
Issue #14 – The package file specifies the incorrect operating system
Description
The platform identification code (Platform ID) is used during installation to check the compatibility of the app and the operating system. If the Platform ID in the .pkg file is incorrect, the device displays an error message during installation, even if the app and the device are compatible.
; Example package file showing specifying "Platform1" ; Languages supported &EN ; Localised vendor name %{"Symbian Software Ltd."} ; Global vendor name :"Symbian Software Ltd." ; Standard PKG file header #{"ExampleForPlatform1"}, (0x12345678), 1, 2, 3 ; Can only be installed on a Platform1 device, any version. ; The UID, (0x00001000) identifies the target hardware/UI platform. ; Refer to the Nokia website for correct values. [0x00001000], 0, 0, 0, {"Platform1ProductID"}

List of Symbian Platform codes: http://www.developer.nokia.com/Community/Wiki/S60_Platform_and_device_identif ication_codes
19 © Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Publisher support channels
At the moment, Nokia offers many helpful channels which can provide you with the best support. Therefore make sure to leverage on all of them: • Wiki • Discussion Board • Facebook • Live chat • Email

20

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Publisher support channels
#1 - Try searching for your solution on forum and wiki
• • Discussion Board http://www.developer.nokia.com/Community/Discussion/index.php Wiki articles http://www.developer.nokia.com/Community/Wiki/Wiki_Home

21

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Publisher support channels
#2 - Post your question on Discussion Board
• Discussion Board http://www.developer.nokia.com/Community/Discussion/forumdisplay.php?154Development-Platforms There are many experts who can provide you the necessary answer. It’s important that you need to post your question in the right category

22

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Publisher support channels
#3 - Facebook
• Ovi Developers  Go to https://www.facebook.com/groups/126684805051/  Post your question in the group, remember to tag Andrew AtNokia  Nokia specialists will try to provide the answer within one day

23

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Publisher support channels
#3 - Facebook
• Vietnamese Nokia Developers  Join us at https://www.facebook.com/groups/viet.nok.dev/  Post your question in the group  We’ll try to answer you as soon as possible  And Vietnamese is warmly welcome!

24

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Publisher support channels
#4 – Live Chat Support
Chat support agents are now available and will be offering publishing assistance on the Ovi Developer group in Facebook every Monday and Friday from 00:00 to 08:00. Look out for our support specialists who will be providing instant responses for your publisher questions. Facebook Group: Ovi Developers Support Specialist: Andrew AtNokia

25

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Publisher support channels
#5 – Email to Nokia Publish Support
• Write your questions in an email and send to developer.support@nokia.com

26

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Useful links:
• • Frequently asked questions: http://support.publish.nokia.com/?cat=6&topic=50 Application Signing questions: http://www.developer.nokia.com/Community/Discussion/forumdisplay.php?218-ApplicationSigning&sf3012415=1 Guide to publishing Qt Applications: http://www.developer.nokia.com/Community/Wiki/Guide_to_Publishing_Qt_Applications_to_the_O vi_Store Device specifications: http://www.developer.nokia.com/Devices/Device_specifications General Payment topics: http://www.developer.nokia.com/Community/Discussion/showthread.php?230644-FAQ-GeneralPayment-Topics&sf3012665=1 Publisher Support: http://support.publish.nokia.com/?p=3152&type=alert&sf3012265=1

• •

27

© Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential

Thank You

phong.cao@nokia.com
28 © Nokia 2012 How to get your app published quickly v.1.0 2012-03-06

Company Confidential