Managing devices

In the Momentics IDE for BlackBerry, you can use the toolbar to manage your paired devices. You can select the device that you want to run your app on and configure the device properties. If you didn't set up a device when you set up your development environment, you can pair a device or download and pair a simulator.

Screen showing the Add New Target option in the Launch target drop-down list.

Pair a device

When you pair a device in the Momentics IDE, the Device Manager wizard helps you create a BlackBerry ID and get a BlackBerry ID token. The BlackBerry ID token allows you to sign your apps and generate debug tokens, which are required to test unsigned apps on a device. The wizard allows you to create or import a debug token, and then upload it to the 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 apps. The simulator is in Development Mode by default.

To enable Development Mode on your device:

  1. On the home screen, swipe down from the top of the screen or open the Settings app on your home screen.
  2. Navigate to Settings > Security and Privacy > Development Mode.
  3. Set the Development Mode toggle button to On.
  4. If you are prompted, enter the device password and tap OK.

To pair a device:

  1. 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.

  2. On the Devices tab, click Set Up New BlackBerry 10 Device, and then follow the instructions in the wizard. The device appears in the Launch target drop-down list on the toolbar.

When you launch an app on the device, the Momentics IDE verifies that the app is packaged to match the debug token that's on the device. If you don't want this check to be made, clear the Verify device debug token when installing applications check box.

Download and pair a simulator

The BlackBerry 10 Device Simulator is in Development Mode by default and doesn't need a BlackBerry ID token or debug tokens.

  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 finishes, 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. You can check the device properties to help you fix any connection problems, such as missing debug symbols.

Troubleshoot 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 for development. If the icon is yellow or red, your device is not connected correctly. You can use the Device Properties dialog box to resolve your connection. For example, the Device Properties dialog box can help you resolve an incompatible API level, generate a debug token, or download and install missing debug symbols.

  • To start the Device Properties dialog box, click Momentics IDE edit icon beside the Launch target drop-down list.

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. In 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-11-17



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

comments powered by Disqus