Managing devices

On the toolbar, you can manage your paired BlackBerry 10 devices or BlackBerry 10 Device Simulators. You can select the device that you want to launch your app on, and configure the device properties. If you have not already set up a device, you can pair a device or download a simulator.

Pair a device

When you pair a device in the Momentics IDE for BlackBerry, the Device Manager wizard helps you create a BlackBerry account and get a BlackBerry ID token. The ID token allows you to sign your applications and to generate debug tokens.

The wizard also allows you to create or import a debug token, and then upload it to the device. You need a debug token to test an unsigned application on a device.

When you pair a device, you need to set a password and enable Development Mode on the device. Development Mode allows you to install and launch apps using external tools, such as the Momentics IDE. It protects the device from the unauthorized installation or launching of applications. It does not allow you to run unsigned applications on a secure device.

Before you can pair a device, you must create a project.

For more information about how to set up your environment and your device for development, see Set up your environment.

  1. On the device, turn on Development Mode:
    • On the home screen, swipe down from the top of the screen or find the Settings app on your home screen.
    • Navigate to Settings > Security and Privacy > Development Mode.
    • Set the Development Mode toggle button to On
    • If you are prompted, enter the device password and tap OK.
  2. In the Momentics IDE, on the toolbar, in the Launch Target drop-down list, click Add New Target. This option appears only after you create a project.

    Screen showing the Launch Target drop-down list on the toolbar.

  3. On the Devices tab, click Set Up New BlackBerry 10 Device, and then follow the instructions in the wizard.

    The Device Manager wizard opens and displays the Devices tab, where you can set up a new device.

The device appears in the Launch Target drop-down list on the toolbar.

Download and pair a simulator

Simulators use Development Mode by default, and do not need a BlackBerry ID token or debug tokens.

Before you download and pair a simulator, you need to install VMware. You can download VMware from http://www.vmware.com/products.

  1. On the toolbar, in the Launch Target drop-down list, click Add New Target. This option appears only after you create a project.

    Screen showing the Launch Target drop-down list on the toolbar.

  2. On the Simulators tab, click Begin Simulator Setup, and then follow the instructions in the wizard.

    When the simulator installation is done, VMware opens.

  3. In VMware, power on the virtual machine.
  4. In the Momentics IDE, wait for the Momentics IDE to autodetect the simulator IP address, and then click Pair.
  5. Click Close.

The simulator appears in the Launch Target drop-down list on the toolbar. The Device Properties helps you fix any connection problems, such as missing debug symbols.

Troubleshooting connection problems

In the Launch Target drop-down list on the toolbar, an icon indicates whether each device or simulator is connected and ready to use with the selected launch configuration and mode. For example, changing the launch mode from debug to run might change the icon from red to green, because the run mode doesn’t need a debug token.

If the icon is yellow or red, click Edit to open the Device Properties dialog box, which helps you resolve any connection problems. For example, you can resolve incompatible API level and device runtime, or download and install missing debug symbols.

Screen showing the Launch Target drop-down list with the Edit icon, which opens the Device Properties dialog box.

For information about API levels and device runtimes, see API levels

Specify the SSH key

The Momentics IDE uses an SSH key to create a secure connection to the device or simulator. SSH provides authentication and encryption. By default, the SSH key is generated automatically. However, you can specify an SSH key.

  1. On the Window menu, click Preferences.
  2. On the Preferences dialog box, expand BlackBerry, and then click Targets.
  3. Clear the Automatically generate SSH key check box.
  4. In the SSH Key Path field, click Browse, and then select the key.
  5. Click Apply.

Last modified: 2014-06-24



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

comments powered by Disqus