Localization tab

The Localization tab shows the options for localization support.

When you click Add, the Add Localizations dialog box includes all of the locales supported by the BlackBerry 10 OS. 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. In the bar-descriptor.xml file, this technique generates 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:

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

Screen showing the Localization tab of the bar-descriptor.xml file in the Momentics IDE.

Explore Localization tab specifications

Note:

Language (<packageLocale>)

Sets the languages used to localize your application. The language is set as: <packageLocale> Language_Code1,...,Language_CodeN </packageLocale>.

To open the Add Localizations dialog box from which you can select the languages that are supported by the target OS version, click Add.

To delete the selected language from the list, click Remove.

To specify an extra locale that doesn't currently appear in the Add Locations dialog box, use the Other field and click Add.

Note: If the name you specify doesn't conform to an IETF BCP 47 language tag, you receive a warning icon to the left of the field.

Note:

Entry-Point Text and Images

Information and images to provide to the device for the selected locale of your specific application.

Name (<name>)

The name displayed in the application setup application for the selected locale. The name might have multiple values for each language. The name is set as: <name> my_app_name <text xml:lang="language_code"></name>

By default, the name is set to the file name associated with your project for your application.

Description (<description>)

A brief description about your application for the selected locale. The description is set as: <description> my_app_name <text xml:lang="language_code"></description>

By default, the description is set to the description you initially assigned to your project.

Icon (<icon>, <image>)

The icon to display for the selected language in the BlackBerry 10 OS home screen. The icon must be included in your .bar file, and can be a .png, .jpg, .jpeg, .gif, or .bmp file. You can specify icons with different sizes for specific device resolutions.

You specify the file name for the icon within the <image> element (for example, <icon> <image> Image_Name <text xml:lang="Language_Code"></image></icon>). For more information about designing application icons, see Application icons in the BlackBerry UI Guidelines.

You can locate an icon that the system uses for the application by using the Add button. The icon for your project can be a .png, .jpg, .jpeg, .gif, or .bmp file. You can also drag the icon asset from the Project Explorer or from the file browser on your computer, and then drop it onto the Icon field.

Splash Screens (<splashScreens>)

The image to display while the device loads your application for the selected language. You can specify up to two files (used if your application supports rotation; one for each portrait and landscape orientation). If you specify one file, the device displays the file in a landscape orientation. If you specify two files, the first file is used when the device is in landscape orientation, and the second file is used when the device is in portrait orientation. The image for your splash screen must be included in your .bar file and can be a .png, .jpg, .jpeg, .gif, or .bmp file.

The screen resolution of your device can be found in Different screen sizes in the BlackBerry UI Guidelines. Your splash screen should be the entire resolution size to fill the screen.

You can drag the splash screen assets from the Project Explorer or from the file browser on your computer, and then drop it onto the Splash Screens field.