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.
Download
A non-warranteed and non-supported version of Lotus Expeditor Toolkit 6.2
is available for download from the
developerWorks
Lotus Toolkits 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
Software V7.5.
Prerequisites
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
Ganymede project 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
evaluation
version 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
Toolkit
|
Standard Java and Eclipse RCP and eRCP
| Eclipse 3.4
|
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 CD. You
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
Files\IBM\Lotus\ExpeditorDevice 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
Software Updates...
2. Select the
Available Software Tab
3, Select
Add Site...
4. Select
Archive...
5. Browse to the local Toolkit Zip file and
select
OK.
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
Toolkit, 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 drop-down box.
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.