A couple of nuances that I’ve come across with using the PlayBook SDK from the command line include both the need to pass a boat-load of parameters and a lack of documentation on just how to use them. Through a bit of trial and error, I managed to get debugging with the command line tools to work and finally decided to automate some of the effort by using Apache Ant.

Apache Ant is a build tool similar to Make that facilitates the automation of the compilation and installation processes involved in building programs. Ant is also really simple to use.

I’ve decided to share my Ant build.xml file template for PlayBook application building. It’s fairly straight forward. Hopefully the following instructions (and video) will help you use the template. Note that these instructions do assume that you can already build and package swf and bar files and have already been able to successfully deploy to the PlayBook simulator.

You can download the build.xml template here. (updated Jan 12-2011 to work with Beta 2 simulator and to add better automated debug support)

Also, note that this build.xml template works only with Windows. It will not work with Mac or Linux.

To Get Ant Setup:

1. Download the Apache Ant .zip archive from here: http://ant.apache.org/bindownload.cgi
2. Extract the zip archive to somewhere on your system
3. Add the Ant bin directory to your System Path. (Control Panel -> System -> Advanced tab -> Environment Variables -> Find the Path variable and add the path to the Ant bin directory)

To Use the Ant build.xml File:

1. Rename the build-template.xml to build.xml and place it in your src directory.
2. You will have to modify the first 5 property tags and set the values as necessary.
3. If your package (bar file) requires files or directories other than the .swf file, you will need to add them at line 34. Uncomment the last couple of arguments in the package target and modify them or delete them or add more as necessary.
4. To execute a build target from the command line, type “ant “. So, for example, to build the packagerun target, you type “ant packagerun”.

The following targets are included in the file:

• build-debug
• build-release
• package
• deploy
• run

There should also be a packagerun target that calls, in order, build-debug,package,deploy and then launches the app.

4.  If you would like to create a debug session, open another command prompt and type “fdb”. This will start the Flex debugger. Once open, type “run” before launching your PlayBook app from the command line. Once the app is launched, the debugger will break. Type “continue” and the debugger and app will continue. Trace statements will be output to the debugger session – as will errors. Further documentation on using fdb (setting breakpoints and stuff) can be found on the adobe docs website.

Here’s a video of me using Ant for an app I’m working on. Click on it to watch at Vimeo.com and see it in HD. Otherwise it’s difficult to see the text. Cheers!

You are likely registering the keyboard listener too early. It’s likely that you are calling an init() method where you register the keyboard event on creationComplete. Instead, call the init function later on. Try registering the event in the applicationComplete event handler.

More info here:
http://www.adobe.com/cfusion/communityengine/index.cfm?event=showdetails&productId=2&postId=304