license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Cordova for BlackBerry makes use of the BlackBerry WebWorks framework. BlackBerry WebWorks tooling is available for Windows or Mac environments. WebWorks applications can ONLY be deployed to BlackBerry devices running OS 5.0 and higher or the BlackBerry PlayBook operating system.
sample
and www
. The sample
folder contains a complete Cordova project. Copy the sample
folder to another location on your computer.blackberry.bbwp.dir=
and/or playbook.bbwp.dir=
. Set the value(s) to the directory containing the bbwp
binary in the WebWorks SDK(s) installed earlier.Build the Cordova sample project by typing ant target build
in your command prompt/terminal while you are in your project's directory. Replace target
with either blackberry
or playbook
. Note this is a sample Cordova project and not a basic hello world application. The provided index.html in the www contains example usages of many of the Cordova API.
BlackBerry smartphone simulators are only available on Windows. PlayBook simulators require VMWare Player (Windows) or VMWare Fusion (Mac OS X). The WebWorks SDK provides a default simulator. Additional simulators are available.
blackberry.sim.dir
: Path to directory containing simulator. On windows file separator '' must be escaped '\'.blackberry.sim.bin
: Name of the simulator executable in the specified directory.playbook.sim.ip
: IP address of simulator obtained when placing the simulator in developer mode through simulator security settings.playbook.sim.password
: Simulator password which can be set through simulator security settings.ant target load-simulator
. Replace target
with either blackberry
or playbook
. Note, for PlayBook the simulator virtual image must already be started.blackberry.sigtool.password
: Password used when code signing keys were registered. If not specified, a prompt will occur.playbook.sigtool.csk.password
: Signing key password.playbook.sigtool.p12.password
: Signing key password.playbook.device.ip
: IP address of device obtained when placing the device in developer mode through device security settings.playbook.device.password
: Device password which is set through device security settings.ant target load-device
. Replace target
with either blackberry
or playbook
.The following articles provide help to issues you may encounter when developing a Cordova application which is based on the BlackBerry WebWorks framework.