IBM Worklight v5.0.5 > Developing IBM Worklight applications > Development guidelines for mobile environments

Create an IBM Worklight BlackBerry 10 environment


The BlackBerry 10 environment uses the latest version of Cordova, v2.3. However, not all of the Cordova API is supported yet, for example the Cordova contacts object. Some code can work across platforms if written in Cordova, but some must be written by using the WebWorks API. Use either Ripple or Cordova Ant scripts.

  1. Install WebWorks SDK

  2. If you are using Ant scripts, provide values for the following variables in project.properties. Not applicable if you are using Ripple.

        # BB10 Code Signing Password
        qnx.sigtool.password=
        
        # QNX Simulator IP
        #
        # If left blank, you cannot deploy to simulator
        #
        qnx.sim.ip=
    
        # QNX Simulator Password
        #
        # If left blank, you cannot deploy to simulator
        #
        qnx.sim.password=
    
        # We give the initial device ip of 169.254.0.1 which is usually correct when connected 
        # via USB to the computer. Change if setup on device is different.
        
        # QNX Device IP
        #
        # If left blank, you cannot deploy to device
        #
        qnx.device.ip=169.254.0.1
    
        # QNX Device Password
        #
        # If left blank, you cannot deploy to device
        #
        qnx.device.password=
    
        # QNX Device PIN
        #
        # Debug tokens on the device
        qnx.device.pin=
    

  3. Do not delete or change the following elements in config.xml:

    lt;!-- start_worklight_host_server do not change this line-->
      <access subdomains="true" uri="http://9.148.225.82" />
      <!-- end_worklight_host_server do not change this line-->
    

    The correct server TCP/IP address is automatically put in the <access> element on each Worklight build. If this element is deleted or changed, the TCP/IP address cannot be automatically updated.

    1. BlackBerry 10 supports Ripple. If you intend to use Ripple, specify the following as the as the root folder in Ripple...

        {project name}/apps/{app name}/blackberry10/native/www

    2. BlackBerry 10 is based on QNX.

      To run the app on the phone using Cordova Ant scripts, execute...

        ant qnx command

      ...Look in...

        native/qnx.xml

      ...for a list of available commands.

      For example, to build, deploy, and run the app on the device...

        ant qnx debug-device


    Parent:
    Development guidelines for mobile environments