blackberry-build
Grunt plugin to package web apps using the BlackBerry Web Works SDK. Includes two tasks, 'bb_package_bar' and 'bb_deploy_bar'.
Getting Started
This plugin requires Grunt >=0.4.1
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install blackberry-build --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt;
The "bb_package_bar" task
Overview
In your project's Gruntfile, add a section named bb_package_bar
to the data object passed into grunt.initConfig()
.
grunt
Options
options.sdk
Type: String
Default value: ``
The path to your Web Works SDK
options.keypass
Type: String
Default value: ``
Your certificate keypass used to sign the bar file
options.flags
Type: String
Default value: ``
Any additional script flags you'd like to pass, like '-d' to enable remote debugging
Properties
src
Type: String
Default value: ``
The project source to package
dest
Type: String
Default value: ``
The destination directory to output the device/simulator bar files
Usage Examples
Simple Package Example
Package up the test/sample folder into the tmp directory
grunt
Package, Sign, and Add Flags
Package up the test/sample folder into the tmp directory using a keypass for signing and an additional compiler flag
grunt
The "bb_deploy_bar" task
Overview
In your project's Gruntfile, add a section named bb_deploy_bar
to the data object passed into grunt.initConfig()
.
grunt
Options
options.sdk
Type: String
Default value: ``
The path to your Web Works SDK
options.password
Type: String
Default value: ``
Your device password which you are deploying to
Properties
ip
Type: String
Default value: ``
The ip address of the device or the simulator you'd like to deploy the bar file to
bar
Type: String
Default value: ``
The bar file package you want to deploy
Usage Examples
Simulator Deploy Example
Deploy the simulator built bar file to the ip address supplied by your simulator
grunt
Device Deploy Example
Deploy the device built bar file to the ip address of your device using your device password
grunt