fixed app. acronym in README
[iDMC.git] / COMPILING
bloba6ac02e3677ac851ed0c54f622a0c1db7c92bbce
1 HOW TO COMPILE dmcDue/iDmc
2 --------------------------
4 Starting from the 2.x.x series, iDmc is a pure Java program
5 (although it depends on the native idmclib library).
7 iDmc was developed under Debian and Ubuntu GNU/Linux mainly using the IBM Eclipse
8 IDE (www.eclipse.org) and Netbeans.
10 The Java part is Java2 1.6 compliant.
12 Full and successful compile and runtime testing was done with Sun's Java2 
13 SDK/JRE 1.5.0_08 under Ubuntu GNU/Linux (x86_64/x86_32) and under Micro$oft Windows XP.
15 The compilation defaults to produce a "static" jar file. This is to avoid dependencies hells only and is not stricly
16 required.
18 Sofware you need to compile:
20 - Java2 SDK 1.6 or above
21   java.sun.com/j2se/
23 - Apace ant 1.5 or above
24   http://ant.apache.org/
26 Third part libraries:
28 - idmclib: The iDMC C support library, version 0.7.x
29   http://code.google.com/p/idmclib
31 - JGoodies Forms, Java panels layout library
32   http://www.jgoodies.com/
34 - JFree JFreeChart 0.9.18: a free Java class library for generating charts
35   www.jfree.org
37 - JCommon 0.9.3: used by JFreeChart
38   www.jfree.org
40 - jakarta-log4j-1.2.14: logging library used by JFreeChart
41   http://logging.apache.org/log4j/docs
43 The JGoodies Forms library API is stable so, generally
44 speaking, you should be able to use more recent versions of this
45 library. About JFreeChart, the core library of the program, stick to
46 the specified version or you'll certainly have to adapt part of the
47 code.
48 For compiling idmclib from sources, other dependencies are involved.
49 Read idmclib compiling instructions for an up-to-date reference.
51 To compile under Linux using the included build.xml unpack all the packages 
52 in a same directory. Compile the idmclib library by following boundled compiling istructions.
53 For more details, or in case of troubles, try ask 
54 in mailing list and/or package mantainers.
55 When idmclib is compiled, go to the iDmc folder:
56 $ cd ../../iDmc-2.x.x
58 Finally, use ant to compile all:
59 $ ant dist-linux
61 Look for other ant targets in the build.xml file.
62 In principle, the same steps works also under Windows, using the MinGW/MSYS 
63 environment for compiling idmclib and issuing 'ant dist' for actual iDMC building. 
64 Read idmclib documentation for further hints about that. 
65 Anyway, the project mantainer will generally take care of distributing
66 precompiled windows binaries.
68 In the misc directory you will also find a no longer maintaned NSIS (Nullsoft Scriptable
69 Install System, http://nsis.sourceforge.net/home/) script to create
70 Windows autoinstaller packages.
71 In the installer directory you will find support files for generating the win/linux 
72 IzPack installer. You can generate it under linux, taking care to place the windows native DLL
73 in the iDmc root directory.
75 Daniele Pizzoni <auouo@tin.it>
76 Upgraded by Antonio, Fabio Di Narzo <antonio.fabio@gmail.com> on 06/07/2007