Development Environment

Note: These instructions are applicable to the 1.0.x branch. For the 2.0 branch, see this page.

Tools

The first step is to download and install the following tools:

• RIM BlackBerry JDE
  • Download "BlackBerry Java Development Environment v4.1"
  • Download "BlackBerry Java Development Environment v4.0.2" (optional)
• Subversion
  • Download the main command-line client from the above web page, as other tools may need it.
  • I also recommend TortoiseSVN for general use in Windows.
• NetBeans IDE
  • Download NetBeans 5.5.1 for Windows
  • Download "NetBeans Mobility Pack" (CLDC version)

Configuration

• Install NetBeans updates ("Tools -> Update Center" inside NetBeans)
  • It is recommended that you install the Subversion modules
  • Feel free to install any other modules
• Configure NetBeans for BlackBerry development
  • NetBeans BlackBerry setup instructions - This walks you through configuring NetBeans to build software for the BlackBerry.
  • Using the above instructions, add the following platforms:
    • "BlackBerry" - Using the v4.1 JDE
    • "BlackBerry v4.0" - Using the v4.0 JDE (if installed)
• Check out the LogicMail sources from the repository, and load the projects in NetBeans
  • Using a standalone Subversion client, such as TortoiseSVN or the command-line "svn", check out the sources from the following path:
    • https://logicmail.svn.sourceforge.net/svnroot/logicmail/branches/LogicMail-1.0
  • The sources will include the following two projects, which should be opened in NetBeans:
    • "LogicMail" - Main program sources
    • "LogicMailTests" - Unit test sources

Building

• To build and run LogicMail:
  • Set the Main Project in NetBeans to "LogicMail"
  • Set the active configuration of the "LogicMail" project to "BB41Configuration" (for BlackBerry OS v4.1)
  • Select "Run -> Debug Main Project", and the emulator should start with the LogicMail icon visible.
• To build and run LogicMailTests:
  • Set the active configuration of the "LogicMail" project to "TestConfiguration"
  • Set the Main Project to "LogicMailTests"
  • Select "Run -> Debug Main Project", and the emulator should start with the LogicMailTests icon visible.