编译与安装

在Linux和Mac下的编译和安装

./config
make
make test
sudo make install

在Window下的编译和安装

安装ActivePerl和Visual Studio,以管理员身份打开Visual Studio Tools下的Developer Command Prompt控制台并运行:

perl Configure VC-WIN32
nmake
nmake install

下面是一些常见的编译错误及原因:

  1. 安装最新的Visual Studio版本,不要使用Visual C++ 6、Visual Studio 2008。
  2. 确保从一份干净的(没有已经编译出来的对象文件或汇编文件)最新Master分支源代码开始编译。
  3. 编译系统没有找到nmake。实际上nmake是Visual Studio自带的工具,不需要单独安装。编译系统无法找到nmake的原因是没有在Visual Studio的命令行环境下执行编译指定。
  4. 无法执行nmake install。这个命令需要以管理员的身份执行。
  5. 对象文件(.obj)和目标平台不一致,通常是由于在Visual Studio的32位控制台下执行perl Configure VC-WIN64A;或者在Visual Studio的64位控制台下执行perl Configure VC-WIN32导致的。

编译Android目标文件

针对Android/ARM目标平台,需要先安装Android SDK/NDK。设置交叉编译环境后,可以直接用GmSSL内置的编译系统进行编译。下面的脚本给出了交叉编译的示例,需要根据安装的SDK位置及预计的平台编号修改ANDROID_PATHPLATFORM_VERSION的值。

#!/bin/bash

ANDROID_PATH=/path/to/android/sdf/
PLATFORM_VERSION=22

MAKE_TOOLCHAIN=$ANDROID_PATH/sdk/ndk-bundle/build/tools/make-standalone-toolchain.sh
export TOOLCHAIN_PATH=$ANDROID_PATH/android-toolchain-arm
$MAKE_TOOLCHAIN --arch=arm --platform=android-$PLATFORM_VERSION --install-dir=$TOOLCHAIN_PATH

export MACHINE=armv7
export SYSTEM=android
export ARCH=arm
export CROSS_SYSROOT=$TOOLCHAIN_PATH/sysroot
export TOOL_BASENAME=$TOOLCHAIN_PATH/bin/arm-linux-androideabi
export CC=$TOOL_BASENAME-gcc
export CXX=$TOOL_BASENAME-g++
export LD=$TOOL_BASENAME-ld
export LINK=$CXX
export AR=$TOOL_BASENAME-ar
export RANLIB=$TOOL_BASENAME-ranlib
export STRIP=$TOOL_BASENAME-strip

./config
make

编译完成后,可以生成面向Android目标平台的二进制库和gmssl可执行程序。

如需调用GmSSL的Java API,可以参考Android NDK的示例。

编译iPhone OS目标文件

export CC=clang
export CROSS_TOP=/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer
export CROSS_SDK=iPhoneOS.sdk
export PATH="/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin:$PATH"
./Configure ios64-cross no-shared --prefix=/usr/local/openssl-ios64
make