Deploy to a simulator
Before you distribute your application to users, you can test it using the BlackBerry 10 Device Simulator. You can use the simulator to run and view your applications exactly as you would on a real BlackBerry 10 device. The BlackBerry 10 Device Simulator operates using VMware.
Running your application in the simulator
Start the BlackBerry 10 Device Simulator. See Installing the simulator for details.
Note the IP address displayed in the lower-left corner of the simulator window.

You can deploy your application to the simulator using the Ripple emulator or the command line.
Using the Ripple emulator to deploy your app to the simulator
Before you start:
- Package your app with the Ripple emulator.
- Check that Ripple services are running. If they are not, in the Ripple control panel, click Start Ripple Services.
- In the Ripple
emulator, click Build > Settings. Fill in the fields in the Launch section as follows:
- In the Target field, select Simulator.
- In the Device IP field, type the IP address of your simulated device.
- In the Device Password field, type the password that you set for your simulated device. If you did not set a password for the simulator, leave this field blank.
- Click the X to close the window and save your settings.
- Click Package & Launch.
If the package and launch process is successful, the message Build succeeded! is displayed, the .zip and .bar files for the application are saved in the output folder that you specified, and your application is opened in the BlackBerry 10 Device Simulator.
Using the command line to deploy your app to the simulator
Before you start:
- Package your application using the BlackBerry 10 WebWorks SDK.
- In a command prompt, navigate to where you installed the BlackBerry 10 WebWorks SDK.
- Navigate to the dependencies\tools\bin folder.
- On the
command line, type the following command:
For Windows:
blackberry-deploy -installApp -password <simulator password> -device <simulator IP address> -package <.bar file path>
For Mac OS:
./blackberry-deploy -installApp -password <simulator password> -device <simulator IP address> -package <.bar file path>
You can omit including the -password <simulator password> if you didn't set a password for your BlackBerry 10 Device Simulator.
A result::success message appears if your application is deployed successfully.
Removing your application from the simulator
- In a command prompt, navigate to where you installed the BlackBerry 10 WebWorks SDK.
- Navigate to the dependencies\tools\bin folder.
- On the
command line, type the following command:
For Windows:
blackberry-deploy -uninstallApp -device <IP_address> -package <.bar file path> -password <device password>
For Mac OS:
./blackberry-deploy -uninstallApp -device <IP_address> -package <.bar file path> -password <device password>
Troubleshooting
Error message | Description | Possible solutions |
---|---|---|
500 development apps pool exhausted | This message appears if too many apps are installed on the simulator. | Remove any unused applications from the simulator and deploy your application again. |
500 navigator interlock failed | This message appears when a version of the application is already running on the simulator. |
|
– | A black screen appears when you start the simulator, or the simulator freezes at the device splash screen. |
|
Cannot connect: Connection to https://<IP address> refused. You may have to reboot the target. | This message appears when the simulator is not responding. |
|
Connection to <IP address> Refused | This message appears when a VPN connection is blocking deployment. |
|
Device is not in the development mode. Switch to Development from Security settings on the device. | This message appears when development mode is turned off on your simulator. |
|
Username or password is invalid or not specified or time on the device is out of sync |
This message appears if:
|
|
Last modified: 2014-03-10
Got questions about leaving a comment? Get answers from our Disqus FAQ.
comments powered by Disqus