#C驱动安装(Windows)

本文以Windows10专业版、cmake3.16及以上版本和YashanDB客户端安装包yashandb-client-xx.xx-windows-amd64.zip为例,介绍YashanDB C驱动在该环境下的安装配置过程。

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

  1. 参考YashanDB软件包清单获取YashanDB客户端安装包。

  2. 将YashanDB客户端安装包下载并解压到本地路径,例如D:\yasdb-driver-c\

    安装包解压后可得到以下文件夹:

    • bin:C驱动的可执行文件。

    • include:C驱动的头文件。

    • lib:C驱动的库文件。

# 步骤2:设置环境变量

  1. 右键单击系统桌面上的【此电脑】图标,选择【属性】。

  2. 单击【高级系统设置】。

  3. 单击【环境变量】。

  4. 在【系统变量】区域,选中【Path】项,单击下方的【编辑】。

  5. 单击【新建】,输入D:\yasdb-driver-c\lib

  6. 单击【确定】保存配置。

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

# (可选)步骤3:新建C/C++语言工程

以下示例工程依赖cmake环境以及任意支持cmake工程的IDE。

  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 D:/yasdb-driver-c/lib/yascli.lib)
    target_include_directories(yasctest PUBLIC D:/yasdb-driver-c/include)
    
    Copied!
  4. 拷贝C驱动使用示例说明目录下相应场景(例如C驱动连接与断开)文档中的“使用示例”代码,保存为文件至当前工程路径,命名为cexample.c。

    yacli_c_project的目录结构如下:

    • CMakeLists.txt

    • cexample.c

  5. 使用任意IDE打开当前文件夹,编译运行yasctest。