Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The BB10 WebWorks Packager bundles the App content with the BB10 WebWorks Framework to create a BAR to run on the BB10 Device (or simulator)
branch: master

Update README.md to fix typo

Reviewed By: Jeffrey Heifetz <jheifetz@rim.com>
Tested By: Jeffrey Heifetz <jheifetz@rim.com>
latest commit 2e7678a7a7
johannjacobsohn johannjacobsohn authored bryanhiggins committed
Failed to load latest commit information.
Framework @ 532bd8b Updates submodule to last released build - v1.0.4.5
build Fixing wrong paths for wrench node module
lib Redirect stderr to slog2 output for debug builds
test Fixed lint error in unit tests.
third_party
.gitignore Linux support + several changes to improve/simplify buildability in o…
.gitmodules Updates submodule to last released build - v1.0.3.8
.jshintignore Changes the packager to accept the folder location instead of zip and
.jshintrc Fixed unit tests for native-packager and bar-builder to verify callba…
Jakefile Added jake build scripts. Included license in maven scripts
README.md Update README.md to fix typo
README.txt Changes to create a third_party folder and README.txt file in the fin…
bbwp Linux support + several changes to improve/simplify buildability in o…
bbwp.bat Linux support + several changes to improve/simplify buildability in o…
configure Linux support + several changes to improve/simplify buildability in o…
default-icon.png Implementation and unit test for default icon.
dist.xml
licenses.txt Added XUI.js license to the product
package.json Removing colored output text (logule) + implemented logging logic
params-example.json Implements --params option for bbwp
pom.xml Updating build scripts to ensure we don't copy dependencies/tools fro…

README.md

BlackBerry 10 WebWorks Packager

WebWorks is an application framework and packaging tool that allows a developer to create a standalone BlackBerry application using HTML5/CSS/JavaScript. Web developers can create a device application experience, including AppWorld distribution and monetization to system security policy enforcement, to deep device system and service integration. All using the technologies they are familiar with, leveraging the power of the industry leading web platform being built for BlackBerry 10. This repo contains the code for the BlackBerry 10 WebWorks Packager and submodules the Framework.

Prerequisites

  1. Install node[v0.6.10] and npm and add to path.
  2. Install BlackBerry 10 Native SDK.
  3. Install BlackBerry 10 WebWorks SDK.
  4. [Windows] Add Git bin to PATH. i.e. *Installation Directory*\bin
  5. [Linux] Build node[v0.6.10+], ensure it works on your distro and copy the binary into third_party\node\linux\ folder.

Setup and Build

  1. git clone https://github.com/blackberry-webworks/BB10-Webworks-Packager.git
  2. cd BB10-Webworks-Packager
  3. git checkout master
  4. Setup bbndk environment variables: (must be done within each session, prior to jake)
    • [Mac/Linux] source *BBNDK installation directory*/bbndk-env.sh
    • [Windows] *BBNDK installation directory*\bbndk-env.bat
  5. Copy Dependencies:
    Copy the dependencies directory from the latest BlackBerry 10 WebWorks SDK into the cloned BB10-WebWorks-Packager folder. For more details on how to install go here.
  6. Configuration:
    • [Mac/Linux] ./configure [from terminal]
    • [Windows] bash configure [from command prompt]
  7. Run jake or jake build and check that the output folder is created under the "target/zip" subfolder.
  8. Run jake test and check that jake runs and completes

Building an application

[Mac/Linux] ./bbwp test/test.zip -o <output dir>
[Windows] bbwp.bat test\test.zip -o <output dir>

Please ensure you build your application from the "target/zip" folder and not the root of your BB10-Webworks-Packager clone; Otherwise the resulting bar won't launch.

Common issues

Cloning into dependencies/webplatform... error: Couldn't resolve host 'github.rim.net' while accessing
http://github.rim.net/webworks/webplatform.git/info/refs


Solution: This error can be ignored, but please see the "Setup and Build" - "Webplatform setup:" section above for instructions on copying the necessary webplatform files.

Authors

Contributing

To contribute code to this repository you must be signed up as an official contributor.

To add new Samples or make modifications to existing Samples:

  1. Fork the BB10-Webworks-Packager repository
  2. Make the changes/additions to your fork
  3. Send a pull request from your fork back to the BB10-Webworks-Packager repository
  4. If you made changes to code which you own, send a message via github messages to one of the Committers listed below to have your code merged

Committers

Other related Repos

Something went wrong with that request. Please try again.