Publishing apps in BlackBerry World: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
=Publishing Applications in the BlackBerry world=
[[Category:BlackBerry]]
 
= Publishing Applications in the BlackBerry world =


This pages provides a quick run through the key topics which an application developer should pay attention to when switching from development mode into the released mode and preparing the application for publishing in BlackBerry World.
This pages provides a quick run through the key topics which an application developer should pay attention to when switching from development mode into the released mode and preparing the application for publishing in BlackBerry World.
Line 5: Line 7:
This article is a supplementary summary provided in addition to the following articles:
This article is a supplementary summary provided in addition to the following articles:


* [https://developer.blackberry.com/devzone/blackberryworld/getting_started_preparing_your_app_for_blackberry_world.html Getting Started] ''[developer.blackberry.com]''
* "Getting Started":https://developer.blackberry.com/devzone/blackberryworld/getting_started_preparing_your_app_for_blackberry_world.html
* [https://developer.blackberry.com/devzone/blackberryworld/faq.html <span class="caps">FAQ</span> for developers about BlackBerry World] ''[developer.blackberry.com]''
* &quot;FAQ for developers about BlackBerry World&amp;quot;:https://developer.blackberry.com/devzone/blackberryworld/faq.html  
* [https://developer.blackberry.com/design/bb10/ UI guidelines for BlackBerry 10] ''[developer.blackberry.com]''
* &quot;UI guidelines for BlackBerry 10&amp;quot;:https://developer.blackberry.com/design/bb10/
 
==Key meta information entries in the <span class="caps">BAR</span> application descriptor file==
 
The template of the <code>bar-descriptor.xml<code> file has dummy entries for many fields not relevant on the first steps in application development. You have to provide correct information before distributing the app for testing and submitting it for selling. </code></code>
 
A good overview of the of all important fields is available in [https://developer.blackberry.com/native/documentation/core/com.qnx.doc.ide.userguide/topic/capabilities_editor_options_base.html this article] ''[developer.blackberry.com]''. The below sections cover essentials only


===Author name===
== Key meta information entries in the BAR application descriptor file ==


Make sure that these fields match the ones you set in the Developer Certificate and in the debug token :<br />
The template of the &lt;code&amp;gt;bar-descriptor.xml&amp;lt;code&amp;gt; file has dummy entries for many fields not relevant on the first steps in application development. You have to provide correct information before distributing the app for testing and submitting it for selling.


You can use either Qt Creator or the Momentics <span class="caps">IDE</span> to read this data from a debug token. You can also look it up in the <span class="caps">MANIFEST</span>.MF in debug token <span class="caps">BAR</span> file. If those fields do not match you will not be able to deploy a signed application to a device.
A good overview of the of all important fields is available in &quot;this article&amp;quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.ide.userguide/topic/capabilities_editor_options_base.html. The below sections cover essentials only


===Versions===
=== Author name ===


* Make sure the [https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_versionnumber.html version number] ''[developer.blackberry.com]'' of your application is correct. Be aware that this number should match the information you supply to BlackBerry World
Make sure that these fields match the ones you set in the Developer Certificate and in the debug token :<br /><code><br />&lt;author&amp;gt;Name Surname&amp;lt;/author&amp;gt;<br />&lt;authorId&amp;gt;Your ID from debug token&amp;lt;/authorId&amp;gt;<br /></code>


* Supported platforms, see [https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_platformversion.html this] ''[developer.blackberry.com]'' article.
You can use either Qt Creator or the Momentics IDE to read this data from a debug token. You can also look it up in the MANIFEST.MF in debug token BAR file. If those fields do not match you will not be able to deploy a signed application to a device.


===Application icon===
=== Versions ===


The [https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_icon.html application icon for BlackBerry 10] ''[developer.blackberry.com]'' should be 114×114 pixels in <span class="caps">PNG</span> format.
* Make sure the &quot;version number&amp;quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_versionnumber.html of your application is correct. Be aware that this number should match the information you supply to BlackBerry World


===Splash screens===
* Supported platforms, see &quot;this&amp;quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_platformversion.html article.


A splash screen is shown just after the user taps on the application icon and kept on the screen all time before the application starts rendering on the screen. It is a good idea to define an image which should be shown as splash screen to improve the user experience. See [https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_splashscreens.html this article] ''[developer.blackberry.com]'' for more details.
=== Application icon ===


==Signing the application package==
The &quot;application icon for BlackBerry 10&amp;quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_icon.html should be 114x114 pixels in PNG format.


You can use the blackberry-signer tool from the command line:<br />
=== Splash screens ===


where <code>&lt;certificate_password&gt;<code> is the password you set while creating your developer certificate (stored in the <code>author.p12 file<code> in the keys folder), and <code>&lt;BB_ID_token_password&gt;<code> is the password you set when you generated the BlackBerry ID token (stored in the <code>bbidtoken.csk<code> file in the keys folder)</code></code></code></code></code></code></code></code>
A splash screen is shown just after the user taps on the application icon and kept on the screen all time before the application starts rendering on the screen. It is a good idea to define an image which should be shown as splash screen to improve the user experience. See &quot;this article&amp;quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_splashscreens.html for more details.


==Publishing to BlackBerry World==
== Signing the application package ==


This process is not different for Qt applications than for any other applications. See the following articles:
You can use the blackberry-signer tool from the command line:<br /><code><br />blackberry-signer -storepass &lt;certificate_password&amp;gt; -cskpass &lt;BB_ID_token_password&amp;gt; &lt;output_bar_file.bar&amp;gt;<br /></code>


* [https://developer.blackberry.com/devzone/blackberryworld/preparing_your_app_for_blackberry_world.html Setting up your app in BlackBerry World] ''[developer.blackberry.com]'' and all articles in this section
where &lt;code&amp;gt;&lt;certificate_password&amp;gt;&lt;code&amp;gt; is the password you set while creating your developer certificate (stored in the &lt;code&amp;gt;author.p12 file&amp;lt;code&amp;gt; in the keys folder), and &lt;code&amp;gt;&lt;BB_ID_token_password&amp;gt;&lt;code&amp;gt; is the password you set when you generated the BlackBerry ID token (stored in the &lt;code&amp;gt;bbidtoken.csk&amp;lt;code&amp;gt; file in the keys folder)
* [https://developer.blackberry.com/devzone/blackberryworld/preparing_an_app_release.html Uploading your release and adding digital goods] ''[developer.blackberry.com]'' and all articles in this section


===Categories:===
== Publishing to BlackBerry World ==


* [[:Category:BlackBerry|BlackBerry]]
This process is not different for Qt applications than for any other applications. See the following articles:<br />* &quot;Setting up your app in BlackBerry World &quot;:https://developer.blackberry.com/devzone/blackberryworld/preparing_your_app_for_blackberry_world.html and all articles in this section<br />* &quot;Uploading your release and adding digital goods&amp;quot;:https://developer.blackberry.com/devzone/blackberryworld/preparing_an_app_release.html and all articles in this section

Revision as of 06:38, 24 February 2015


Publishing Applications in the BlackBerry world

This pages provides a quick run through the key topics which an application developer should pay attention to when switching from development mode into the released mode and preparing the application for publishing in BlackBerry World.

This article is a supplementary summary provided in addition to the following articles:

Key meta information entries in the BAR application descriptor file

The template of the <code&gt;bar-descriptor.xml&lt;code&gt; file has dummy entries for many fields not relevant on the first steps in application development. You have to provide correct information before distributing the app for testing and submitting it for selling.

A good overview of the of all important fields is available in "this article&quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.ide.userguide/topic/capabilities_editor_options_base.html. The below sections cover essentials only

Author name

Make sure that these fields match the ones you set in the Developer Certificate and in the debug token :

<br />&lt;author&amp;gt;Name Surname&amp;lt;/author&amp;gt;<br />&lt;authorId&amp;gt;Your ID from debug token&amp;lt;/authorId&amp;gt;<br />

You can use either Qt Creator or the Momentics IDE to read this data from a debug token. You can also look it up in the MANIFEST.MF in debug token BAR file. If those fields do not match you will not be able to deploy a signed application to a device.

Versions

Application icon

The "application icon for BlackBerry 10&quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_icon.html should be 114x114 pixels in PNG format.

Splash screens

A splash screen is shown just after the user taps on the application icon and kept on the screen all time before the application starts rendering on the screen. It is a good idea to define an image which should be shown as splash screen to improve the user experience. See "this article&quot;:https://developer.blackberry.com/native/documentation/core/com.qnx.doc.native_sdk.devguide/topic/r_barfile_dtd_ref_splashscreens.html for more details.

Signing the application package

You can use the blackberry-signer tool from the command line:

<br />blackberry-signer -storepass &lt;certificate_password&amp;gt; -cskpass &lt;BB_ID_token_password&amp;gt; &lt;output_bar_file.bar&amp;gt;<br />

where <code&gt;<certificate_password&gt;<code&gt; is the password you set while creating your developer certificate (stored in the <code&gt;author.p12 file&lt;code&gt; in the keys folder), and <code&gt;<BB_ID_token_password&gt;<code&gt; is the password you set when you generated the BlackBerry ID token (stored in the <code&gt;bbidtoken.csk&lt;code&gt; file in the keys folder)

Publishing to BlackBerry World

This process is not different for Qt applications than for any other applications. See the following articles:
* "Setting up your app in BlackBerry World ":https://developer.blackberry.com/devzone/blackberryworld/preparing_your_app_for_blackberry_world.html and all articles in this section
* "Uploading your release and adding digital goods&quot;:https://developer.blackberry.com/devzone/blackberryworld/preparing_an_app_release.html and all articles in this section