Weekend Coder: App Name, icon, and splash screen

By Brian Scheirer on 20 Oct 2013 02:52 pm EDT
2
loading...
19
loading...
38
loading...

Three important aspects of your BlackBerry 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 BlackBerry 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 Cascades 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>

Icon and Splash Screen

The default icon is a generic box icon and you would never want that. As for the splash screen, it is a dark gray background and says "BlackBerry" which looks something like this:

I see many apps use this and look fine. But its nice to greet your user with something unique. Or another good tactic is to have the splash screen the same background as your app's UI so it gives the illusion of your app loading faster than it does.

Just like the app name, these 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 an image from your workspace (meaning it is in the project) or from the file system in your computer.  Once you have selected the appropriate image(s) it will appear in the path/size list.

Or for the purist you can add code into the the Source tab of the bar-descriptor.xml file using <icon></icon> and <splashScreens></splashScreens> tags.

Icons should be 114x114 pixels for Z10, Q5, and Q10 and 94x94 pixels for Z30. Splash screens will be device dependent so I currently only have one loaded for the Z10 (1280x768). 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 landscape mode they should be 1280 pixels wide by 768 pixels tall. If I wanted different ones for the Q5/10, then I'd need add a 720x720 image. Similarly, for the Z30, a 1280x720 image.

30 comments

STV0726

Gut zu lesen, Herr Scheirer!

-STV on Z10STL100-3/10.1.0.4780 TMO US

AppReview

Woher commen zie?

Posted via CB10

Loc22

Great tip, thanks. I'm trying to be a developer as well but I have problems loading the cascade compiler on to my computer. Do you also have any tips for that? Thanks in advance.

Posted via CB10

itzJustMeh

You have problem with a compiler? Get QNX Momentics https://developer.blackberry.com/native/downloads/ and then Window->Preferences->BlackBerry->API Level and click "Get more".

shupor

Huge fan of the weekend coder series. Thank you :)

Posted via CB10

bbschorsch

Is there a simple way of extending the starting time of apps?

Posted via CB10

jeroen_13

no, but you can use the 'blackberry text' as (short) splashscreen and than display your own screen in your app

bbschorsch

Cascades 10.3 should provide a simple way...

Posted via CB10

RedxD

Put all the processing(or a QTimer) you need to do in the ApplicationUI constructor but extending the time is something that you shouldn't do, users want apps that open fast lol

lover boy1

How i run android apps on blackberry aome one tell me plz

Posted via CB10

snksvr

Great, thanks!

Posted by CB10 on my Z10

lover boy1

Nd by bb z10 switchoff at 25 %battery why????

Posted via CB10

KermEd

Why post here? Lol

Posted via CB from my LE

gyubok

It would've been much more interesting post if it discussed the making of app name, icon, and splash screen. From end users and developers perspective.

Maybe the topic of your next post? Pretty please :)?

Posted via CB10

Puz_zled

Great series of posts! Thanks Brian!

Swiped with one thumb from the virtual keyboard of my awesome Z10!

thecsman

Hi Brian, is there a place where we could see all the article series?

Posted via CB10

zten

Coding for blackberry is dead

Posted via CB10

thecsman

Easy there, troll, you knew you couldn't get into programming with poor reasoning skills.

Posted via CB10

Xandrex_BSCF

I guess zten probably forgot the last word in the sentence.
"Coding for Blackberry is dead sexy"

KermEd

Too true! :)

Posted via CB from my LE

hauger

Thank you for the article, I'm working on an app and managed to figure out most of these things, but I'd love to see more articles like this one, dealing with basics like navigating between sheets and format the navigation bar.

Posted via CB10 using my Zed Ten

LoganSix

I guess you weren't trying for the Red Zed Ten or maybe you already have one.
I tried to get mine in on Saturday, but I don't think I'll make the deadline for today.

But, for NavigationPane and sub pages, I wrote up a little tip.
http://deanlogic.com/2013/09/adding-pages-to-navigationpane-as-an-object/

slagman5

Speaking of app coding, anyone else's CB app getting hard to refresh? I have to pull down very far and multiple times to get it to refresh now...

Posted without the aid of AutoCorrect with my physical keyboard via CB10

kenmaster86

BlackBerry please we need tango on blackberry

Posted via CB10

Bikram Kochar

Its nice but.. at the same time it has no ise for me..

Posted via CB10

LoganSix

Just found out, don't name your app with "BB10", you have to use "BlackBerry 10".