Creating A WebIcon; :: BlackBerry Application Development Tutorial; (Part-4)

Aasim Naseem 20

Hello All;
Hope enjoying the world around you;

Surprised;?? I know; After a long time im here writing a tutorial on blackberry development; It is a requested tutorial, asked by some developers few days back; So here it is;

Note: This tutorial is a part of serieis of my tutorials on blackberry application development; So far we have discussed the followings.

My friend has a problem; He visits a site many times a day; Every time he has to open browser, type the site name or chose from favorites to see it; He asked what if there is an icon on my home screen that directly open a browser and navigate to that particular site; By doing this, i need just one tap, just one;

Solution is Web Icon; How?  I”m telling you next. First bring a cup of coffee or tea whatever you like; I brought a cup of Qehwa (a local drink for winters) with two chocolates; Bryan adams is playing in background; Sit relax;

Here we go; A web icon is an application that launches a BlackBerry smartphone browser to a predefined web address; Web icons aredisplayed in the list of BlackBerry smartphone applications and they can be used as shortcuts to a BlackBerry smartphone user’s favorite web sites;

Lets start; The first thing is to create a new class that extends from WebIcon; Here I’m dividing talk in two parts; Frist for the devices earlier to 4.0 and second part is for 4.1 and laters;

1. BlackBerry Device Software earlier than 4.0

When using BlackBerry Device Software versions earlier than 4.0, the default browser is the only one that can be invoked;

As an example, a new class called BlackBerryWebIcon is created below that extends WebIcon and points to my blog,; Only three lines of code need to be added to the main method of this new class.

2. BlackBerry Device Software 4.0 and later

The previous sample can also be used for BlackBerry Device Software up to and including 4.2.1, although the following code samples offer a simpler methodology for allowing the web icon to invoke the default browser or invoke specific browsers on the BlackBerry smartphone;

A web icon may invoke either the default browser on the BlackBerry smartphone, or the Internet Browser, the Wireless Application Protocol (WAP) Browser, the BlackBerry® Browser, the Wi-Fi® Browser, or the BlackBerry® Unite!™ Browser.

The following code creates a web icon that launches a browser to a specific web address for the given browser type;  If the given browser type is not available, the web icon launches the default browser;

Note: The previous code sample makes static calls to a factory class called BrowserSessionFactory to create these different BrowserSessions; One thing more ist that BlackBerry Device Software 4.2 may prevent the previous code sample from opening the default browser; As a workaround, add the following code after the call to the displayPage method; This issue was resolved in BlackBerry Device Software 4.2.1;

As an example, a new class called BlackBerryWebIcon is created in the following sample that extendsWebIcon and points to my blog,;. Again, only three lines of code need to be added to this new class.

At this point we are get done with code; Thumbs up; Plus its time to change Bryan adams; Let try some slow number of  richard marx;

Orite, next is to set the title of your application, as this title will be appears on the Home screen of the smartphone  user scrolls over the icon; To to this, right-click the project, select Properties and then select the General tab; In this area, you can type the application title, vendor name and application description;

Done; ?? great; Now next is to add an application icon; This is the icon that displays on the Home screen of the BlackBerry smartphone; Do  the following steps:

  • Create an image, approximately 32 x 32 pixels in size.
  • Right-click the project, select Add File to Project, and then navigate to the custom icon.
  • Once the file is added, right-click the file, and then select Properties.
  • Select the check box for Use as Application Icon.

Congratulation; You have done; Isn’t that simple; ?? Indeed it is; Make victory sign; Compile and deploy on your phone;

Feel free to throw queries incase you found a problem;
Have a nice time;

Happy Development;


free counters

Comments 20

    1. ye Mr Ans hain ye kch b ker sakty hain kisi b time. Aj ye iPhone my hy kal ye android my ho ga person kisi or chez my. He will get mad one day. itni c jaan hy is ki.

  1. Ans bahi you great. Everytime you bring a detail words about something interesting. good work. im working in C# now a days. need little help.
    well you are guro no doubt. dnt know how you move take different things parallel.

  2. Really guys, Nice Article and its very important for me because I am a new in Mobile Application Development and your others blog Posts really help me, Pls share another article on a new Tech of Blackberry Playbook Development. Thanks a lot…

  3. i would like to create server vs client application with the basic start to access to a file or folder on a set location and then byextentions a form of remote desktop application concepts can u advise were to get started

  4. I Dint Understand this program….part3 was so simple and part4 was v difficult…many builtin functions which require a prior knowledge am i ri8?

  5. Does anyone know a way we could do this but instead of opening up a web URL have the icon open up a static HTML file that is packaged with the application? WOuld love to do this for an emergency contact list I have created. As the list changes I could just re-push the app a couple times per year.

  6. i am experiencing “BrowserSessionFactory cannot be resolved” . Do you have the code for this class as it pertains to this tutorial?
    Thank you,

    1. one option is you hire or outsource someone and pay one once to develop your application; Once it ready you can push it to blackberry store and can earn money when people download it or use in-App purchases;

  7. Hi Aasim,
    How do I remove a system menu item? lol, finally got the programs signed and running on my phone. There were some other tutorials that I also followed. Here is the link to the tutorials:

    My question is: How do I remove a system-wide menu Item? I’m going to keep digging but figured if you knew maybe you could help me.
    Have a great New Years!

Leave a Reply

Your email address will not be published.