Create a MobileFirst BlackBerry 10 environment

Follow these instructions to create a MobileFirst BlackBerry 10 environment.

The BlackBerry 10 environment uses the latest version of Cordova. Use either Ripple or Cordova Ant scripts to create a MobileFirst BlackBerry 10 environment, and follow these steps to ensure that the program runs correctly.

BlackBerry OS 10 is not supported by the current version of the Application Center.

1. Follow all instructions to install WebWorks SDK, described at HTML5 WebWorks.

2. Install Ant Version 1.8 (or later) if it is not already installed. We can obtain Ant Version 1.8 from http://ant.apache.org/.

3. Download the ant-contrib-1.03b.jar file from http://central.maven.org/maven2/ant-contrib/ant-contrib/1.0b3/ant-contrib-1.0b3.jar, and save the .jar file in the lib folder of the Ant installation folder, ANT_HOME.

4. If we use Ant scripts, manually modify the project.properties file. Provide values for the following variables in project.properties. This step is not relevant if you are using Ripple.

   # BB10 Code Signing Password
    qnx.sigtool.password=
    
    
    For simulator:
    # QNX Simulator IP
    #
    #   If we leave this field blank, then  #   we cannot deploy to simulator
    #
    qnx.sim.ip=
    # QNX Simulator Password
    #
    #   If we leave this field blank, then  #   we cannot deploy to simulator
    #
    qnx.sim.password=
    for device:
    The initial device ip is 169.254.0.1, that is, the one that is usually given when connected via USB to the computer; we can change if setup on device is different  # QNX Device IP
    #
    #   If we leave this field blank, then  #   we cannot deploy to device  #
    qnx.device.ip=169.254.0.1
    You also must change 
    # QNX Device Password
    #
    #   If we leave this field blank, then  #   we cannot deploy to device  #
    qnx.device.password=
    # QNX Device PIN
    #
    #   Fill this value in to use debug tokens when debuging on the device  qnx.device.pin=

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

   <!-- 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 MobileFirst build. If this element is deleted or changed, the TCP/IP address cannot be automatically updated.

6. BlackBerry 10 supports Ripple. If we intend to use Ripple, specify {project name}/apps/{app name}/blackberry10/native/www as the root folder in Ripple.

   Before you package or start the application with Ripple, perform the following steps:

   1. Install Ant if it is not already installed.

   2. Open a command window, and navigate to the {project name}/apps/{app name}/blackberry10/native folder.

   3. In the {project name}/apps/{app name}/blackberry10/native folder, run the ant qnx copy-extensions command.

   If we uninstall and install back the WebWorks SDK, make sure to run the ant qnx copy-extensions command again.

7. BlackBerry 10 is based on QNX. To run the application on the phone using Cordova Ant scripts, use ant qnx <command>, where <command> is one of the commands that are defined in the native/qnx.xml file. For example, use ant qnx debug-device to build, deploy, and run the app on the device.

Parent topic: Develop hybrid applications for BlackBerry