Deploying the extension plug-in
In the PDE, a plug-in developer can use the Export wizard to produce a distributable archive file that contains the plug-in code and other resources. A plug-in developer can create and manage an update site using the Update Site editor in the Eclipse PDE. A user can find software and extract the contents of the archive file to an Eclipse installation using the Install New Software or Update Configuration managers.
How to deploy a plug-in extension
1 In the Eclipse PDE Manifest editor, choose Overview.
2 In Exporting, choose Export Wizard. Export appears.
3 In Available Plug-ins and Fragments, select the plug-in to export. For example, select org.eclipse.birt.sample.reportitem.rotatedlabel.
4 In Destination, specify Archive file or Directory. For example, in Directory, type:
Export appears as shown in Figure 22‑30.
Figure 22‑30 Exporting a plug-in
5 In Options, select one or more of the following options, if necessary:
*Export source
*Package plug-ins as individual JAR archives
*Save as Ant script
Also select Allow for binary cycles in target platform.
Choose Finish to export the plug-in to the specified destination.
Creating an update site project
A plug-in developer can also use a more structured approach and group plug-ins into features. Features contain information that enables the Install New Software or Update Configuration managers to locate published updates and discover new related features. Updates are typically published in a special internet directory called an update site, created and managed by a plug-in developer using the Update Site editor.
A plug-in developer can create an update site by building an update site project in the Eclipse PDE workspace. The update site project contains a manifest file, site.xml, that lists the features and plug-ins packages.
The build operation for an update site puts the JAR files for features in a features folder and the JAR files for plug-ins in a plug-ins folder. The Eclipse PDE also provides support for uploading an update site to a remote server or local file system for distribution.
How to create an update site project
1 From the Eclipse menu, choose FileNewProject. New Project appears.
2 In Wizards, open Plug-in Development and select Update Site Project, as shown in Figure 22‑31. Choose Next.
Figure 22‑31 Selecting Update Site Project wizard
3 In Update Site Project, specify the following items:
*Project name
*Project contents directory, such as C:\birt-runtime-4_3_1\BIRT Update Site
*Web resources
*Select the option Generate a web page listing all available features within the site.
Creates index.html, site.css, and site.xls files to display the contents of the update site.
*Web resources location.
Change this setting to the web resources location. The default value is web.
Update Site Project appears as shown in Figure 22‑32. Choose Finish.
Figure 22‑32 Creating a new update site project
Update Site Map appears.
4 Choose New Category to create a feature category, as shown in Figure 22‑33.
Figure 22‑33 Update Site Map
5 Choose Add Feature to add a feature to a selected category.