Get started using IBM Lotus Expeditor Toolkit for development
of applications for IBM Lotus Expeditor Client for Devices V6.2. Learn
what to install and how to configure the toolkit for development.
This article will show you how to use Lotus Expeditor Toolkit in conjunction
with the Eclipse Integrated Development Environment (IDE) or IBM Rational
Application Developer for WebSphere Software to build and test Java applications
for use with Lotus Expeditor Client for Devices.
A non-warranteed and non-supported version of Lotus Expeditor Toolkit 6.2
is available for download from the developerWorks
page. The downloaded file contains
an update site that can be installed into an existing IDE based on Eclipse
3.4 or later, such as IBM Rational Application Developer for WebSphere
At a minimum, the Lotus Expeditor Toolkit requires Eclipse 3.4 with JavaSE
5.0+. For web functions, you should also install the Eclipse Web Tools
Platform (WTP). This can be installed from the predefined Ganymede Discovery
site available in Eclipse. If you do not already have a version of Eclipse
and the Eclipse Web Tools Platform installed, you can download and install
the Java EE project bundle of Eclipse from the Eclipse
page. The Java EE project bundle
and Lotus Expeditor Toolkit together provide everything you need to develop
Java, Web, and Web services applications. Most application types can be
created using just Eclipse Ganymede (3.4), WTP, and the toolkit. You can
also use Rational Application Developer V7.5. If you are not already
a Rational Application Developer user, you can download and install an
of the software. Prior to installing
Lotus Expeditor Toolkit in Rational Application Developer, be sure to install
to the latest fix pack of the Rational software.
Table 1. Required software
|Application type or required function
||Minimum prerequisite software for Lotus Expeditor
|Standard Java and Eclipse RCP and eRCP
|Web Application Java, JSP, Servlet
||Eclipse 3.4 and Eclipse Web Tools Platform 3.0.2 |
JavaSE 5.0+ is required to use the Expeditor Toolkit
Installing the Expeditor Client for Devices runtimes
The Expeditor Client for Devices runtimes are available on the IBM Lotus
Expeditor 6.2 - Client for Desktop and Client for Devices
should copy the runtimes from the CD image to your local drive for development.
On Windows, the toolkit will look for the runtime in the C:\Program
directory. Copy the eclipse
directory and all of its children from the CD device\toolkit-platforms\win32
location to C:\Program Files\IBM\Lotus\ExpeditorDevice
Installing the toolkit
After you download the toolkit, launch the Eclipse IDE, To Install:
1. Select Help
2. Select the Available Software Tab
3, Select Add Site...
4. Select Archive...
5. Browse to the local Toolkit Zip file and
6. When you return to the Available Software
Tab, select the new entry you have added. It should be in the format,
jar:file:.......zip!/. This selection will add the three required
children categories, Lotus Expeditor Device Toolkit
, Lotus Expeditor
, and Uncategorized
7. Select the Install...
button and continue
through the wizard to complete the install.
8. When the installation process is complete,
you are prompted to restart the platform. Click OK
Configuring the toolkit
After you restart the IDE platform, you are presented with the toolkit
configuration dialog box. You can configure the IDE environment by following
these steps. See Figure 1 for the final settings.
1. Select Lotus Expeditor for Device
in the test environment drop-down box.
2. The Target Location
will show the
default location for the device win32 development environment.
3. The win32 Device VM will appear automatically
in the VM Name
4. Click OK
Figure 1. Lotus Expeditor Toolkit Configuration window
It is also recommended that you select the option Display the first
time a workspace opens
in the Test Environment Configuration Preferences
dialog box. This selection causes the configuration dialog box to be presented
only the first time the toolkit is used in a workspace. You can change
this preference later, if needed, by choosing Window > Preference
> Client Services
When you click OK
in the Toolkit Configuration Dialog, the IDE reconfigures
for development against Lotus Expeditor Client for Devices
You are now ready to begin developing applications for Lotus Expeditor.