Contributing A Smartphone API
When building an API for the BlackBerry WebWorks SDK for Smartphones, you will start by creating a sub-directory within this Smartphone directory. Pick a name that suits your extension and try not to use spaces in your directory name. It just plain makes things easier.
As a recipe for building your API you can use the SpinnerControl as a good example. In your API directory you will want to create a source code directory called src where your actual API code will reside. You will also need to create a library.xml file at the root of this directory. More information on the library.xml can be found below in this README.
A README.md file also needs to be created at the root of your directory where you can place all the information about how to use and configure your API. The SpinnerControl is a good example of what type of information to include in your README.md file. This README.md file uses Markdown wiki formatting.
Smartphone API Tutorial
The below example uses the Spinner Control details to show what information needs to be added to your library.xml file:
<library isWhitelist="true"> <extension id="blackberry.ui.Spinner"> <entryClass>blackberry.ui.SpinnerExtension</entryClass> </extension> <platforms> <platform value="JAVA"> <target version="default" config="JAVA" /> </platform> </platforms> <configurations> <configuration name="JAVA"> <src type="text/java" path="blackberry" comment="API implementation in Java" /> </configuration> </configurations> <features> <feature id="blackberry.ui.Spinner" version="126.96.36.199">Popup Spinner control</feature> </features> </library>
library\extension\entryClass This value is the fully qualified name of the Class that exposes the net.rim.device.api.web.WidgetExtension Java interface.
library\configurations\configuration\src.path This is the name of the root directory that is found in your extensions src directory
library\features\feature.version This attribute is required but doesn't serve any meaning. Leaving it at 188.8.131.52 is all you need to do.
Testing Your API
You can test your API with an existing installed WebWorks SDK for Smartphones by following the below steps:
Locate your BlackBerry WebWorks SDK for Smartphone extensions directory using your File Explorer. Default path is C:\Program Files\Research In Motion\BlackBerry WebWorks Packager\ext
Create a new directory for your API in the ext directory. Make sure that this new directory is the same as your feature id blackberry.ui.Spinner
Copy your library.xml file into to your new ext\blackberry.ui.Spinner directory
Copy your root code directory(specified in the library\configurations\configuration\src.path) to your new ext\blackberry.ui.Spinner directory
Create a WebWorks Application using your API and create a feature element specifying the ID of your API. <feature id="blackberry.ui.Spinner" />
Build your application using the bbwp.exe command line and test your application on the desired simulator