Blackberry Tablet OS
Table of contentsPrerequisites
There is a few things to do before being able to build an application for Blackberry target :
Please refer to ShiVa Authoring Tool Installation, Blackberry part for more details.
A game in ShiVa Editor is made of various files : 2d media, 3d media, audio and scripts.
You must export all these files into a unique .stk file. For that, in the Game Editor Module in ShiVa Editor, select option to export the game as a run-time package. ShiVa Editor will produce a single .stk file. Select this file in the Application Pack field.
Format : the icon must be a png file 86x86px.
Guidelines : you may want to follow the Blackberry UI design guidelines described here : http://docs.blackberry.com/en/developers/
Format : the image must be a png file 1024x600px.
To use this feature, when exporting the game in Shiva Editor, check option “Runtime package ( stk and cpp source )” as shown in picture below.
Shiva Editor will generate a .stk package (that does not contain any lua code) and a folder containing your lua code converted into C++. You must add these C++ files manually in the Content panel so that the Authoring Tool builds them as part of your application.
Using native code feature gives you a chance to modify the generated C++ files before adding them in the panel. This has two main purposes:
Note: every time you export the game from Shiva Editor, the C++ files are generated again. That may overwrite the changes you made to these files.
Use the application.getPackDirectory function to get the absolute path of the files and load them while application is running.
Warning: as step 2 and step 3 are optional, Authoring tool does not display the 'Next' button to reach them. Instead, to reach 'Step 2' and 'Step 3' panels please click the panel name on top of Authoring Tool window.
Authoring type is the type of the generated application as follows:
Unique identifier used to generate the project, usually com.yourname.app.yourapplicationame, must be lowercase.
Application vendor, for instance, your company name.
Application version : of the form x.x.x, used as follows. This is the version the end user will see.