BlackBerry Widget SDK 1.0 Beta 2

The new BlackBerry® Widget SDK 1.0 Beta 2 consists of the BlackBerry Widget Packager 1.0 Beta 2, a BlackBerry smartphone simulator, the BlackBerry Email and Connectivity Simulator (this is an HTTP Proxy and is needed to develop widgets), documentation and code samples.

The BlackBerry Widget Packager 1.0 Beta 2 is a new tool that allows web developers to package up their web assets into BlackBerry Widgets (small, discrete, standalone web applications that use HTML, CSS and JavaScript®). A BlackBerry Widget looks, behaves and has the same security mechanisms as a native BlackBerry smartphone application. BlackBerry Widgets can be installed on a BlackBerry smartphone like any native application and extended to use device-specific information and data using the BlackBerry Widget APIs.

BlackBerry Widget SDK 1.0 Beta 2 Downloads

Development Tools

Each of the tools below needs to be downloaded before you can begin development. Note: if you installed the BlackBerry Widget SDK 1.0 Beta 1, please remove it before installing the Beta 2 version.

1. Download and install the Sun Java® Application Development Kit. This is required software to compile the BlackBerry Widget. Minimum version of JDK 1.6 is required—if you have JDK 1.6 or higher already installed, you can skip this step
2. Download and install the BlackBerry Widget Packager Beta 2
3. View or download the BlackBerry Widget SDK Installation and Configuration Guide

Deployment Tool (only required when deploying on a physical device)

• You’ll need a code signing key to enable your application to run on a physical device

Documentation

• View and download BlackBerry Widget SDK documentation, including the Installation and Configuration Guide, Development Guide, API Reference and Known Issues List

Videos

• How to Use the BlackBerry Widget Packager to Create Your BlackBerry Widget — This video covers how to use the BlackBerry Widget Packager command line tool to package your web content and create a BlackBerry Widget
• Features of BlackBerry Widgets — Shows the different features of BlackBerry Widgets and how to use them

Sample Code

• Storing local data with Gears (ZIP) — A full working sample that utilizes the SQLite® database using BlackBerry Widgets
• Accessing information from SD Card (File I/O from the SD card) (ZIP) – A full working sample of using File I/O to store, retrieve and backup data on the SD Card from widgets
• Using PIM information (ZIP) — Source code for a BlackBerry Widget that creates and displays contact information from the contacts database

Tutorials (step-by-step instructions)

• How to Set Up Eclipse® for Widget Development with the BlackBerry Widget Packager (PDF) — Learn how to create the proper directory and file structure to create your BlackBerry Widgets using Eclipse and how to package them for deployment using the BlackBerry Widget Packager
• How to Install More BlackBerry Smartphone Simulators (PDF) — Learn how to install multiple BlackBerry smartphone simulators side-by-side to debug your applications
• How to Configure the BlackBerry® MDS Simulator to Work Behind a Proxy (PDF) — Learn how to configure the BlackBerry MDS Simulator to work behind a proxy with the appropriate settings
• How to install the BlackBerry Widget Packager (PDF) – Learn how to install the BlackBerry Widget Packager to create your widgets using the command line tool
• How to Avoid Recompiling a BlackBerry Widget During Development (PDF) — A guide on how to reduce development time by eliminating the need to recompile and rebuild your BlackBerry Widget between small edits
• How to Secure Your BlackBerry Widget (PDF) — A guide to understanding how to use the feature and access permission elements of the config.xml file to enable a BlackBerry Widget to access the Web APIs and content from remote domains

Labs (development guidance)

• Create a push widget (ZIP) — A step-by-step example of how to create a widget that listens for pushed data
• Create a GPS widget (ZIP) — Exercise in how to build a BlackBerry Widget that invokes the BlackBerry® Maps application for a selected location
• Create a widget using PIM (ZIP) — How to build a BlackBerry Widget that displays contact information from the contacts database

BlackBerry Widget SDK 1.0 Beta 2 Additional Information

New Functionality for this Release

• Combined both the BlackBerry smartphone simulator and BlackBerry Email and Connectivity Simulator into the same product bundle as the BlackBerry Widget Packager
• Added the ability to choose which transport (e.g. Wi-Fi, BlackBerry® Enterprise Server, etc.), the order and timeout value
• Ability to white list a wildcard to allow all outside domain content into your widget (Note: wildcard doesn’t allow for access to BlackBerry Widget APIs)
• Top-level domains for white listing are no longer allowed
• Bug fixing

Core Functionality

• BlackBerry Widgets leverage the rendering capability of the 5.0 BlackBerry® Browser
• Leverage Gears APIs for storage, location, multi-threading and more
• Ability to specify Custom Header Addition to all communications for seamless blend between server and client content

Security

• Ability to digitally sign the BlackBerry Widget using the COD signing mechanism
• Definition of a domain white list with which the BlackBerry Widget is allowed to communicate
• BlackBerry Widgets will be packaged the same way a native BlackBerry smartphone application is packaged and distributed via a website, the desktop manager or BlackBerry App World™, using the same security model and maintained just like native BlackBerry smartphone applications
• All BlackBerry Widgets must be signed to ensure any BlackBerry Widget APIs will follow User Access Control policies

Support

To receive free support for the BlackBerry Widget SDK 1.0, email betadevsupport@rim.com