Configure your enviroment

As a preliminary phase, you should:

• get a recent eclipse (https://eclipse.org/downloads/) (egit + m2e plugins recommanded)
• get a recent JVM (a JVM 7 is recommanded)

Optionaly and as an alternative to eclipse egit and m2e plugins, you should:

• install Maven: http://maven.apache.org/guides/getting-started/maven-in-five-minutes.htm
• install a Git Client : http://git-scm.com/download/win
• optionnaly install Github Client: http://windows.github.com/

Import Openflexo Production Component

Get the openflexo-production tools first so that you can get the maven settings from the repository. On your Eclipse package explorer right click and select import in order to launch the import wizard.

The project can be imported from Openflexo team Git repository (https://github.com/openflexo-team/). In the wizard open Git folder and select Project from git, then click on next and select Clone URI. Again continue to the next step with next.

At this step you must to fill the URI of the openflexo-production repository which is https://github.com/openflexo-team/openflexo-production When you have filled the URI, the Host and Repository path are automatically setup, so just click on next.

The next wizard presents the different branches associated with openflexo-production project, select all branches and continue with next.

Now you have to set your local git directory as well as the initial branch. Select branch 0.2 and next.

Select import as general project and next and finish.

The corresponding project should be now visible on your Eclipse workspace.

Right click on it and select convert to maven project. Your project should have a “M” icon now.

Right click again on your project and import -> Maven/Import Existing Maven Projects

Select all project and terminate with finish button.

Contained projects should be visible in your workspace.

Import other components

In the same way you can import any other openflexo projects from the openflexo git repository. Project URIs are :

• Connie : https://github.com/openflexo-team/connie
• Pamela : https://github.com/openflexo-team/pamela
• Gina : https://github.com/openflexo-team/gina
• Diana : https://github.com/openflexo-team/diana
• OpenflexoUtils : https://github.com/openflexo-team/openflexo-utils
• OpenflexoCore : https://github.com/openflexo-team/openflexo-core
• TechnologyAdapters : https://github.com/openflexo-team/openflexo-technology-adapters
• OpenflexoModules : https://github.com/openflexo-team/openflexo-modules
• Packaging : https://github.com/openflexo-team/openflexo-packaging
• Modelers : https://github.com/openflexo-team/modelers

Branches to use are those (for 1.8.x infrastructure) :

As an example with Connie which contains several branches, clone all branches.

Select the 1.3 as initial branch (1.3 is now the branch to use with 1.8.0 infrastructure).

Finnaly your workspace should contains your set of imported projects.

Updating the maven setting file

Depending on your setup environment, your maven project might requires some artifacts that cannot be found in your local repository. Openflexo provides an Artifactory which maintains all openflexo required artifacts. However Maven natively checks in his known repositories, so you have to update Maven’s settings.xml file to link to Openflexo Artifactory.

This can be done in different ways:

• copy the settings.xml file presents in openflexo-production project to your home .m2 directory,
• or merge it with your existing one.
• or through Eclipse : Windows->Preference->Maven->User Settings.

If some projects contains errors, try to update maven dependencies, in Eclipse right click on your project and select Maven->Update Project:

Then confirm the project you want to invoke, select force update of snapshots release and validate.

Run Openflexo packaging

To run from Eclipse an Openflexo packaging from openflexo-packaging project, create a new Eclise Run Configuration. Set the project to one of the existing packagings(flexomaintainer, flexosemantics, flexosemanticsplus…) And the main class org.openflexo.Flexo (depending on eclipse version, searching feature does not find org.openflexo.Flexo class, so you have to enter it manually)

Configure Push to Upstream

Open the git perspective, and right click on the project for which you want to push your commits, and select properties.

• Set the autocrlf property to true
• Set the push properties
• Check the github url(should be ssh).

Notes

• Ajouter le certificat intermediaire gandi à l’installation Java (http://ksssblogs.blogspot.fr/2013/06/peer-not-authenticated-maven-build-error.html):
• télécharger ici: http://wiki.gandi.net/fr/ssl/intermediate (Standard et .pem)
• utiliser l’interface accessible via le menu “configure java” (CA du signataire) (copie d’écran à faire) => Marche pas
• ça ça marche: => -Djavax.net.ssl.trustStore=c:\path\to\yourCustomKeystore (from https://confluence.atlassian.com/display/CONFKB/Unable+to+Install+Plugin+Due+to+Maven+SSL)
• d’abord créer le keystore: F:\SourceCode\openflexo-core>keytool -import -file openflexo.org.crt -keystore myKeystore
• puis: F:\SourceCode\openflexo-core>mvn -Djavax.net.ssl.trustStore=..\myKeystore compile’’