Log In | Sign Up   View a printable version of the current page.
  Dashboard > flexive > ... > Developer Info > IDE Integration

Added by Markus Plesser, last edited by Hans Bacher on Oct 20, 2008  (view change)
Labels: 
(None)

IDE Integration

IDEA 7.x

In each modules resources folder exists an .iml file that can be used to import it into idea. The modules have the correct dependencies set.

To checkout and setup IDEA for the framework follow these instructions:

  • Launch IDEA
  • Version Control|Checkout from Version Control|Subversion
  • Add a new repository by clicking the "+" icon
  • In the dialogbox enter "http://svn.flexive.org/repository/flexive" and click "OK"
  • Open the tree that appears and select "trunk"
  • Click "Checkout"
  • In the "Select Path" dialog create a new directory (I used /home/<user>/develop/flexive)
  • Select the directory and click "OK"
  • Check all options in the next dialog box and wait until flexive has been checked out
  • Select "No" when asked if you wish to create a project from the sources you just checked out (we will use the provided module files instead)
  • Create a new project using File|New Project...
  • Select "Create project from scratch" and click "Next"
  • Enter "flexive" as name and select the directory where you checked out flexive before as "Project file location" and uncheck Create module!
  • Click finish
  • The "Project Settings" dialog will appear, select "Module" in the left panel and click the "+" icon above the second panel to the left
  • Repeat this by selecting Import existing module for the following files:
    • src/framework/resources/framework.iml
    • src/ui/jsf-backend/resources/web-jsf-backend.iml
    • src/ui/jsf-componentes/web-jsf-components.iml
    • src/ui/jsf-globalconfig/web-jsf-globalconfig.iml
    • src/ui/shared/resources/web-shared.iml
    • root.iml
    • docbook/docbook.iml - if you plan on writing documentation
    • at the bottom right click the "Apply" button and then the "Ok" button.
  • Make sure to install the JetGroovy plugin if you plan on coding using Groovy
  • Create a custom build.properties file by selecting build.properties.sample in the root-module inside the project view.
    • Right click the file and select Refactor|Copy (or press F5).
    • As new name enter build.properties, then click "OK".
    • Don't include this file in version control!
    • Adjust the paths/properties according to your needs
  • Enable version control by selecting File|Settings|Project Settings|Version Control and choosing Subversion for <Project Root>
  • To configure ANT, click the Ant Build-tab on the right side, select the "+" icon and add build.xml from the projects root directory

Please make sure that you do not commit back your modified .iml files as IDEA will modify them every blue moon for sure
I'd recommend moving them to a separate changelist so you can't accidently commit them.

Eclipse 3.2

  1. Go to http://www.eclipse.org and download the latest build
  2. Unpack the distribution and start eclipse
  3. Go to Help|Software Updates|Find and install ...
  4. Install updates from the callisto discovery site

Checkstyle integration

[fleXive] comes with a Checkstyle configuration. When working on [fleXive] code, you might want to install the eclipse plugin and try not to add new warnings to the source code. The flexive checks can be added as a global configuration in Preferences|Checkstyle|Global Check Configurations, the file is src/framework/resources/checkstyle/flexive_checks.xml. We are aware that our own code is not 100% compliant, but at least we try.

Optional Plugins you might want to try:

Callisto Release

Can be grabbed from here.

Linux issues

Eclipse 3.2 uses an embedded mozilla renderer.
Issues regarding this renderer are described here and here.
A solution can be found here:
Download mozilla for linux and point MOZILLA_FIVE_HOME to your mozilla installation. Please note that the firefox distribution from mozilla.org is not compiled with embeddable support:

export MOZILLA_FIVE_HOME=/usr/lib/mozilla

Checkout [fleXive]

  • File|New|Other... -> SVN|Checkout Projects from SVN
  • "Create a new repository location"
  • Select trunk|flexive
  • "Checkout as project configured using the New Project Wizard"
    MISSING SOMETHING
  • after checkout delete the project but not the contents!
  • "Java project from existing ant build file" -> choose the build.xml file from the checked out repository
  • If you use checkstyle, activate the flexive configuration in the project's preferences.

Workspace setup

  • Facelet DTD validation:
    Open Preferences|Web and XML|XML Catalog and add a new entry. Enter:
    URI: use a local facelet DTD definition or enter "jar:platform:/resource/flexive/lib/jsf/jsf-facelets.jar!/facelet-taglib_1_0.dtd"
    Key: "-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN".

    Note: this adds validation for editing facelet taglib definitions, not XHTML autocompletion for facelets.

Site running on a free Atlassian Confluence Open Source Project License granted to [fleXive] . Evaluate Confluence today.
Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.6.1 Build:#916 Nov 09, 2007) - Bug/feature request - Contact Administrators