Installation and configuration

Install the Eclipse SDK

I use Eclipse as the IDE to develop the PIM application. After you have downloaded the Eclipse SDK, extract the zip file to the location where you want to install the application. You don't need any further installation. You may want to create a link to eclipse.exe on your desktop after you unzip the SDK.

Install MIDP 2.0 and PIM Optional Package

The IBM J9 Java Virtual Machine and class libraries are available through WebSphere® Everyplace Micro Environment. To download WebSphere Everyplace Micro Environment, open Eclipse and follow these instructions:

1. On the Eclipse main menu, navigate to Help > Software Updates > Find and Install. On the Install/Update window, select Search for new features to install and click Next (see Figure 1).
   
   Figure 1. Eclipse's Install/Update window
   
   
   
2. On the Install/Update window, you'll need to add two new remote sites by clicking New Remote Site (see Figure 2).
   
   Figure 2. Eclipse's New Remote Site window
   
   
   

   Here are the names and URLs of the new remote sites you'll need to add:

   • Name: IBM WebSphere Everyplace Micro Environment
     URL: http://www.ibm.com/software/pervasive/wsdd/updates/571/weme
   • Name: IBM WebSphere Everyplace Device Developer Technologies
     URL: http://www.ibm.com/software/pervasive/wsdd/updates/571/techs
3. Add a check mark to the new remote sites you just added and click Finish.
   
   Figure 3. Select new remote sites
   
   
   
4. Expand IBM WebSphere Everyplace Micro Environment, expand Technologies, and add a check mark to WEME Windows Mobile 2003 ARM PDAP-PIM (Runtime 2.2), as Figure 4 shows.
   
   Figure 4. PIM Optional Package install
   
   
   
5. Also, expand IBM WebSphere Everyplace Micro Environment, expand Runtimes (Individual), and add a check mark in WEME Windows x86 MIDP 2.0 (Runtime 2.2) 5.7.1 as well as another check mark in WEME Windows Mobile 2003 ARM MIDP 2.0 (Runtime 2.2) 5.7.2 (see Figure 5).
   
   Figure 5. WebSphere Everyplace Micro Environment installation
   
   
   

   Click Next and perform the installations.

   You may be asked to restart the workbench after the installations are complete; select Yes.

Back to top

Install J9 Launcher plug-in

The J9 Launcher plug-in lets Eclipse recognize J9's VM as a valid Java Runtime Environment (JRE); it is available through the IBM WebSphere Everyplace Device Developer Tooling. To install the J9 Launcher plug-in:

1. On the Eclipse main menu, go to Help > Software Updates > Find and Install. On the Install/Update window, select Search for new features to install and click Next (see Figure 6).
   
   Figure 6. Eclipse's Install/Update window
   
   
   
2. On the Install/Update window, you will need to add a new remote site by clicking New Remote Site.
   
   Figure 7. Eclipse's New Remote Site window
   
   
   

   The name and URL of the new remote site you'll need to add is:

   • Name: IBM WebSphere Everyplace Device Developer Tooling
     URL: http://www.ibm.com/software/pervasive/wsdd/updates/571/tooling
3. Add a check mark to the new remote sites you just added and click Finish.
   
   Figure 8. Select new remote site
   
   
   
4. Expand IBM WebSphere Everyplace Device Developer Tooling, expand Tools, and add a check mark to WSDD J9 VM Launching 5.7.1.
   
   Figure 9. J9 Launcher plug-in install
   
   
   

   Click Next and perform the installation.

   You may be asked to restart the workbench after the installation process is complete; select Yes.

Configure Eclipse to use J9

For Eclipse to use J9, you must first install the J9 Launcher plug-in in the previous section.

To configure Eclipse to use J9:

1. Select Window > Preferences. The Preferences window opens. Expand the tree on the left panel and navigate to Java > Installed JREs, as Figure 10 shows.
   
   Figure 10. Eclipse Preferences window
   
   
   
2. Click Add to open the Add JRE window. On this window, set the options as follows:
   • JRE Type: Select J9 VM
   • JRE Name: Type "J9 MIDP 2.0" or any name you'd like to use to identify this JRE
   • JRE home directory: Browse to the directory where Eclipse installed WebSphere Everyplace Micro Environment (it should be in "C:\Program Files\ive2.2\runtimes\win32\x86\midp20").
   • Default VM Arguments: type "-jcl:midp20"

   Also, uncheck the option Use default system libraries, click Add External JARs, and add the following external classes:

   • WebSphere Everyplace Micro Environment MIDP 2.0 classes.zip: You can find this in "C:\Program Files\ive-2.2\runtimes\win32\x86\midp20\classes.zip".
   • PDAP Optional Package jar file: You can find this in "C:\Program Files\ive-2.2\runtimes\wm2003\arm\midp20\lib\jclMidp20\ext\pim.jar".
   
   
   Figure 11. Edit JRE window
   
   
   

   You should easily find the directories above, granted you successfully followed the instructions in the Install MIDP 2.0 and PIM optional package section. However, if you do not find the path, try searching your file system for pim.jar and it will point you to the correct path.

3. Click OK. You will see that you added the J9 2.2 MIDP 2.0 and can use it on your MIDP 2.0 PIM application.
   
   Figure 12. JRE window
   
   
   

   Click OK again to go back to the Eclipse workbench.

2 of 9 | Previous | Next

Comments

Back to top

Table of contents

• Before you start
• Installation and configuration
• The PIM Optional Package API
• Develop a PIM MIDlet application
• Deploy and run on a Windows Mobile device
• Summary
• Download
• Resources
• About the author

---

2 of 9 | Previous | Next

Local resources

• IBM Innovation Center - Austin, TX
• IBM Innovation Center - Chicago, IL
• IBM Innovation Center - Dallas, TX
• IBM Innovation Center - San Mateo, CA
• IBM Innovation Center - Waltham, MA
• Technical Briefings in North America

Dig deeper into Java on developerWorks

Discover knowledge paths

Skill-building guides for Java, Linux, open source, cloud, business analytics, and more.