Web and WebWorks Development

[calebhamilton]

I am not sure if I am missing something obvious here, but I can not figure out how to integrate the BBM SDK for Webworks into my project.

I have downloaded the .zip and tried the following things.

1) Compiling the contents of /ext into a .jar file and importing into my webworks project's /ext directory

• This allowed my config file to see blackberry.bbm.platform and add it as a featured
• This resulted in about 100 errors when running my app such as:

-package net.rim.blackberry.api.bbm.platform.io does not exist

-cannot find symbol
symbol  : class FunctionSignature

-cannot find symbol
symbol  : class ScriptableFunctionBase

..etc

2) "Installing" (extracting) the /ext folder into my base webworks installation folder

• This seemed to do nothing at all; my project config did not see the blackberry.bbm.platform feature.

I have tried getting the sample projects working by following the guide in these forums, but whenever I run them I get runtime errors in the log about blackberry.bbm.platform.(anything) not being resolved as a type.

If anyone knows of a good resource for getting this functioning please advise. The link to the guide only talks about running simulators which I really don't care about at this point in time.

[astanley]

Setting up you BlackBerry Messenger SDK development environment is critical.

If you have not already done so, make sure you follow the steps in the BlackBerry Messenger SDK - Getting Started Guide - BlackBerry WebWorks SDK for Smartphones document.  Specifically, ensure that MDS is configured to use unlimited strength encryption, and that the blackberry.bbm.platform folder is deployed correctly into the /bbwp/ext folder on your development machine.

To address your comments:

>> Compiling the contents of /ext into a .jar file and importing into my webworks project's /ext directory

No you do not need to compile anything.  Copy the entire blackberry.bbm.platform folder into the /bbwp/ext folder (see instructions above).

>> "Installing" (extracting) the /ext folder into my base webworks installation folder

Close - but no extracting necessary.  See instructions above.

Next, I put together the following Walkthrough guide on how to get started with the sample application:

http://supportforums.blackberry.com/t5/Web-and-WebWorks-Development/Getting-Started-BlackBerry-WebWo...

Please let me know if this guide is helpful.

Thanks,

Adam

[calebhamilton]

Thanks for the response!

I think my confusion was around what the /bbwp/ folder is.

I have found bbwp.exe and created an /ext folder in that directory. I am assuming this is correct, and I will post results soon.

[calebhamilton]

Putting the blackberry.bbm.platform folder into /ext/ in the directory of bbwp.exe did not show blackberry.bbm.platform as a feature when I went to add features in the config file.

Where is the /bbwp/ext folder that you are talking about above?

[astanley · Accepted solution]

>>  did not show blackberry.bbm.platform as a feature when I went to add features in the config file.

Ah I think I understand the issue.  If you are using the WebWorks Plug-in for Visual Studio or Eclipse, the reason why the BBM package name is not being recognized is because these plug-ins do not support the BBM SDK.

In fact, the plug-ins recently received an end-of-life announcement:

http://devblog.blackberry.com/2011/06/blackberry-webworks-tooling-evolved/

You will have to edit the config.xml file manually, and add a feature element for the blackberry.bbm.platform API like this (note the BBMPlatformDemoWW sample application included in the BBM SDK for WebWorks demonstrates how to do this):

<?xml version="1.0" encoding="UTF-8"?>
<widget xmlns="http://www.w3.org/ns/widgets" xmlns:rim="http://www.blackberry.com/ns/widgets" version="1.0.0.0">
  <name>BBMPlatformDemoWW</name>
 <feature id="blackberry.bbm.platform" required="true" version="0.1"/>
  <feature id="blackberry.ui.menu" required="true" version="1.0.0.0"/>
  <access subdomains="true" uri="file:///"/>
  <icon rim:hover="false" src="appicon.png"/>
  <content src="index.html"/>
</widget>