How To - Articles

App Name, Icon, and Splash Screen

Three important aspects of your BB10 app are the name, icon and the splash screen (also known as the loading screen). They are the first three things a user will see when launching your app so they are important to have. The name will appear below the icon. The icon is the face of your app when users are browsing App World or once downloaded in their grid of icons. The splash screen is the first thing shown when a user launches your app.

App Name

To change the name of your BB10 app (by default it will be the name of your project), edit the bar-descriptor.xml file. You either adjust it on Applications tab (see image below) or in the Source add the tag: <name>My App Name</name>

BlackBerry 10 Cascades App Name

Icon and Splash Screen

The default icon and and splash screen look like the following:


They can also easily be changed in the bar-descriptor.xml file shown below:



Click on the "Application" tab (circled in green) then select an image for the icon (boxed in red) and splash screen image (boxed in blue). To select images click on the "add" button. In the popup you can either choose to select and image from your workspace (meaning it is in the project) or from the filesystem in your computer.  Once you have selected the appropriate image(s) it will appear in the path/size list.

Or for the purest you can add code into the the source of of the bar-descriptor.xml file using <icon></icon> and <splashScreens></splashScreens> tags.  However this is unnecessarily complicated.

Icons should be 114 pixels wide by 114 pixels tall.  Splash screens will be device dependent but since there is only the Dev Alpha with one resolution I will use that for the example.  For splash screens to be loaded in portrait mode they should be 768 pixels wide by 1280 pixels tall.  For splash screens to be loaded in horizontal mode they should be 1280 pixels wide by 768 pixels tall.