Package your app

To package your app, you must run the BlackBerry WebWorks Packager (BBWP), which is included with the BlackBerry 10 WebWorks SDK. The BlackBerry WebWorks Packager takes your app archive file or folder location, packages it, and then creates the file needed for deployment.

When you package your app, you can use one of the following as your input to the BlackBerry WebWorks Packager:
  • An archive file (.zip)
  • A folder location

Packaging your app by using a .zip file

If your app is zipped into an archive file (.zip), perform the following steps to package your app:

  1. At a command prompt, navigate to the installation folder for the BlackBerry 10 WebWorks SDK. The default locations are:
    • Windows XP: C:\Program Files\Research In Motion\BlackBerry 10 WebWorks SDK <version>
    • Windows 7: C:\Program Files\Research In Motion\BlackBerry 10 WebWorks SDK <version>
    • Mac OS: /Developer/SDKs/Research In Motion/BlackBerry 10 WebWorks SDK <version>
  2. Type the following command to package your app:
    bbwp [drive:][path]archive [-o dir]

    Windows example:

    bbwp C:\myapp\myarchive.zip -o C:\myapp\output

    Mac OS example:

    ./bbwp ~/myapp/myarchive.zip -o ~/myapp/output

Packaging your app by using the app's folder location

If your app's files and resources are in a folder location, perform the following steps to package your app.

If you don't want all the files to be bundled and packaged, you can use a .bbwpignore file, which can be used to specify files and patterns to ignore during the packaging process. For more information, see Exclude files using the .bbwpignore file.

  1. At a command prompt, navigate to the installation folder for the BlackBerry 10 WebWorks SDK. The default locations are:
    • Windows XP: C:\Program Files\Research In Motion\BlackBerry 10 WebWorks SDK <version>
    • Windows 7: C:\Program Files\Research In Motion\BlackBerry 10 WebWorks SDK <version>
    • Mac OS: /Developer/SDKs/Research In Motion/BlackBerry 10 WebWorks SDK <version>
  2. Type the following command to package your app:
    bbwp [drive:][path][-o dir]

    Windows example:

    bbwp C:\myapp -o C:\output

    Mac OS example:

    ./bbwp ~/myapp/ -o ~/output

Use an output location that is outside of your project folder.

During the packaging process, the BlackBerry WebWorks Packager displays multiple messages, and indicates success if the app archive contains no errors.

If successful, this process creates unsigned .bar files in subfolders (named simulator and device) in the folder specified by the -o parameter. If you do not specify the -o parameter, the .bar files are created in simulator and device subfolders with the same parent folder as your project.

For more information about the parameters available with the bbwp command, see Command-line packaging parameters.

Last modified: 2014-03-10



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus