#C驱动安装（Linux）

本文以使用Centos 7.3.1、cmake3.16及以上版本和YashanDB客户端安装包yashandb-client-xx.xx-linux-x86_64.tar.gz为例，介绍YashanDB C驱动在该环境下的安装配置过程。

# 步骤1：下载C驱动安装包

从YashanDB官网下载中心 (opens new window)或联系我们的技术支持获取对应的软件包。
将YashanDB客户端安装包下载并解压到本地路径，例如/home/yasdb-driver-c/。

安装包解压后可得到C驱动所需文件：
- bin：C驱动的可执行文件（目前包括yasql）。
- C驱动的头文件：位于include文件夹中。
- C驱动的库文件：位于lib文件夹中。

# 步骤2：设置动态库依赖路径

编辑bashrc文件：
```
$ vi ~/.bashrc
```
新起一行增加LD_LIBRARY_PATH搜索路径，指向C驱动的库文件所在文件夹：
```
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/yasdb-driver-c/lib
```
保存并退出。
刷新系统变量配置。
```
$ source ~/.bashrc
```

至此，YashanDB C驱动安装完成。如需调整字符集相关配置，请参考字符集配置。

# 步骤3（可选）：新建C/C++语言工程

以下示例工程依赖cmake环境，需要提前安装cmake组件。

在任意路径新建工程文件夹yacli_c_project。
在yacli_c_project下新建文件CMakeLists.txt。

修改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)

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

yacli_c_project的目录结构如下：
- CMakeLists.txt
- cexample.c
在当前路径下生成cmake工程：
```
cmake .
```
在当前路径下编译：
```
make
```
运行yasctest：
```
./yasctest
```