2005/5/10

--
down ACDK
down Handbook
down Packages
down ACDK Core
down Installation
  down Compile ACDK
  down Upgrade ACDK
  down Create own Executable
  down Create own Library

(c) 2005 by
Roger Rene Kommer

Kindly hosted at:
SourceForge.net Logo

     
 

ACDK General installation notice
artefaktur

This is a generic installation for ACDK packages.


Content of this chapter:

   General notes
   Supported Plattforms
   Unpacking
     Unix
     Windows
   Setting up the environment
   Compiling using make files
     Unix
     Linux
       Notes for Linux
     Solaris
     Windows Visual Studio
       Visual Studio 6
       Visual Studio .NET / 7
   Missing Header/Libraries
   Compiling using acdkmake
     Usual targets
   More information



 General notes

ACDK is split in several packages. Each package can be installed/compiled separately.
Most packages depends on other ACDK packages. For instance the package acdk_lisp depends on acdk_core and acdk_text. These packages must be installed before you try to install and compile the acdk_lisp package. Please refer to the package documentation regarding the detailed requirements.


This installation note describes the installation of one ACDK package named "acdk_package".

 Supported Plattforms

Windows NT 4/2000/XPMS Visual C++ 6 (released)
Windows NT 4/2000/XPMS Visual C++ 7 (AKA .NET) (experimental)
Windows NT 4/2000/XPBCC 5.5 (experimental)
Windows NT 4/2000/XPBoland C++-Builder 5 (experimental)
Windows NT 4/2000/XPBoland C++-Builder 6 (experimental)
Windows NT 4/2000/XPgcc 2.92 (static linked)(experimental)
Linuxgcc 2.95.2 (released)
Sun Solarisgcc 2.95.2 (released)
Sun SolarisSun Workshop 5.2/3 (experimental)
FreeBSD 4.0gcc 2.95.2 (experimental)

 Unpacking

The ACDK packages are provided 2 formats: Unix .tar.gz and Windows .zip format. The packages contains the same files, but in the windows .zip packages the sources are encoded in the windows file format ("\r\n").

 Unix


cd /usr/local # the parent directory of ACDK
gunzip acdk_package-1.01.tar.gz # uncompress
tar xf acdk_package-1.01.tar # and untar the package

This extract the files into a directory:
/usr/local/acdk-1.01/acdk_package
where:
/usr/local/acdk-1.01
is the ACDKHOME.

You can make link of this directory to /usr/local/acdk

 Windows

On Windows platform unzip the ACDK package in one directory:


d:\artefaktur
This will create the directory:

d:\artefaktur\acdk-1.01


 Setting up the environment


Whenever you want to configure, compile, install or run ACDK, following environment variable are needed:
  • ACDKHOME: The home of ACDK, target of installed header, and other files.

  • PATH: Path to search executable. You may extend this with the ACDK binary path:
    export PATH=%PATH%:$ACDKHOME/bin # bash or ksh
  • LD_LIBRARY_PATH: Path to search shared libraries. You have to extend this to the ACDK library path:
    export PATH=%PATH%:$ACDKHOME/bin

On Windows you can set these environment variables in the system configurations.

 Compiling using make files

For the distributed ACDK packages the project files and makefiles are already generated.

The platform makes does understand normally following commands:
  • all: install and compile
  • install: copy the header and configuration in ACDKHOME/include
  • compile: compile the sources
  • clean: removes the .o/.obj files
  • test: run test units


 Unix

global settings for the make process can ajusted in the file $ACDKHOME/acdk_globals.${target} (target = linux, etc.) If this file exists, it will be included from the project make files.

 Linux

To compile ACDK you must have installed GCC 2.95.2 (or grater) compiler on your system.


cd /usr/local/acdk-1.01/acdk_package
make -f acdk_packakge.linux all

 Notes for Linux

On computer with more CPU, add __SMP__ define in the $ACDKHOME/acdk_globals.linux

 Solaris

To compile ACDK you must have installed GCC 2.95.2 (or grater) compiler on your system.

cd /usr/local/acdk-1.01/acdk_package
make -f acdk_packakge.sunos-gcc all

 Windows Visual Studio

 Visual Studio 6

You need Visual Studio 6 SP3 or later to compile the packages on Windows (NT/2000).

cd d:\artefaktur\acdk-1.01\acdk_package
nmake -f acdk_packakge.nmake all

You can also use Visual Studio to open the provided acdk_package.dsw, for installation (of headers) you must use the nmake file.

 Visual Studio .NET / 7

You can use the provided .dsw and .dsp also with Visual Studio .NET respectivally Visual C++ 7.

 Missing Header/Libraries

Some packages (f.e. acdk_perl, acdk_tcl, acdk_java, acdk_python, etc.) you need header to include and libraries to link. For these package you may have to correct the include and library settings in the make/project files.
Please refer also to the readmes of the packages.

 Compiling using acdkmake

Instead of using the platform 'make' you can also use acdkmake to build ACDK projects.

You need to download the acdk_tools package compiled for your platform.

Extract the acdk_tools package in different directory than acdk packages.

ACDK packages:
d:\projects\acdk\acdk_core\*.*
/d/projects/acdk/acdk_core/*.*
                 etc.

ACDK tools:
d:\projects\acdk_tools\*.*
/d/projects/acdk_tools/*.*

Set in shell (cmd, bash) the environment variables ACDK_TOOLS_HOME=/d/projects/acdk_tools and ACDKHOME=/d/projects/acdk.

extend the PATH with /d/projects/acdk_tools/bin On unices you may also have to extend the LD_LIBRARY_PATH with this directory.

In the package directory should be a build.csf file, which is the make file for acdkmake.
/d/projects/acdk/acdk_core/build.csf.

In this directory just execute acdkmake to compile the project.

 Usual targets

ACDK build.csf files normally understands following make commands:
  • build
  • clean
  • install
  • compile
  • test
Please refer to the  ACDK Make documentation for more information.


 More information