Testing a BlackBerry device application

BerrySync is a project which involve into BlackBerry and Firefox Sync by using JAVA ME. For testing a BlackBerry application, RIM suggest:

• Testing applications on a BlackBerry Smartphone Simulator
• Testing applications on a BlackBerry device
• Testing applications using the compiled .cod files

 Testing a BlackBerry device application (1) 

                                        -- Testing applications on a BlackBerry Smartphone Simulator

 After you develop and compile your application, you can test it on the BlackBerry® device. The most common first step is to set the BlackBerry® Java® Development Environment to use a BlackBerry® Smartphone Simulator. The BlackBerry Smartphone Simulator runs the same Java code as the BlackBerry devices, so the BlackBerry Smartphone Simulator provides an accurate environment for testing how applications will function on a BlackBerry device. The BlackBerry JDE includes current versions of the BlackBerry Smartphone Simulator. To download additional versions of the BlackBerry Smartphone Simulator, visit http://www.blackberry.com/developers/index.shtml.

(  http://www.cs.toronto.edu/~delara/courses/csc309/guide/rim/core.pdf  )


There is the instruction of "Setting up your machine" which made by my teammate Carlin Woshkulak Desautels.

Description

1. Download BB Eclipse IDE:
   •  http://bit.ly/oZ6JsA
2. Download Simulators:
   • Torch 9800:  http://bit.ly/nKf2h0
   • Storm 9530:  http://bit.ly/oEnywL
   • Bold 9780:  http://bit.ly/rbL0Aa
3. Install Everything
4. Install the BB 5.0 JRE
   • Eclipse -> Install new software
   •  http://www.blackberry.com/go/eclipseUpdate/3.6/java
   • Reconfigure project build path to use 5.0 JRE
5. Set up debug environments
   • Project -> properties
   • Run/Debug? -> Edit/Add? one for each simulator
6. If the Project fails to package
   • Add the directory of jar.exe to the system build path
   • C:\Program Files (x86)\Java\jdk1.6.0_25\bin

• In steps 1-4, the downloads require a blackberry developer account
• In step 6, your systems java JDK must be 32-bit that is an example path of java 1.6.25

•  In step 5, I will suggest to "Duplicate" a existing one, and then "Edit" it.

After setting up the machine, you can select your "BlackBerry Project", then click "Run on BlackBerry Simulator" or "Debug on BlackBerry Simulator". The result will shows on console. 


The BlackBerry Plug-in also has "Debug Perspective" available. The button locate on the top right corner.

Testing a BlackBerry device application (2) 

           --Testing applications on a BlackBerry device

After you test your application on the BlackBerry® Smartphone Simulator, you can install your application on a BlackBerry device. If your application uses signed APIs, you might need code signing keys. After you install the application on the BlackBerry device, you can open the application and test its functionality and performance.
For debugging purposes, you can attach your device to the BlackBerry® Integrated Development Environment and use the debugging tool to step through your application code. The BlackBerry IDE can be useful if you are trying to identify a network or Bluetooth® issue, or other issues that are difficult to simulate.

( http://www.cs.toronto.edu/~delara/courses/csc309/guide/rim/core.pdf )

Register to use protected BlackBerry APIs

1. Visit www.blackberry.com/JDEKeys and complete the registration form.
2. Save the .csi file that Research In Motion sends to you. The .csi file contains a list of signatures and your registration information. If the BlackBerry® Signing Authority Tool administrator does not provide you with the .csi file or the Registration PIN and you are an ISV partner, contact your ISV Technical Partnership Manager. If you are not an ISV partner, send an email message to jde@rim.com.
3. Double-click the .csi file to start the BlackBerry Signing Authority Tool .
4. If a dialog box appears that states that a private key cannot be found, follow the instructions to create a new key pair file.
5. In the Registration PIN field, type the PIN that RIM provided.
6. In the Private Key Password field, type a password of at least eight characters. The private key password protects your private key. If you lose this password, you must register again with RIM. If this password is stolen, contact RIM immediately.
7. Click Register.
8. Click Exit.

 http://docs.blackberry.com/en/developers/deliverables/23674/Register_to_use_protected_BlackBerry_APIs_656038_11.jsp

Install signing key:

• After completing the registration from, RIM will send 3 .csi files which separated in 3 e-mails with the instruction.
• Follow the instruction to install the signing key.

Install BlackBerry desktop software:

• Download and install BlackBerry desktop software (http://us.blackberry.com/apps-software/desktop/)
• BlackBerry device plugged in USB wire

Load on BlackBerry device:

• In Package Explorer View, Right-click your "BlackBerry Project" > Click BlackBerry > Sign with Signature Tool
• In Package Explorer View, Right-click your "BlackBerry Project" > Click BlackBerry > Load Project(s) on Device

Debug on BlackBerry device:

• In BlackBerry Plug-in, BlackBerry > Debug As > BlackBerry Device