Building Report Manager Designer and tools

Developer

Building Report Manager Designer and tools

Here is a detailed explanation on how to build Report Manager binaries.

If you build and distribute Report Manager binaries you must report that it's another version, you can change the version (rpmdconts.pas), this is because obvious practical reasons.

Required tools

Windows	Linux
Delphi (legacy 6/7 Professional, now Embarcadero Delphi) Enterprise version is required for translation manager features	Kylix 2/3 Professional (legacy, discontinued), open edition was reported to compile also a previous installation of the FreeCLX (legacy)
InnoSetup 2.019 to build autoinstallable executable	GNU Makefile to build the distributable tar.gz package, this tool is usually provided by all linux distributions
Git to obtain the source and contribute actively in the project (legacy versions used CVS over SSH).	A Git client is provided in most linux distributions and is installed by default if developer workstation installation is selected.

The following steps are for building Report Manager from Delphi/Kylix IDE. You can also build the packages from the command line.

Building Report Manager from the IDE

1.Install Report Manager packages

Install all Report Manager packages, follow instructions for Delphi and Kylix.

2.Update language resources(Windows only)

If you modified the resources (forms,resourcestrings) the language resources must be updated.

You can omit this step, but don't distribute the repman\transwin\repmand.* and repman\transwin\repmandxp.* because are old resource libs.

Only repmand.dpr an repmandxp.dpr must be updated.

Open repman\repmand.dpr and select Project-Languages-Update Resource DLLs

Open repman\repmandxp.dpr and select Project-Languages-Update Resource DLLs

Open repman\metaview.dpr and select Project-Languages-Update Resource DLLs

Open repman\metaviewxp.dpr and select Project-Languages-Update Resource DLLs

After that you can translate the strings you added.

Build the resources for all languages then copy them to repman\transwin directory.

3.Build the applications

The current Report Manager Designer is a Windows VCL application, so it looks like any other native Windows program. Historically there were two variants of various applications (a legacy Qt/CLX-based one and the pure VCL one, the latter marked here as xp); only the pure VCL build is current.

You must open and compile the following project groups:

Windows	Linux
repman\reportman.bpg (legacy; current builds use repman\reportmanxe2.groupproj)	repman\reportman.bpg (legacy)
repman\reportmanxp.bpg (legacy)

4.Build installation packages

After executable applications are built, you can build the distributable packages to easy install Report manager designer in other computers.

Windows Linux

Open install\reportman.iss with Innosetup if you want all the versions (Qt and no Qt)

cd tests\repmand

make clean

make

Open \install\reportman.iss with Innosetup if you want the applications without qt dependencies (the docs are also removed because are internet enabled) Note: Edit GNUmakefile in \tests\repmand and specify your path to Kylix installation

5. Distribution of source packages for Linux and Delphi

To distribute the installable packages it's recommended to use Windows because source code compatibility with Delphi 5/Builder 4 (MSDOS style line ends)

Go to the main tree in a console window and with the Embarcadero/Delphi make in the path type

make clean

This will delete any dcus, dpus unnecessary files (warning also cleans the executables)

Zip all the files in one and it's done.

Building Report Manager from the command line

To build Report Manager from the command line in Windows you must have Borland make in the path (not GNU make), for Linux GNU make is used.

Start a terminal window (command prompt in Windows) and cd to main reportman directory, that is the directory containing the .dpk files GNUmakefile(Linux) and Makefile (Windows).

Edit GNUmakefile (Linux) or Makefile (Windows) and set Borland Delphi path or Kylix path environment variables to correct paths.

Enter:

make all

All the packages and command line tools will be compiled.

If you want to compile only packages you can write make packages or make reportman to compile only executables, see available options by opening the file GNUmakefile in Linux or Makefile in Windows.

The command make clean will delete all generated executables and compiled files.