ACDK 安装通常需要注意的事项（安装手册）

 

本章正文:

 

   一般注意事项

   支持的平台

   解压缩文件

     Unix

     Windows

   设置环境

   使用Make编译

     Unix

     Linux

       Linux注意事项

     Solaris

     Windows Visual Studio

       Visual Studio 6

       Visual Studio .NET / 7

   缺少的头文件/库文件

   使用acdkmake编译

     通常的目标

   需要的库

   更多的信息

 

 

一般注意事项

ACDK是一组独立的包组成. 每个包都可以独立地被安装/编译.

大部分的包依赖其他的ACDK包，例如：包acdk_lisp依赖于acdk_core和acdk_text. 这些包必须在你试图编译和安装acdk_lisp包之前安装完毕。清仔细阅读包的文档，以便确定详细的要求

 

这一个安装手册描述一个叫做”acdk_package”的 ACDK 包的安装。

 

 支持的操作系统平台

Windows NT 4/2000/XP       MS Visual C++ 6 (发布的)

Windows NT 4/2000/XP       MS Visual C++ 7/2003 (AKA .NET) (实验性质的)

Windows NT 4/2000/XP       BCC 5.5 (实验性质的)

Windows NT 4/2000/XP       Boland C++-Builder 5 (实验性质的)

Windows NT 4/2000/XP       Boland C++-Builder 6 (实验性质的)

Windows NT 4/2000/XP       gcc 2.92 (静态连接)(实验性质的)

Linux      gcc 2.95.2 - 3.4 (发布的)

Sun Solaris       gcc 2.95.2 - 3.4(发布的)

Sun Solaris       Sun Workshop 5.2/3 (实验性质的)

FreeBSD 4.0       gcc 2.95.2 - 3.4(实验性质的)

 

解压缩文件

ACDK 包提供了2种格式:Unix的tar.gz和Windows的.zip格式.这两种格式包含了相同的文件.但是在windows.zip包中源代码的编码使用了windows文件习惯(“\r\n”行标记)

 

 Unix

你可以解压缩ACDK到你的home目录或者在任何特定的目录

 

cd /usr/local # ACDK的父目录

tar zxf acdk-*.tar.gz # 释放包

 

 

文件被释放到了这个目录:

/usr/local/acdk/

目录:

/usr/local/acdk

是 ACDKHOME(ACDK的根目录)

 

 Windows

在Windows平台用unzip(当然也可以使用其他的工具) 解压缩ACDK

 

例如释放到目录d:\artefaktur中,那么acdk将会在d:\artefaktur\acdk

 

 设置环境

 

只要你想去configure,编译,安装或者运行ACDK,下面的环境变量是必需的:

 

    * ACDKHOME: ACDK的根目录, 用来存放安装好地头文件以及其他文件.

 

    * PATH: 可执行文件的搜索路径.你可以释放下面的ACDK可执行文件路经:

      export PATH=%PATH%:$ACDKHOME/bin # bash 或者ksh

    * LD_LIBRARY_PATH: 共享库的搜索路径,你必须释放这个路径,它需要指向ACDK的 库路径 shared libraries. You have to extend this to the ACDK library path:

      export PATH=%PATH%:$ACDKHOME/bin

 

 

在windows你可以在系统的设置中设置这些环境变量

 

 使用make文件编译

发布的ACDK 包中,项目文件和makefile已经生成完毕了

 

用make编译makefile时候,make可以理解下面的命令参数:

 

    * all: 编译并且安装

    * install: 复制所有的头文件和配置到ACDKHOME/include

    * compile: 编译源代码

    * clean: 删除所有的.o/.obj 等中间文件

    * test: 运行测试工具

 

 

 Unix

Make处理全局的设置(外部的库,例如perl,python,wxWidgets等等)可以被引用在文件$ACDKHOME/acdk_globals.${target} (target = linux, 等等.) 如果这个文件存在,他将被包含make文件中

 

 Linux

在linux下编译ACDK你必须安装GCC2.95.2或者更高版本的编译器在你的系统

 

cd /usr/local/acdk/acdk

make -f acdk_all.linux all

 

 

Linux下注意事项

在一台计算机超过1个CPU的情况下(多处理器系统)需要添加__SMP__ 定义到$ACDKHOME/acdk_globals.linux 文件中

 

 Solaris

如果打算编译ACDK那么你就必须安装GCC2.95.2或者更高版本的编译器,不能使用SUN的编译器

 

cd /usr/local/acdk

make -f acdk_all.sunos-gcc all

 

 

Windows Visual Studio

 Visual Studio 6

你必须安装 Visual Studio 6 SP3 或者更高版本的补丁包,并且必须在Window(NT/2000)或者更高版本的操作系统上编译

 

 

cd d:\artefaktur\acdk

nmake -f acdk_all.nmake all

 

你也可以使用Visual Studio打开.dsw文件,但是你必须首先执行nmake -f acdk_all.nmake以便安装头和配置文件.

 

 Visual Studio .NET

你可以使用.dsw文件和 .dsp文件去编译这个项目

 

 缺少的头文件/或者库文件

某些包(例如：acdk_perl, acdk_tcl, acdk_java, acdk_python,等.) 你需要附加的头文件以便包含和库文件以便连接. 对于这些包，你不得不手工设置正确的包含文件路径和库文件路径在项目或者make文件中，这些文件通常都是属于第三方的，因此你需要安装相应的开发包后菜可以使用，例如acdk_java需要完全安装j2sdk并经过设置才能正常编译。

 

请仔细阅读这些包的readme文件.

 

使用acdkmake编译

 

作为一种代替,你也可以使用acdkmake去代替你的平台上的原有的make来编译acdk项目

 

你需要下载acdk_tools包来为你的平台编译才可以

!

acdk_tools包并不是总有可以使用的2进制发布包,因此你可能需要自己编译源代码       .这时你就必须使用本地的make去编译acdk_core,acdk_text,acdk_make.

 

释放acdk_tools包到一个不同于其他acdk包的目录中

 

ACDK packages:

d:\projects\acdk\acdk_core\*.*

/d/projects/acdk/acdk_core/*.*

                 etc.

 

ACDK tools:

d:\projects\acdk_tools\*.*

/d/projects/acdk_tools/*.*

 

 

在shell (cmd, bash)中设置环境变量

ACDK_TOOLS_HOME=/d/projects/acdk_tools and ACDKHOME=/d/projects/acdk.

 

释放路径/d/projects/acdk_tools/bin,也必须设置环境变量LD_LIBRARY_PATH指向你的目录

 

在包的目录中应该由build.csf文件,这个文件就是acdkmake的make文件.

/d/projects/acdk/acdk_core/build.csf.

 

在这个目录中你可以执行acdkmake命令去编译这个项目.

 

 通常的目标

ACDK build.csf 文件通常接受下面的编译选项:

 

    * build

    * clean

    * install

    * compile

    * test

 

请参看相应的ACDK Make 文档以便得到更多的信息

(http://acdk.sourceforge.net/acdk/modules/acdk_make/docs/acdk_make_man.html ).

 

 需要的库(附加库)

某些包需要附加的库:

 

    * acdk_java:  Java SDK (1.3) 在 java.sun.com.

    * acdk_tcl:  Tcl 在 tcl.sourceforge.net.

    * acdk_perl:  Perl 5.x 在 www.perl.com or  www.activestate.com.

    * acdk_python:  Python 在 www.python.org.

    * acdk_wx:  wxWidgets 在 www.wxwidgets.org.