Testing BBM connected apps

To test your BBM connected app in the BlackBerry 10 Device Simulator, you need to install at least two instances of the device simulator in different locations on your hard disk, one for each instance of BBM. Learn more about how to Run multiple device simulators with BBM.

After you install the device simulator and a virtual machine, you're ready to get started. The first thing you need to do is start the BBM server simulator. The BBM server simulator enables communication between instances of BBM.

You need to run only one instance of the BBM server simulator.

  1. In the directory where you installed the simulator, open the BlackBerry 10 Simulator - <version> BBM directory.
  2. Double-click the Run BBM Server Simulator shortcut to open the console and start the server.

Next, start the device simulator: in the BlackBerry 10 Simulator - <version> directory, double-click the BlackBerry 10 Simulator shortcut.

Then, connect the device simulator to the controller. The controller allows the device simulator to connect to the BBM server simulator.

Now, connect the device simulator to the BBM server simulator.

  1. On the Controller menu, click BBIO.

  2. In the IP address field, specify the IP of the computer that hosts the BBM server simulator. In the Port field, port 3101 is automatically specified.

    The IP address cannot be 127.0.0.1 or localhost, even if the BBM server simulator is running on the same computer that hosts the device simulator.

  3. Click Connect. You can see activity in the BBM server simulator console when the connection is successful.
  4. To shut down the BBM server simulator when you finish testing, in the BBM Server Simulator directory, double-click the Shutdown BBM Server Simulator shortcut. After the simulator stops, type exit at the command prompt to close the command window.

Run multiple device simulators with BBM

If you want to run more than one BlackBerry 10 Device Simulator at a time, you need to install each simulator in a separate location on your hard disk, one for each instance of BBM.

You need to run only one instance of the BBM server simulator.

  1. Start VMware.
  2. Navigate to the directory where you installed the simulator and open the BlackBerry 10 Simulator - <version> directory.
  3. Select BlackBerry10Simulator.vmx and click Open to start the simulator.
  4. Open the controllers directory and run controller.exe.
  5. Change the default PIN of the simulator by following the instructions in Configuring the simulator.

    After you change the PIN, restart the simulator.

  6. On the Controller menu, click Connection > Connect.
  7. In the Auto Discover section, select the entry for the device simulator instance that you want to connect.
  8. In the IP Address drop-down list, select the IP Address of the corresponding simulator.
  9. Click Connect. "Connected to <IP Address>" appears on the status bar at the bottom of the controller window.
  10. On the Controller menu, click Device > BBIO > Connect to BBM Server.
  11. In the IP address field, specify the IP of the computer that is running the BBM server simulator. In the Port field, port 3101 is automatically specified..

    The IP address cannot be 127.0.0.1 or localhost, even if the BBM server simulator is running on the same computer as the device simulator.

  12. Click Connect.

    When the connection is successful, you see activity in the BBM server simulator console.

  13. In the device simulator, click the app that you want to run.
  14. Repeat steps 1 to 13 for each additional instance of the simulator that you want to run.

For more information, see Testing BBM connected apps.



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

comments powered by Disqus