This page maintains the attributes for the application entry point. Since you can localize the entry point name, description, icon, and splash image, they appear in a detail view that's determined by your language selection on the Localization page.
|Category||<category>||Optional. Specify the BlackBerry Tablet OS home screen category
in which your application should appear. The value must be one of:
|Orientation||For Default, N/A , for Auto-orient: <autoOrients>true</autoOrients>, for Landscape: <aspectRatio>landscape</aspectRatio>, and for Portrait: <aspectRatio>portrait</aspectRatio>||Optional. Set the orientation for the application; the physical
orientation of the device. This orientation option provides you with
ways to control the rotation of the content on the screen so that
it's easier to view on the device:
|Chrome||<initialwindow> <systemchrome>||Optional. The type of system chrome to use (such as the borders,
title bar, menu bar, and window control buttons). You can specify:
|Transparent main window||<initialwindow> <transparent>||Optional. Specify whether the window is transparent. Only applicable when the Chrome field is set to none; otherwise, the window is opaque.||Not Selected|
|Permissions||<action system="true">run_native</action>||Request permission to execute native code; required for native applications.||Set by default.|
|Permission||<action>||Optional. Specify the device capability that your application
needs to access.
The BlackBerry Tablet contains functionality that can capture rich information from its environment, such as the GPS receiver, a microphone, and so on. To help protect against potentially malicious code, users must grant your application access to the functionality. For example, the user must grant your application permission to use the GPS or the microphone.
The BlackBerry Tablet OS prompts a user to allow your application to use any device capability you specify in this element. You can specify one action element per capability.
The permissions available are:
Permission settings can cause some unexpected behavior in your application. For example:
If an application uses APIs that access restricted functionality, and the application doesn't request access to a device capability, the APIs will return errors. For example, if you attempt to access a file in a shared folder without the access_shared capability, you will get a permission denied error on the open action. Your application must handle these errors gracefully.
|Select All||N/A||Select all of the permissions in the list; these are the permissions that are requested by your application.||N/A|
|Deselect All||N/A||Remove the selection for all permissions in the list; none of these permissions will be requested by your application.||N/A|
|Description||N/A||Descriptive information about a selected permission.||N/A|
|Entry point text and Images||N/A||Text and graphics that the BlackBerry Tablet OS's Navigator uses to represent your application.||N/A|
|Name||<name>||The name that's displayed in the BlackBerry Tablet OS application installer. May have multiple values for each language.||The file name associated with your project for your application.|
|Description||<description>||Optional. A brief description of your application.||The description you initially assigned to your project.|
|Icon||<icon><image>||The icon to display for your application in the BlackBerry Tablet OS home
screen. Your icon should be 86 by 86 pixels. The icon image format
is .png 24-bit with an alpha channel.
The icon must be included in your
.bar file, and can be a
.jpeg, .gif, or
An icon that's larger than 86-by-86 pixels can't be displayed on the screen. You specify the file name for the icon within the <image> element (e.g. <icon><image>icon.png</image></icon>). For more information about designing application icons, see the BlackBerry PlayBook Tablet UI Guidelines .
|Browse||N/A||Optional. Locate an icon that the system uses for the
application. The icon for your project can be a
.jpeg, .gif, or
You can drag the icon asset from the IDE's Project Explorer or from the host OS's file browser and drop it onto the Icon field.
|Clear||N/A||Clear the image selection you made for the application's icon.||N/A|
|Splash Screens||<splashscreen>||Specify the image to display while the BlackBerry Tablet OS loads
your application. 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 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
.jpeg, .gif, or
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.
You can drag the splashscreen assets from the IDE's Project Explorer or from the host OS's file browser and drop it onto the Icon field.