国创灵梭嵌入式数据库(IntarkDB)社区版openGauss-embedded源码编译安装指南

1. 源码下载

可通过https或ssh地址访问gitcode社区openGauss-embedded项目代码仓：

• https地址：

https://gitcode.com/opengauss/openGauss-embedded.git

• ssh地址：

git@gitcode.com:opengauss/openGauss-embedded.git

2. 编译指南

2.1 软件依赖要求

2.2 Linux系统编译指南

1）编译方法：

在项目工程主目录openGauss-embedded下，直接运行如下命令进行编译，相关编译选项如下：

• make release: 编译生成release版本 --- 默认

• make debug: 编译生成debug版本

• make debug_lite: 编译生成轻量化debug版本

• make release_lite: 编译生成轻量化release版本

• make clean: 清空数据文件

2）编译结果文件

在完成编译后，动态库生成在output/*/lib目录中，可执行程序生成在output/*/bin目录中，以release编译选项为例，编译生成文件存放的目录及部分文件如下表所示：

2.3 Windows系统编译指南

步骤1）安装Visual Studio 2022

选择组件：使用C++的桌面开发

步骤2）项目代码下载与编译

启动VS2022软件，打开本地文件夹，选择下载好的openGauss-embedded目录。

打开CMake设置编辑器：

编辑CMakeSettings.json文件。

选择Release或者Debug版本：

修改CMake命令参数：

-DUT=OFF -DENABLE_GCOV=OFF -DENABLE_DCC_LITE=ON -DENABLE_MEMCHECK=OFF -DENABLE_EXPORT_API=ON -DSTATISTICS=OFF -DENABLE_BACKUP=OFF -DENABLE_LIBAIO=OFF -DSSL=OFF -DCRYPTO=OFF -DBUILD_TESTS=OFF -DOS_ARCH=””

等待CMake 生成完毕。

然后进行全部生成。

编译完成后，在openGauss-embedded下会生成一个output/文件夹。

把 output/release/lib
 的全路径添加系统环境变量 PATH 中：

步骤3）打开客户端与连接

进入到bin目录下双击intarkdb_cli.exe 命令行工具，即可新建并打开IntarkDB数据库。

2.4 鸿蒙系统ARM环境编译指南

当前数据库的交叉编译ARM仅针对鸿蒙系统。

步骤1）配置交叉编译环境：

根据您的目标平台和 OpenHarmony 系统的要求，配置交叉编译环境。这包括编译环境的准备，并安装交叉编译工具链等。

步骤2）编译数据库（ARM）

确保交叉编译环境已经配置好，将鸿蒙交叉工具链和头文件准备好，并通过命令参数TOOLCHAIN_PATH、OHOS_SYSROOT_PATH传入到编译脚本中。

例如：编译arm32命令：

make release OS_ARCH=arm32 TOOLCHAIN_PATH="/opt/native/llvm" OHOS_SYSROOT_PATH="/opt/native/sysroot"

其中OS_ARCH为编译目标平台，TOOLCHAIN_PATH为编译工具链地址，OHOS_SYSROOT_PATH为头文件路径 编译aarch64命令：

make release OS_ARCH=aarch64 TOOLCHAIN_PATH="/opt/native/llvm" OHOS_SYSROOT_PATH="/opt/native/sysroot"