Localization page

This page shows the options for localization support.

When you click Add, the Add Localizations dropdown list includes all of the locales supported by the target OS version. The simplest mode of operation is one that is untranslated, in which you type the name, description, or image asset path without selecting a language. This generates in the bar-descriptor.xml file an element such as <name> that contains a single string. For translated content, you specify the text or asset for each language annotated by the language code. The result in the bar-descriptor.xml file looks like the following for US English and German:

<text xml:lang="en_US">...</text>
<text xml:lang="de_DE">...</text>

Option XML element Description Default
Language <packageLocale>Language_Code1,...,Language_CodeN"> Show the languages used to localize your application. N/A
Add N/A Open the Add Localizations dialog from which you can select the languages you require for your application that are supported by the target OS version. N/A
Remove N/A Delete the selected language from the list. N/A
Other Specify an additional locale that does not currently appear in the Add Locations dropdown list.
If the name you specify doesn't conform to an IETF BCP 47 language tag, you'll receive a warning icon to the left of the field.
Add N/A Add the new Other tag to the list. N/A
Entry-point text and images N/A Information and images to provide to the BlackBerry Tablet for the selected locale of your specific application. N/A
Name <name>my_app_name<text xml:lang="language_code"> The name displayed in the BlackBerry Tablet OS application installer for the selected locale. May have multiple values for each language. The file name associated with your project for your application.
Description <description>my_app_name<text xml:lang="language_code"> Optional. A brief description about your application for the selected locale. The description you initially assigned to your project.
Icon <icon> <image> Image_Name <text xml:lang="Language_Code"> The icon for the application for the selected language, which should be 86x86. The icon image format is .png 24-bit with alpha channel that is no smaller than 86x86, and no larger than 90x90; however, 86x86 is recommended. Note that .jpeg, .gif, and .bmp are also supported formats.

Specifies the icon to display in the BlackBerry Tablet OS Home screen. Your icon should be 86-by-86 pixels. An icon that is larger than 86-by-86 pixels can't be displayed on the screen. The icon must be included in your BAR file and can be a PNG file or JPG file. You specify the file name for the icon within an XML element named image. For more information about designing application icons, see the BlackBerry PlayBook Tablet UI Guidelines .

Splash Screens <splashscreen> Specify the images to display while the BlackBerry Tablet OS loads your application for the selected language. You can specify up to two files separated by a colon (:). If you specify one file, the BlackBerry Tablet OS displays the file in a landscape orientation. If you specify two files, the first file is used when the tablet is in an landscape orientation, and the second file is used when the tablet is in a portrait orientation. The image for your splash screen must be included in your BAR file and can be a .png file or .jpg file.

The screen resolution of the BlackBerry PlayBook tablet is 1024 by 600 pixels in default, landscape orientation. Your splash screen should be this size to fill the screen. The splash screen that will appear when your application launches. For best results, the size should be 1024x600.