16.1. 用Visual C++或Microsoft Windows SDK编译 · PostgreSQL 中文文档 9.3

# 16.1\. 用Visual C++或Microsoft Windows SDK编译 PostgreSQL可以使用微软的Visual C++编译器套件来编译。这些编译器可以是Visual Studio, Visual Studio Express或者某些版本的Microsoft Windows SDK。如果没有安装Visual Studio的环境，最简单的方法是使用Windows SDK 7.1或者Visual Studio Express 2012 for Windows Desktop中的编译器, 它们都可以从微软官网免费下载。 PostgreSQL支持从Visual Studio 2005到Visual Studio 2012(包括精简版)的编译器, 以及6.0到7.1版本的独立的Windows SDK编译器。 64位的PostgreSQL只支持6.0a到7.1版本的Microsoft Windows SDK和Visual Studio 2008及其以上版本。用Visual C++或Platform SDK编译的工具在`src/tools/msvc`目录下。编译时，确保系统路径下没有包含MinGW或Cygwin的工具，同时所需要的Visual C++工具在系统路径下是可用的。在Visual Studio中，启动Visual Studio Command Prompt。如果需要编译64位的版本，使用64位版本的命令，反之亦然。在Microsoft Windows SDK中，从开始菜单中SDK下的列表启动CMD shell。在最新版的SDK中，你可以使用`setenv`等命令来更改目标的CPU架构，编译类型和操作系统类型。指令`setenv /x86 /release /xp`用来编译Windows XP或更新的32位版本。使用`/?`命令可以查看`setenv`的其它用法。所有命令都应该在`src\tools\msvc`目录下运行。在编译前，根据需要修改`config.pl`中相应选项和使用到的第三方库的路径。完整的配置由首先读取和解析的`config_default.pl`决定，然后从`config.pl`获取变更。例如，为了指定Python的安装路径，在`config.pl`文件中添加以下语句: ``` $config->{python} = 'c:\python26'; ``` 只需要指定和`config_default.pl`文件中有差别的参数。如果需要指定其它的环境变量，创建一个`buildenv.pl`文件并写入所需要的命令。例如，为了在PATH中添加一个还不存在的bison变量，创建一个文件包含以下内容： ``` $ENV{PATH}=$ENV{PATH} . ';c:\some\where\bison\bin'; ``` ## 16.1.1\. 要求编译PostgreSQL还需要以下几个工具。使用`config.pl`文件来指定这些库的路径。 Microsoft Windows SDK 如果编译环境不兼容所支持的Microsoft Windows SDK版本，建议把SDK的版本升级到最新的版本(目前为7.1版本),下载地址为[http://www.microsoft.com/downloads/](http://www.microsoft.com/downloads/)。在SDK中，必须要保证包含Windows Headers and Libraries这部分内容。如果安装的Windows SDK中已经包含了Visual C++ Compilers，就不再需要使用Visual Studio进行编译了。注意Windows SDK 8.0a之后的版本不再附有完整的命令行编译环境。 ActiveState Perl ActiveState Perl用于编译生成脚本，而MinGW或Cygwin的Perl则不起作用。同样，它的路径也要添加到系统路径中。二进制文件下载地址为[http://www.activestate.com](http://www.activestate.com) (注意: 必须使用5.8或者更新的版本，免费的标准版既可）。下面的工具在开始时是不需要的，但是对于完整的包的编译是必须的。使用`config.pl`文件来指定这些库的路径。 ActiveState TCL 用于编译PL/TCL(注意:要求8.4版本，免费的标准版既可）。 Bison and Flex Bison and Flex用来从GIT进行编译，对于发行版文件的编译是不需要的。 Bison需要1.875或2.2及更新版本。Flex需要使用2.5.31或更新版本。 Bison and Flex包含在msys工具套件内。作为MinGW编译器套件的一部分，msys可以从[http://www.mingw.org/wiki/MSYS](http://www.mingw.org/wiki/MSYS)下载。同时作为msysGit的一部分，msys也可以从[http://git-scm.com/](http://git-scm.com/)下载。在`buildenv.pl`中，需要把包含`flex.exe`和`bison.exe`的目录添加到系统路径中，除非它们已经存在于系统路径中。对于MinGW, 要把MinGW安装目录的子目录路径`\msys\1.0\bin`添加到系统路径中。对于msysGit,要把Git安装目录下的`bin`目录添加到系统路径中。不要添加MinGW编译工具本身的目录到系统路径中。 > **Note:** GnuWin32中的Bison存在一个bug，当文件安装的路径中含有空格的时候，会导致Bison出现故障。例如，用英文安装时的默认路径`C:\Program Files\GnuWin32`时会出现上述问题，解决办法是安装在类似`C:\GnuWin32`这样的目录，或者在GnuWin32的环境变量PATH中使用NTFS短名称路径(例如`C:\PROGRA~1\GnuWin32`)。 > **Note:** 在PostgreSQL FTP上的winflex是旧的二进制版本，在64位Windows主机上执行时，会报"flex: fatal internal error, exec failed"的错误。可以使用msys中的flex来替代以避免这个问题。 Diff Diff用于进行回归测试，可以从[http://gnuwin32.sourceforge.net](http://gnuwin32.sourceforge.net)下载。 Gettext Gettext用于编译NLS支持，可以从[http://gnuwin32.sourceforge.net](http://gnuwin32.sourceforge.net)下载。需要注意的是二进制，依赖项和开发文件都需要。 MIT Kerberos MIT Kerberos 用于提供Kerberos认证支持，可以从[http://web.mit.edu/Kerberos/dist/index.html](http://web.mit.edu/Kerberos/dist/index.html)下载。 libxml2 and libxslt libxml2和libxslt用于提供XML支持。可以从[http://zlatkovic.com/pub/libxml](http://zlatkovic.com/pub/libxml)下载二进制文件，也可以从[http://xmlsoft.org](http://xmlsoft.org)下载源代码。需要注意，libxml2需要iconv，也在上面的地址下载。 openssl openssl用于提供SSL支持。可以从[http://www.slproweb.com/products/Win32OpenSSL.html](http://www.slproweb.com/products/Win32OpenSSL.html)下载二进制文件，或者在[http://www.openssl.org](http://www.openssl.org)下载源代码。 ossp-uuid ossp-uuid用于提供UUID-OSSP支持(仅用于contrib)。可以从[http://www.ossp.org/pkg/lib/uuid/](http://www.ossp.org/pkg/lib/uuid/)下载。 Python Python用于编译PL/Python。可以从[http://www.python.org](http://www.python.org)下载。 zlib zlib用于为pg_dump和pg_restore提供压缩支持。可以从[http://www.zlib.net](http://www.zlib.net)下载二进制文件。 ## 16.1.2\. 针对64位Windows的注意事项 PostgreSQL的X64架构只能在64位Windows系统上编译，不支持安腾处理器。同一个编译树上不支持32位和64位的混编。编译系统能自动检测平台环境是32位或64位，并编译出对应版本。因此，在编译前启动正确的命令行很重要。在服务器端使用python或openssl这样的第三方库，_必须_是64位的。64位服务器上不支持对32位库的加载。一些第三方库只支持32位的PostgrSQL，这种情形下，它们不能用在64位的PostgreSQL上。 ## 16.1.3\. 编译使用发行版配置(默认)来编译完整的PostgreSQL，运行命令： ``` <kbd class="literal">build</kbd> ``` 使用调试配置来编译完整的PostgreSQL，运行命令： ``` <kbd class="literal">build DEBUG</kbd> ``` 只编译单个项目，例如psql，运行命令： ``` <kbd class="literal">build psql</kbd> <kbd class="literal">build DEBUG psql</kbd> ``` 要将默认的编译配置改为调试配置，需要在`buildenv.pl`文件中加入下面的内容： ``` $ENV{CONFIG}="Debug"; ``` 也可以Visual Studio的图形化界面来编译，这时需要在命令行中运行： ``` <kbd class="literal">perl mkvcbuild.pl</kbd> ``` 然后在Visual Studio中打开`pgsql.sln`文件(从资源树的根目录)。 ## 16.1.4\. 清除和安装大多数时候，Visual Studio会自动追踪所依赖的文件的改动。但是当有大量改动的的时候，可能需要清除安装。要做到这一点，只需简单的运行`clean.bat`，它将自动的清除生成的相关文件。也可以在运行时添加`dist`参数，它的行为和<kbd class="literal">make distclean</kbd>命令比较相似，同时会清除flex/bison的输出文件。默认情况下，所有的文件都会写在`debug`或`release`目录的一个子目录下面。要使用标准设置安装这些文件，初始化这些生成的文件并使用数据库，运行命令： ``` <kbd class="literal">install c:\destination\directory</kbd> ``` ## 16.1.5\. 运行回归测试要运行回归测试，首先确保已经完成所需的编译。同时，确保用来加载系统所有部分(例如程序语言Perl和Python的DLLs)的DLLs已经在系统路径中存在。如果没有，通过`buildenv.pl`文件来设置。要运行测试，运行`src\tools\msvc`目录中的一个命令： ``` <kbd class="literal">vcregress check</kbd> <kbd class="literal">vcregress installcheck</kbd> <kbd class="literal">vcregress plcheck</kbd> <kbd class="literal">vcregress contribcheck</kbd> ``` 要改变调度方式(默认是并行),将它加在命令行后： ``` <kbd class="literal">vcregress check serial</kbd> ``` 关于回归测试的更多内容，见[Chapter 30](#calibre_link-116)。 ## 16.1.6\. 编译文档把PostgreSQL文档编译成HTML格式的需要一些工具和文件。为所有这些文件创建一个根目录，将它们存储在下列的子目录中。 OpenJade 1.3.1-2 从 [http://sourceforge.net/projects/openjade/files/openjade/1.3.1/openjade-1_3_1-2-bin.zip/download](http://sourceforge.net/projects/openjade/files/openjade/1.3.1/openjade-1_3_1-2-bin.zip/download)下载并解压到子目录`openjade-1.3.1`中。 DocBook DTD 4.2 从[http://www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip](http://www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip)下载并解压到子目录`docbook`中。 DocBook DSSSL 1.79 从[http://sourceforge.net/projects/docbook/files/docbook-dsssl/1.79/docbook-dsssl-1.79.zip/download](http://sourceforge.net/projects/docbook/files/docbook-dsssl/1.79/docbook-dsssl-1.79.zip/download)下载并解压到子目录`docbook-dsssl-1.79`中。 ISO character entities 从[http://www.oasis-open.org/cover/ISOEnts.zip](http://www.oasis-open.org/cover/ISOEnts.zip)下载并解压到子目录`docbook`中。编辑`buildenv.pl`文件，为根目录的地址增加一个变量，如： ``` $ENV{DOCROOT}='c:\docbook'; ``` 要编译文档，运行`builddoc.bat`文件。注意为了生成索引，实际上编译运行来两次。生成的HTML文件存在于`doc\src\sgml`中。