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!

Join the conversation

Show comments Hide comments
+ -