Contributing A Tablet OS API
When building an API for the BlackBerry WebWorks SDK for Tablet OS, you will start by creating a sub-directory within this Tablet directory. Pick a name that suits your extension and try not to use spaces in your directory name. It just plain makes things easier.
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 Locale is a good example of what type of information to include in your README.md file. This README.md file uses Markdown wiki formatting.
Tablet OS API Tutorial
The below example shows what information needs to be added to your library.xml file:
library\extension\entryClass This value is the fully qualified name of the Class that implements your ActionScript extension.
library\configurations\configuration\src.path These are paths to the files that you need for your extention to run. One file is for the JS dispatcher, one is for the JS namespace and one is for your ActionScript implementation src directory
library\features\feature.version This attribute is required but doesn't serve any meaning. Leaving it at 22.214.171.124 is all you need to do.
Testing Your API
You can test your API with an existing installed WebWorks SDK for Tablet OS 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 SDK for TabletOS\bbwp\ext
Create a new directory for your API in the ext directory. This should be named the same as your feature id fancy.new.api
Copy your library.xml file into to your new ext\fancy.new.api directory
Copy your root code src directory and your js directory to your newly created ext\fancy.new.api directory
Create a WebWorks Application using your API and create a feature element specifying the ID of your API. <feature id="fancy.new.api" />
Build your application using the bbwp.exe command line and test your application on the desired simulator