Instructions for setting up a BlogBridge
development environment under Windows

Document History

9/13/04�������� Original, David Coletta, david@colettas.org

8/5/05��������� Misc updates, Paul Kleppner, pkleppner@gmail.com

 

Download and Install Eclipse

  1. Visit http://www.eclipse.org/downloads/index.php and pick one of the download locations to obtain the  Eclipse 3.1 SDK.
  2. Unzip the zip file into a directory.
  3. To launch Eclipse, just run eclipse.exe in the top level directory.

Download and Install Java2 SDK

  1. Visit http://java.sun.com/j2se/1.4.2/download.html and click on the link to download the J2SE SDK.
  2. Download and install the J2SE.  (Current version as of Sept 2004: 1.4.2_05)

Note: it's not clear to me which Java2 SDK version to recommend.  It's probably best to avoid the 1.5 version, because we don't want to depend on users having that installed. But it might be better to use an earlier version of 1.4 in order to avoid depending on bug fixes from later 1.4 versions that users may not have installed. 

Download and Install the BlogBridge Tree

  1. In Eclipse, switch to the CVS Repository perspective.  (Windows → Open Perspective; choose CVS Repository Exploring)
  2. Right-click in blank CVS Repositories pane, and click New→Repository Location
  3. For configuration, enter:

   hostname: �������� cvs.sourceforge.net

   repository path: /cvsroot/blogbridge

   user: ���������������� anonymous

   password: ��������� <leave blank>

   connection type: pserver

   use default port����������

  1. Navigate to HEAD/BlogBridge
  2. Right-click blogbridge and choose "Check Out"

 

Configure Eclipse

  1. Under Windows→Preferences, go to the element "Java/Installed JRE's" and make sure that the 1.4.x JRE is checked as default.  If not there, add it: click Add, navigate to the JRE directory (e.g. c:\program files\Java\j2re1.xxxx; give JRE a name).

 

Note: I later switched to an SourceForge account for which I was given BlogBridge source read/write privileges. At that time I needed to switch the protocol to to extssh, and of course change the user name and password.  - Paul.

 

  1. Install the BlogBridge standard Java format.  You'll need "bbstyle.xml", which is available from Pito. (Checked into CVS somewhere yet?).  To install: go to Windows→Preferences, select Java/Code Style/Formatter, and import bbstyle.xml.

 

Build BlogBridge

Click Project→Clean... to force a build.

 

Note: I've had various problems in getting the initial build going.  Another way to run a build is to right-click on build.xml in the top level of the package explorer tree, and choose Run As→Ant Build . You should see �BUILD SUCCESSFUL� in the Console window. -  Paul.

Debug BlogBridge

1. Choose Run→Debug... menu

2. In the �Create, manage and run configurations� window:

  -  click �New�

  -  set: Name= BlogBridge

            Project=blogbridge

            Main class = com.salas.bb.core.ApplicationLauncher

3. Click Debug button

 

You should see the BlogBridge splash screen and first dialog.

 

For future debugging, click the F11 key or choose the Debug icon in the Eclipse toolbar.