BlackBerry Internet Service Browser

From bemoko developer wiki

Emulation

RIM provide a fantastic range of emulators @ http://na.blackberry.com/eng/developers/browserdev/devtoolsdownloads.jsp . This covers many variations of device and OS versions.

To get started ...

1. From http://na.blackberry.com/eng/developers/browserdev/devtoolsdownloads.jsp
   1. Download the BlackBerry Email and MDS Services Simulator Package
   2. Download the Version of the simulator or simulators that you want
2. Start up the MDS simulator
3. Start up your simulator

Note v4.5.0.81 of the emulators has proved a little unreliable in connecting to the internet, recommended to use v4.5.0.55 instead.

MDS

MDS (downloaded from the link above) is required for the Blackberry emulators to allow the emulators to connect to the internet. Download, install and then run before starting up one of the emulators. When you spin up an emulator it should connect to the local MDS server for internet connectivity.

Troubleshooting

MDS - Error 413 : Request Entity Too Large

If you are testing videos, or other large files, you might encounter an entity too large error in the simulator. This is potentially because the file is greater than the default 256K maximum. To change this, edit the config/rimpublic.property file and increase the IPPP.connection.MaxNumberOfKBytesToSend value, e.g.

IPPP.connection.MaxNumberOfKBytesToSend=4096

MDS - Java Configuration

If, when you run MDS, the screen simply flashes up and then disappears then you can edit the run.bat file in the MDS installation so that the command screen does not close. This makes it easier for you to diagnose the issue. An example change is included below where the /c in the start cmd instructiuon is changed to /k so that the window does not close.

@echo off
call setBMDSEnv.bat
 
echo Java Home : %JAVA_HOME%
echo BMDS_CLASSPATH : %BMDS_CLASSPATH%
REM 
 
if ["%JAVA_HOME%"] == [""] goto noJavaHomeSet
  start cmd /v:on /k "%JAVA_HOME%\bin\java" -classpath !BMDS_CLASSPATH!;!BMDS_CLASSPATH2! ^
    -Xmx512M -DKeystore.Password=password net.rim.application.ipproxyservice.IPProxyServiceApplication ^
    -log.console.dump
  goto end
:noJavaHomeSet
  start cmd /v:on /k java -classpath !BMDS_CLASSPATH!;!BMDS_CLASSPATH2! ^
    -Xmx512M -DKeystore.Password=password net.rim.application.ipproxyservice.IPProxyServiceApplication ^
    -log.console.dump
  goto end
:end

A typical issue is that you do not have the correct JDK installed. The post http://www.blackberryforums.com/developer-forum/67200-mds-simulator-problem.html on the blackberry forums will help you through this problem.

Unable to connect to the selected Mobile Data Service

The blackberry simulator needs MDS running before it can connect to the internet. If you're having troubles connecting:

• Checked your MDS has started OK
• Version 4.5.0.81 of the simulators do seem to have a problem with connecting through MDS. Try rolling back a version, to version 4.5.0.55 of the simulator and try with that.

Can't close emulator

You tend to have to kill the blackberry emulators in the task manager to close it down. They don't tend to respond to clicking the window close ... oh well.