操作系统

本文以Centos 7.3.1为例，介绍YashanDB C驱动在该环境下的安装配置过程。

1、下载C驱动安装包

1.依据运维手册安装部署YashanDB软件包清单获取对应的软件包，本文以yashandb-client-xx.xx-linux-x86_64.tar.gz为例。

2.将tar.gz文件下载并解压到本地路径，例如/home/yasdb-driver-c/。

3.安装包解压后包括三个文件夹：bin、include以及lib：

bin：C驱动的可执行文件（目前包括yasql）。

include：C驱动的头文件。

lib：C驱动的库文件。

2、设置动态库依赖路径

将/home/yasdb-driver-c/设置到Linux LD_LIBRARY_PATH中，具体操作为：

1.编辑bashrc文件：

vim ~/.bashrc

2.增加LD_LIBRARY_PATH搜索路径，新增一行：

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/yasdb-driver-c/lib

3.保存并退出。

4.刷新系统变量配置。

source ~/.bashrc

到此YashanDB C驱动就已安装完毕。

3、新建使用C驱动的客户工程（可选）(支持C/C++编程语言)

以下示例工程依赖cmake环境，需要提前安装cmake组件（本示例使用cmake3.16及以上版本）。

1.在任意路径新建工程文件夹yacli_c_project。

2.在yacli_c_project下新建文件CMakeLists.txt。

3.修改CMakeLists.txt文件为以下内容：

cmake_minimum_required(VERSION 3.16)
project(example)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(BUILD_USE_64BITS on)
set(CMAKE_CONFIGURATION_TYPES "Debug" CACHE STRING "" FORCE)
set(CMAKE_BUILD_TYPE "Debug" CACHE STRING "" FORCE)

# set src code
SET(LIBHELLO_SRC 
./cexample.c
)

add_executable(yasctest ${LIBHELLO_SRC})
target_link_libraries(yasctest /home/yasdb-driver-c/lib/libyascli.so)
target_include_directories(yasctest PUBLIC /home/yasdb-driver-c/include)

4.拷贝YashanDB C驱动使用示例中的cexample.c到当前工程路径下。

yacli_c_project的目录结构如下：

CMakeLists.txt

cexample.c

5.在当前路径下生成cmake工程：

cmake .

6.在当前路径下编译：

make

7.运行yasctest：

./yasctest