Creating a Debug Version of your WebWorks Application for Built For BlackBerry

Web Development

Well, here it is: the beginning of a new year, and the launch event for BlackBerry 10 is less than a month away. If you’re like me, you’re pretty pumped and probably really busy, particularly if you are creating a Built For BlackBerry application. In order to qualify for the 10k Developer Commitment, all Built For BlackBerry applications must be submitted for testing by January 21st, 2013. If you’re building a BlackBerry WebWorks application, there’s an extra step involved that you may have missed.

Recall that Built For BlackBerry applications go through two rounds of testing. The first round is the standard BlackBerry World testing that all applications must pass before they are allowed in BlackBerry World. This testing must be completed before you submit your application to Built For BlackBerry testing. We strongly encourage you to have your application submitted to BlackBerry World testing by January 11th, 2013. Once your application has passed BlackBerry World testing, you submit it to Built For BlackBerry testing. However, if you are building a BlackBerry WebWorks application, you don’t submit the same binary.

That’s right, in order for our testing agency to complete the Built For BlackBerry testing on BlackBerry WebWorks applications, we need you to submit a debug version of the application. Don’t panic – this is very easy to do and you can create the debug version the same time you create the non-debug version.

Perhaps the simplest way to create the debug version of the application is to use the Apache Ant build script. But if Ant just ain’t your thing, no worries – you can create your debug application using the command line packager bbwp. All you have to do is pass the debug switch (-d) like this:

bbwp “c:\myapp\” -d -o “c:\myapp\debug”

The bbwp script takes the name and location of the application archive as the first argument: here c:\myapp\ The -d switch tells the script to enable Web Inspector, thus creating a debug version of the application. The -o switch specifies the output directory for the bar file. That’s it! You now have a debug version of your application. Finally, make sure you sign the debug version of your application.

You now have two identical copies of your application. You have the non-debug version that is created without the -d, and a debug version which is created with the -d option. The non-debug version is the one you will submit to BlackBerry World testing. Make sure you do not submit the debug version to BlackBerry World testing. Once your application passes, you need to submit the debug version to Built For BlackBerry testing.

Log into the BlackBerry Vendor Portal and navigate to the manage products area. Make sure your application is Up For Sale in BlackBerry World. Then select Add Release and upload the debug version of your application.


Enter “Debug” in the Release section and select Apply for Built For BlackBerry. Read and agree to the Built For BlackBerry and 10k Developer Commitment terms and conditions and click Save. That’s it, you’re all done. Congratulations, your BlackBerry WebWorks application is now correctly submitted!

About Tom Anderson

Tom Anderson – Senior BlackBerry Developer Evangelist – Tom started his career in 1986 with Microsoft Corporation where he was a Program Manager on such products as Windows 3.11, Windows for Workgroups, Windows 95, and Internet Explorer. He was also the creator of the Windows Resource Kit which began that product line. In addition, Tom presented at many trade shows and gave technical presentations with the Microsoft Executive Staff. He left Microsoft in 1995 to form Three Points Consulting with Marianne Reid Anderson and Bob Taniguchi. Three Points focused on bringing the power of the emerging internet technology to everyday life. Tom’s innovative technology solutions played a key role in the successful acquisition of Three Points by TechRx. At TechRx, he acted in the role of CTO until it was acquired by NDC Health of Atlanta, Georgia. In 2004, Tom decided to become a High School Teacher as his primary method of giving back to the community. In 2005 he joined the Pennsylvania Cyber Charter School (PA CYBER) where he was awarded the Keystone Award for Innovative Use of Technology in the Class Room. During this time, he also earned a Master’s degree in Software Design through Capella University. In 2009, in addition to teaching, Tom returned to software development creating various web and mobile applications.

Join the conversation

Show comments Hide comments
+ -
blog comments powered by Disqus