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.

Setting up in Eclipse

To download the BlackBerry Java Plug-in for Eclipse, visit http://developer.blackberry.com/java/download/eclipse.

System requirements

Item

Requirement

Development environment

One of the following development environments:

BlackBerry Smartphone Simulator or BlackBerry device

  • Any BlackBerry Smartphone Simulator or BlackBerry device that is running BlackBerry Device Software 5.0 or later with BlackBerry World storefront 3.0 or later.
  • The BlackBerry World storefront 3.1 or later to purchase subscription-based digital goods.

Create a project

  1. In the BlackBerry Java Plug-in for Eclipse, on the File menu, click New > Project.
  2. Expand the BlackBerry folder and select BlackBerry Project.
  3. Click Next.
  4. In the Project name field, type a name for the project.
  5. Select the Create new project in workspace option.
  6. Complete one of the following tasks:
    • To specify a specific JRE, select Use a project specific JRE.
    • To specify the default JRE in the workspace, select Use default JRE.
  7. Click Next.
  8. Click Finish.

Add the Payment Service library to a project

To develop and run a BlackBerry device application that invokes the Payment Service APIs, you must add the .jar file for the Payment Service library to your project.

  1. In the BlackBerry Java Plug-in for Eclipse, in the Package Explorer view, right-click your application project and click Properties.
  2. In the left pane, click Java Build Path.
  3. On the Libraries tab, click Add External JARs.
  4. Navigate to the location where you extracted the Payment Service SDK and double-click the paymentapi.jar file.
  5. On the Order and Export tab, select the paymentapi.jar check box.
  6. Click OK.

Add Javadoc comments for the Payment Service APIs to a project

To display the Javadoc comments for the Payment Service APIs when you point to a class name or method name in a source file, you must add the .html files that contain the Javadoc comments to your project.
  1. In the BlackBerry Java Plug-in for Eclipse, in the Package Explorer view, right-click the project that you want to add the Javadoc comments to.
  2. Click Build Path > Configure Build Path.
  3. Click the Libraries tab.
  4. Expand paymentapi.jar.
  5. Click Javadoc location: (None).
  6. Click Edit.
  7. Select the Javadoc URL option.
  8. Click Browse.
  9. Navigate to the folder that contains the extracted Payment Service SDK and click the javadoc folder.
  10. Click Validate to verify that the folder contains valid Javadoc comments.
  11. Click OK until the Properties window disappears.