Difference between revisions of "Create your ADempiere development environment"

Revision as of 12:01, 24 March 2007

Preparing your Environment

Download and install

• JAVA
• Eclipse
• SubClipse (SVN) or Subversive (SVN)

Subclipse enables you to access the Adempiere subversion repository (SVN) through eclipse.

Subclipse installation

1.- Automatic subclipse installation

In Eclipse Menu->Help/Software Updates/Find&Install. Select Subclipse

2.- Manual installation

If automatic subclipse installation fails: Download Subclipse installation file (e.g. site-1.2.0.zip). In Eclipse Menu->Help/Software Updates/Find&Install. Search for "New features to install", "New archived site". Select downloaded file (e.g. site-1.2.0.zip). In the following dialog deactivate "Subclipse mylar integration".

Verification of correct Subclipse installation: Eclipse Menue ->Help/Software Updates/Manage Configuration. If you expand eclipse expandiert, youl will see for example Subclipse 1.2.0.

• Oracle10g XE or PostgreSQL

These tools install differently depending on your Operating System. When provided information on these websites does not suffice, try to find help on the forums of your Operating System or unofficial forums about these tools.

For Oracle installation un Linux: read and follow carefully each step described in http://www.puschitz.com/InstallingOracle10gOnSUSE.shtml.

Download ADempiere sources

1 Download ADempiere sources with Subclipse (for Linux and Windows)

First, you have to work in the "SVN Repository Exploring" perspective:

• Open Eclipse
• Eclipse menu->Window->Open Perspective->Other
• Then select SVN Repository Exploring

Create a new Repository Location within the "SVN Repository Exploring" :

• right mouse click on SVN Repository Exploring->New->Repository location.
• Type in the location URL: https://adempiere.svn.sourceforge.net/svnroot/adempiere. The Adempiere SVN Repository tree will be created.
• Open the Repository tree and check out.

2 Download ADempiere sources with Tortoise SVN (only for Windows)

• Download and Install Tortoise (http://tortoisesvn.net/downloads). Tortoise is integrated with Windows explorer.
• Create a directory e.g. C:\srcAdempiere\trunk
• Open windows explorer and navigate to e.g. C:\srcAdempiere\trunk
• Right click on trunk and choose "SVN checkout"
• Fill URL of repository with: https://adempiere.svn.sourceforge.net/svnroot/adempiere/trunk
• Click OK. It starts checking out the trunk immediately. If the connection broke in the middle of checkout, you just right-click on trunk and select "SVN update" option. This applies for normal updates.

3 Checking out

There are two different flavours:

• checking out Adempiere as a single project
• Checking out the projects of the trunk once at a time

Both alternatives work and have their advantages/disadvantages.

- Checking out many projects allow closing some projects in Eclipse and thus reduce memory usage. Multiple projects allow to use project dependency.

- Checking out one sigle project is less time-consuming.

Choose the one you feel most comfortable with.

Compile ADempiere sources

Although sources don't compile right away, nothing is really wrong with it. All you need to do is checking the Java Build Path and libraries of each project that doesn't compile. It happens these paths need an update before eclipse manages to compile it all.

To make things easier, follow this list in same order. This way you respect the project dependencies.

• Tools
• Looks
• dbPort
• Print
• Base
• serverRoot
• Interfaces
• Extend
• Client
• serverApps
• Install
• sqlj
• webstore
• doc

See also

• Hacker's guide