NSPR 构建说明

先决条件

在 Windows 上,NSPR 构建系统需要 GNU make 和一个 Unix 命令行实用程序套件,例如 MKS Toolkit、Cygwin 和 MSYS。获取这些工具最简单的方法是安装 MozillaBuild 包。

简介

NSPR 源码树的顶层是 mozilla/nsprpub 目录。虽然 nsprpubmozilla 下的子目录,但 NSPR 独立于 Mozilla 客户端源码树。

构建 NSPR 包括三个步骤

  1. 运行 configure 脚本。您可以覆盖编译器 (CC 环境变量) 或指定选项。

  2. 构建库

  3. 构建测试程序

例如:

# check out the source tree from Mercurial
hg clone https://hg.mozilla.org/projects/nspr
# create a build directory
mkdir target.debug
cd target.debug
# run the configure script
../nspr/configure [optional configure options]
# build the libraries
gmake
# build the test programs
cd pr/tests
gmake

在 Mac OS X 上,使用 make,它是 GNU make

配置选项

虽然 NSPR 使用 autoconf,但其 configure 脚本有两个默认值与大多数开源项目不同。

  1. 如果操作系统供应商提供了编译器(例如,Sun 和 HP),则 NSPR 默认使用该编译器而不是 GCC。

  2. NSPR 构建默认生成调试版本。

–disable-debug –enable-optimize

指定这两个选项以生成优化后的(发布)版本。

这两个选项实际上可以独立使用,但不推荐这样做。

–enable-64bit

在双 32 位/64 位平台上,NSPR 构建默认生成 32 位版本。要生成 64 位版本,请指定 --enable-64bit 配置选项。

–target=x86_64-pc-mingw32

对于 Windows 上的 64 位版本,当使用 mozbuild 环境时。

–enable-win32-target=WIN95

此选项仅在 Windows 上使用。出于历史原因,NSPR 构建在 Windows 上默认生成“WINNT”配置。我们建议大多数应用程序使用“WIN95”配置。“WIN95”配置支持所有版本的 Windows。“WIN95”名称是历史遗留的;它应该命名为“WIN32”。

要生成“WIN95”配置,请指定 --enable-win32-target=WIN95 配置选项。

–enable-debug-rtl

此选项仅在 Windows 上使用。NSPR 调试版本默认使用发布版 C 运行时库。要生成使用调试版 C 运行时库的调试版本,请指定 --enable-debug-rtl 配置选项。

Makefile 目标

  • all(默认)

  • clean

  • realclean

  • distclean

  • install

  • release

运行测试程序

测试程序已在上面的 pr/tests 目录中构建。

在 Mac OS X 上,可以使用以下命令执行它们:

/bin/sh:

$ cd pr/tests
$ DYLD_LIBRARY_PATH=../../dist/lib ./accept
PASS
$
$ # to run all the NSPR tests...
$
$ DYLD_LIBRARY_PATH=../../dist/lib ../../../nspr/pr/tests/runtests.sh ../..