Blackboard is pleased to make available an Eclipse plugin that helps developers to quickly get up and running with Blackboard development projects. This tutorial assumes that you have installed the Starter Building Block version 1.2.3 on your development (never production!) server.
1. Download and open Eclipse Helios for Java Developers. Click Help->Install New Software.
2. Now click the Add button in the upper right.
3. Enter Blackboard Plugin as the Name and as the location this URL: http://fibbba.blackboard.com/eclipse - then click OK.
4. As the screen loads with available options, check the box next to Blackboard Plugin for Eclipse.
5. Click Next to continue with the installation.
6. Click I Accept and Finish to continue with the installation.
7. Click OK if prompted with an "unsigned content" warning.
8. Click Restart Now to finish installation of the plugin.
9. To begin using the plugin, select File->New->Project.
10. Now select Blackboard->Building Block Project.
11. Fill in the details relating to your project including:
Vendor ID: a <4 character long abbreviation for your organization
Plugin Handle: an identifier used to uniquely identify your project
Base Package: the "directory" used to store your code
Development Server: the URL or IP address of your remote development server.
Target Blackboard version: Browse to the location of the Blackboard jar libraries used for your version of Blackboard.
TIP: As a best practice, obtain the Blackboard jar libraries by downloading the installer jar file from Behind the Blackboard, unzipping it, and selecting the /payload/systemlib directory. Alternatively, you can select the /blackboard/systemlib or /apps/tomcat/lib directory from your development instance of Blackboard.
Use Project Template: Choose template code for your project based on one of the following options: Course Tool, User Tool, System Tool, Custom Content type, Portal Module, Stripes framework, BIRT report, or B2 Starter Kit Showcase
12. Your project will now load in Eclipse. Finish filling in the configuration values for your bb-manifest.xml file as indicated by the TODO reminders.
13. To deploy your project, open the build.xml file. In the Outline view in the upper right of your screen right click deploy-b2, then select Run As->Ant Build. If you do not see the outline, click Window->Show View->Outline. Your Building Block project will deploy itself automatically to your development server.