Developing a BlackBerry Application

Generate code for the BlackBerry platform, develop a BlackBerry device application using that code and sample files, and test the application's functionality on a simulator.

Prerequisites
Note: This tutorial was created using SAP Mobile Platform 2.3, BlackBerry Java SDK 7.1.0.10, BlackBerry Java Plug-in (core) 2.0.0, and run on an BlackBerry SDK 9900 device simulator. If you use a different version, some steps may vary.
  1. Complete the tasks in Getting Started with Mobile Platform.
  2. Either:
    • create the MBO project by completing Tutorial: Mobile Business Object Development, or
    • download and deploy the MBO SMP101 example project (complete project files) from the SAP® Community Network: http://scn.sap.com/docs/DOC-8803.
    Note: If you upgrade SAP Mobile SDK after completing the tutorial, you can convert the project to the current SDK by importing the earlier project into the SAP Mobile WorkSpace and then accepting the confirmation prompt.
  3. (Optional) To use as a reference and copy source code when completing this tutorial, download the BlackBerry SMP 101 example project (source code only) from the SAP® Community Network: http://scn.sap.com/docs/DOC-8803.
  4. Download the supported versions of the BlackBerry Java Plug-in for Eclipse.

    See the Supported Hardware and Software guide at http://sybooks.sybase.com/sybooks/sybooks.xhtml?id=1289&c=firsttab&a=0&p=categories. Select the appropriate version of the SAP Mobile Platform document set.

Task
Create a BlackBerry native application that communicates with the mobile business objects that are deployed to Unwired Server.
  1. Installing the BlackBerry Java Plug-in for Eclipse
    Install the supported version of BlackBerry Java Plug-in in the SAP Mobile WorkSpace Eclipse environment.
  2. Generating Java Object API Code
    Use the Generate Code wizard to generate object API code for the SMP101 mobile application project. Code generation creates the business logic, attributes, and operations for the mobile business objects (MBOs) in the project.
  3. Creating the BlackBerry Project
    Create a new BlackBerry project in SAP Mobile WorkSpace. Add library resources to the project and set other application properties.
  4. Creating the User Interface
    Copy the Java code files, which provide the functionality and layout of the user interface, from the SMP101 BlackBerry Project example project archive to the SMP101 BlackBerry project.
  5. Creating a Launch Configuration for the Project
    Create a new launch configuration for the SMP101BlackBerry project. The configuration specifies how the application launches, and defines the target BlackBerry platform.
  6. Testing the Device Application on the BlackBerry Simulator
    Run the SMP101BlackBerry application on the BlackBerry simulator, and change customer information to update the interface.