Installing the Eclipse IDE

Although the use of an IDE, and in particular Eclipse, is not a requirement, it certainly eases the development of Darwino applications. In particular, it also helps validate that all the requirements are met (installed software, configuration files...)

In order to configure web servers and get the best web development experience, please download and install the latest version of 'Eclipse IDE for Java EE Developers‘ (NOT Eclipse IDE for Java Developers).

Darwino run best with the latest Eclipse version, currently Neon-1. Although it has been tested with earlier versions like Mars-1, the maven integration definitively works best with Neon.

Installing Eclipse is achieved by unzipping the archive in its target directory. The following directory structure shows eclipse unzipped into the c:\Darwino directory:

Launching Eclipse for the first time

When Eclipse is launched for the first time, it prompts for a workspace directory. The default value is fine, but well, you could also make this directory a peer of the eclipse one, to get the whole environment contained within c:\Darwino:

Installing the Darwino Studio add-on

The first module to install is the Darwino Studio. Bellow are the instructions:

  1. Select Help > Install New Software.

  2. In the "Work With:" field, enter the following URL, depending on the edition you selected:

    Note that you can also install the nightly builds by using the URLs bellow. The nightly builds provide access to the latest version, under development

  3. When prompted, enter your Darwino user and password, as provided during the registration process.

  4. In the Available Software dialog, select the Darwino Studio checkbox.

  5. In the next window, you'll see a list of the tools to be downloaded. Click Next.

  6. Read and accept the license agreements, then click Finish.

  7. If you get a security warning saying that the authenticity or validity of the software can't be established, click OK.

  8. When the installation completes, restart Eclipse.

Validating the configuration

The Darwino studio, once installed, features an installation validation module available under Window->Preferences / Darwino: This module checks your environment and gives you guidance on the next actions:

  • Having Maven settings.xml properly configured
  • Having the Darwino configuration files at the right place
  • Making sure that the Eclipse dependencies are installed

Windows Eclipse JRE/JDK

On Windows, Eclipse will sometimes pick up on an installed JRE instead of the full JDK, which will manifest during a Maven build with a error about not finding a Java compiler. To rectify this, go to Eclipse's preferences, then Java → Installed JREs:

Eclipse JREs

Select the currently-active one, click "Edit…" and point it at a "jdk" directory, usually within "C:\Program Files\Java":

Eclipse JDK fix

Manually Configuring Eclipse

The configuration validator exposed above should give you all the necessary information but some details are exposed bellow.

Darwino requires some extra plug-ins bellow to be installed on top of the version of Eclipse. These plug-ins can generally be installed from the Eclipse Marketplace or by selecting Help → Install New Software..., then use the provided update site URL

  • If Android is a desired target platform:

    • Andmore (successor to Google's ADT), Select Help → Eclipse → Marketplace... and search for andmore. It will be called something like "Andmore: Development Tools for Android"
    • Note: during the process for installing m2e adapters (as with Tycho below), the m2e adapter for Android may prompt you to install the earlier Android Development Toolkit. If so, and you already have Andmore installed, deselect those plugins during the m2e setup.
  • If iOS is a desired target platform:

  • If IBM Domino is a desired target platform

    • The Darwino project wizard as well as the sample applications use Tycho to target OSGi platforms (Eclipse, IBM Domino...). As a result, it requires the Tycho m2e connector to be installed. The easiest way to get it installed is to wait from Eclipse to display a build problem (see bellow), right click on the issue and choose quick fix. Eclipse will automatically propose to download and install the connector.

Eclipse Add-ons Information

results matching ""

    No results matching ""