Fork me on GitHub

Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Running your BBM connected app

Run your application using the simulators

  1. In the folder where you extracted the .zip file containing the BlackBerry Messenger SDK, open the MDS Simulator -> sdk -> mds folder.
  2. Double-click run.bat to launch the BlackBerry MDS Simulator.
  3. In Windows Explorer, navigate to the folder where you installed the BlackBerry Smartphone Simulator. By default, the location of this folder is C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0\6.0.0.313 (9800).
  4. Double-click the sim1.bat file (or your custom .bat file) to launch a BlackBerry Smartphone Simulator with appropriate settings to run your application and communicate with the BlackBerry MDS Simulator.
  5. In Windows Explorer, in the BlackBerry Smartphone Simulator folder, double-click the sim2.bat file (or your second custom .bat file) to launch a second instance of the BlackBerry Smartphone Simulator with the appropriate settings to communicate with the first BlackBerry Smartphone Simulator.
  6. Set up the simulators as BBM contacts:
    1. In the first BlackBerry Smartphone Simulator instance, open BlackBerry Messenger
    2. Click the Menu key and click the Invite Contact menu item.
    3. Click Invite by sending a PIN or email message.
    4. In the To field, type 2100000B. This is the default PIN of the second BlackBerry Smartphone Simulator instance.
    5. In the second BlackBerry Smartphone Simulator instance, open BlackBerry Messenger and accept the invitation.
    6. Click the Send key.
    7. In the first BlackBerry Smartphone Simulator instance, close BlackBerry Messenger.
    8. On the Home screen, click the icon for your BlackBerry Messenger platform application.
You can now communicate between the two BlackBerry Smartphone Simulator instances.

Run your application from the BlackBerry Java Plug-in for Eclipse

  1. Click Run > Debug Configurations.
  2. Create a new BlackBerry Simulator launch configuration and type in a name.
  3. On the Projects tab, select the projects that you want to launch.
  4. On the Simulator tab, click General.
  5. In the Device dropdown list, select a simulator (for example: SimPackage-6.0.0.313_9800-9800). To learn how to install the simulator package, see Install the BlackBerry Smartphone Simulator package.
  6. Click the Advanced tab:
    1. Select the Use Customized command options check box.
    2. In the Customized command line box, type the arguments from the sim1.bat file. For example, "C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\fledge.exe" /handheld=9800 /app-param=JvmAlxConfigFile:9800.xml /pin=0x2100000A /data-port=0x4d44 /data-port=0x4d4e /session=9800 /app="C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\Jvm.dll" /app=Jvm.dll /handheld=9800 /session=Sim1 /app-param=JvmAlxConfigFile:9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000A /app-param=regVersion=3 /app-param=regDestIP=127.0.0.1 /app-param=regDestPort=19781 /app-param=regSrcPort=19780 /app-param=DisableSyncServiceRecord /title="BlackBerry 9800-1 Simulator"
    3. In the Customized working directory box, type path of the directory where you installed the simulator package.
    4. In the Customized MDS directory box, type the path of the directory where you installed the MDS simulator package.
    To learn how to install the MDS Simulator package, view /java/documentation/configuring_your_system_for_bbm_support_organizer_1347895_11.html.
  7. To save the settings, click Apply.
  8. Click Debug.

Run your application from the BlackBerry Java Development Environment

  1. In the BlackBerry JDE, click Edit > Preferences.
  2. Create a new Simulator Profile and type in a name.
  3. On the Simulator tab, click General.
  4. In the Device dropdown list, select a simulator (for example: SimPackage-6.0.0.313_9800-9800).
  5. Click the Advanced tab:
    1. Select the Use Customized command options check box.
    2. In the Customized command line box, type the arguments from the sim1.bat file. For example: "C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\fledge.exe" /handheld=9800 /app-param=JvmAlxConfigFile:9800.xml /pin=0x2100000A /data-port=0x4d44 /data-port=0x4d4e /session=9800 /app="C:\Program Files\Research In Motion\BlackBerry Smartphone Simulators 6.0.0\6.0.0.313 (9800)\Jvm.dll" /app=Jvm.dll /handheld=9800 /session=Sim1 /app-param=JvmAlxConfigFile:9800.xml /data-port=0x4d44 /data-port=0x4d4e /pin=0x2100000A /app-param=regVersion=3 /app-param=regDestIP=127.0.0.1 /app-param=regDestPort=19781 /app-param=regSrcPort=19780 /app-param=DisableSyncServiceRecord /title="BlackBerry 9800-1 Simulator"
    3. In the Customized working directory box, type path of the directory where you installed the simulator package.
    4. In the Customized MDS directory box, type the path of the directory where you installed the MDS simulator package.
  6. Click OK.
  7. Click Run.