The next step is to configure it for work with Domino. Thankfully, Nathan Freeman has done a great job at making it very easy to do so. I’ll go through the installation first and then explain what’s set. You need to download and install XPages SDK for Eclipse RCP project from OpenNTF into Eclipse. This is an Update Site, something else Domino Developers should already be familiar with. The only difference is that instead of File > Application > Install, you select Help > Install New Software…. The good news is youo’re only prompted once to confirm you want to install the plugin (another limitation of Domino Designer being based on an old version of Eclipse).

Once installed and Eclipse has restarted, you will need to point to your Notes and Domino install locations in Window > Preferences. Youo will have a new option in the left-hand navigation for XPages SDK, so click on that. Point it to your Notes and Domino installation locations, ensuring the tick is enabled to automatically create JRE.

xpages sdk

If you don’t have a Domino server installed, you can probably leave that, but that does cause limitations for debugging code. Clicking Apply will create the JREs, which you can see under Java > Installed JREs.

The final step is to add a target platform to build code against. This is done under Plug-in Development > Target Platform. If you click Add then in the Template you will now be able to select Domino Install Target or Notes Install Target.

target platform

The two key aspects that have been configured here are the JRE and Target Platform.

If I understand the JRE correctly, this is used to determine which additional plugins or jar files are available, along with their location.If you look at the JREs in the preferences, you’ll see that information stored:

jre

A specific plugin can be mapped to a specific JRE. This will be displayed within the project in the JRE System Library area.

project jre

It can be changed by right-clicking here and going to Build Path > Configure Build Path…. The relevant JRE will be highlighted on the Libraries tab. You can click Edit and change accordingly.

change jre

The JRE defines which Java classes are available when compiling your code. The Target Platform is used to determine the application normal plugin projects are built for as well as the workspace default JRE for that build process. That means you don’t have to specifically define it on each project, which is preferable because different people may have called the JRE different names. So that is usually the preferred setting, rather than using Alternate JRE, which shows in the screenshot above.

Contents

1 thought on “XPages OSGi Plugins 3: Configuring for Domino”

  1. “The only difference is that instead of File > Application > Install, you select Help > Install New Software…. ”
    — File>Application>Install is in Notes where Help>Install New Software is found in the Eclipse menu

    “If you look at the JREs in the preferences, you’ll see that information stored:”
    — here’s where to find the Edit JRE button:
    Follow the below given image to edit java directory path in Eclipse IDE
    Eclipse IDE > Windows > Preferences > Java > Installed JREs :: [Edit JRE] button

Leave a Comment

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Scroll to Top