The purpose of this application is to demonstrate the multitude of capabilities and functionality (everything but the "kitchen sink") that can be built into a BlackBerry WebWorks application.
The sample code for this application is Open Source under the Apache 2.0 License.
Applies To
Author(s)
Dependencies
- See the Resource_Copyright_Info.txt file for a complete listing of copyright info, and references for images and resources used in this application.
- json2.js JSON parser is available under Public Domain.
Known Issues
- Application Event API (Tablet OS) - background/foreground events not working (onSwipeDown is, but onBackground and onForeground are not responding).
- HTML5 FileReader API not fully supported on Tablet OS 1.0.7 or BlackBerry 7.
- HTML5 WebSockets open call not initializing from the page onload event (can be created after the onload event occurs).
- HTML5 video conflicting with page onload event. Timer delay needed to start video rather than direct from onload.
- Invoke API (Tablet OS 1.0.7) - opening photos and videos application causes "cannot open file" error.
- Microphone API (Tablet OS 1.0.7): "Failed to load resource: the server responded with a status of 500 (Error #1009)"
- Camera API (Smartphone) image not loading after photo taken.
- Phone API (Smartphone) Phone logs not displaying as expected.
To contribute code to this repository you must be signed up as an official contributor.
To build the kitchenSink sample application:
- Click on the Downloads tab above.
- Select Download as zip (Windows) or Download as tar.gz (Mac) and save the downloaded file to your local machine.
- Create a new folder on your local machine named kitchenSink e.g. C:\Documents and Settings\User\WebWorks\kitchenSink (Windows) or ~/WebWorks/kitchenSink (Mac).
- Open the downloaded ZIP file from step 2 and extract the contents from inside the zipped kitchenSink folder to your local kitchenSink folder from step 3. This ensures that the necessary application assets, such as config.xml, are correctly located at the top level of the local kitchenSink folder (e.g. ~/WebWorks/kitchenSink/config.xml).
- Using the Ripple Mobile Emulator and either the BlackBerry WebWorks SDK for Smartphone or the BlackBerry WebWorks SDK for Tablet OS, package the contents of your local kitchenSink folder into a BlackBerry application. Enter the project root settings field as the local folder created in step 3, and the archive name settings field as kitchenSink.
- BlackBerry HTML5 WebWorks - Downloads, Getting Started guides, samples, code signing keys.
- [BlackBerry WebWorks Development Guides] (https://bdsc.webapps.blackberry.com/html5/documentation)
- BlackBerry WebWorks Community Forums
- BlackBerry Open Source WebWorks Contributions Forums
Please see the README of the WebWorks-Samples repository for instructions on how to add new Samples or make modifications to existing Samples.
If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample and send a message (via github messages) to the Sample Author(s) to let them know that you have filed an Issue.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.