vs2008中xlslib与libxls库的编译及使用

2022-09-19 10:28:47

　　C++用来操作Excel的方法很多，但是涉及到跨平台，同时又要对Excel的读写操作兼顾，而且免费的库，那应该是要用xlslib和libxls了。由于技术比较菜，折腾这个折腾了一个星期了。最开始是使用QtXlsx库，而且这个库对于Qt来说操作不要太方便，但是研究了一下才发现，这个库是基于Qt5写的，而我们还在用Qt484开发，要想把里面的内容改一下适配Qt4，难度和工作量还是挺大的，因此作罢。后又转投QAxObject类对Excel的COM组件进行操作，这种方法倒是实现了，但是COM组件这个是Windows平台特有的，Linux上也是没什么指望了。因此开始研究了xlslib库和xlslib库，xlslib库只能写Excel文件，libxls库只能读Excel文件。关于这两个库的编译及说明网上一大堆，而且库文件本身存在的问题也有。对于xlslib库的使用官网上有比较详尽的Quick Reference Guide，使用起来还挺方便的，因此先写一下xlslib库的详细编译及使用步骤，然后再写一下libxls库的编译及使用步骤，希望对新入门的猿类有所助。

一、xlslib库的编译

　　1、首先从网站下载xlsLib库源码，版本为xlslib-package-2.5.0.zip(1.1MB)

　　　　地址：http://sourceforge.net/projects/xlslib/

　　2、将文件解压后得到两个文件夹：OpenEXR、xlslib。在xlslib\xlslib\build路径中有各版本的VS编译工程，以VS2008为例，打开工程后得到7个项目
　　　　vs2008中xlslib与libxls库的编译及使用　　　　vs2008中xlslib与libxls库的编译及使用

　　　其中，xlslib_dll项目编译动态库文件，编译后得到dll和lib文件；
    　　xlslib_lib项目编译静态库文件，编译后得到lib文件
    　　xlslib-testC为xlslib库的C语言应用Example
    　　xlslib-textCPP为xlslib库的C++应用Example

　　3、生成xlslib_dll，直接编译会出现很多问题，在错误列表中会提示"xlslib\***.h"的头文件找不到。原因是：头文件目录未包含进来。将头文件路径添加到工程。按如下方法添加：

　　　　vs2008中xlslib与libxls库的编译及使用

　　接下来编译，会出现两个sheet_notes的错误。sheet_notes 非法重定义，或构造函数不能返回类型。如下图：
　　　　vs2008中xlslib与libxls库的编译及使用

　　这个错误的原因是，结构体sheet_notes的类型名称和变量命令相同了。由于C/C++中，结构体可以有构造函数，所以，这两个名称是不能相同的。编译器会将成员变量当成是构造函数，从而报错。

　　　　vs2008中xlslib与libxls库的编译及使用

　　解决办法是，修改其中一个的名字，只要两个不相同就ok。经过搜索发现成员变量sheet_notes被用到只有3次，而结构体被用到很多次。于是，修改成员变量。

　　　　vs2008中xlslib与libxls库的编译及使用

　　再编译，还会提示一个 function_property 的错误
　　　　vs2008中xlslib与libxls库的编译及使用

　　修改代码如下：

　　　　vs2008中xlslib与libxls库的编译及使用

　　再编译，通过，ok。成功生成dll和lib两种库。通过更改以上错误之后，亲试生成静态库，动态库，64位库文件及32位库文件均成功。

　　4、测试工程中使用该库。将头文件及库文件分别放入工程中，静态库，动态库及头文件分别放入以下位置

　　　　vs2008中xlslib与libxls库的编译及使用

　　其中xlslib目录下分别包含以下文件，
　　xlslib\xlslib目录中放入解压出来的源码..\xlslib\xlslib\src\xlslib路径下的头文件
　　xlslib\common目录中放入解压出来的源码..\xlslib\xlslib\src\common路径下的头文件，同时将..\xlslib\xlslib\src中的xlslib.h头文件加入到common文件夹中
　　xlslib\oledoc目录中放入解压出来源码..\xlslib\xlslib\src\oledoc路径下的头文件

　　　　vs2008中xlslib与libxls库的编译及使用

　　5、在工程包含头文件中加入如下路径

　　　　vs2008中xlslib与libxls库的编译及使用

　　在工程引用的库文件中加入如下路径及引用

　　　　vs2008中xlslib与libxls库的编译及使用

　　　　vs2008中xlslib与libxls库的编译及使用

　　6、编译测试工程，出现“__FRAMEWORK__”相关的错误：error C2535: “xlslib_core::format_t::format_t错误原因：
　　QT的工程配置中配置属性C/C++语言将wchar_t视为内置类型“是/否”和xlslib_lib的冲突，所以编译的时候出现错误。如果在QT的设置里面wchar_t视为内置类型由否修改为是，则QString::toStdWstring()无法使用。除非重新编译QT源码。而报错的地方原因是编译器认为Ustring和u16string是一样的。所以认为重复定义

 format_t(CGlobalRecords&gRecords, const xlslib_strings::ustring& fmtstr);

 #ifndef __FRAMEWORK__

 format_t(CGlobalRecords&gRecords, const xlslib_strings::u16string& fmtstr);

 #endif

　　解决方法：将所有

 #ifndef __FRAMEWORK__

 format_t(CGlobalRecords&gRecords, const xlslib_strings::u16string& fmtstr);

 #endif

　　全部注释掉。同时将CPP中的定义也注释掉，最后编译通过。

　　xlslib库的使用参考链接：https://github.com/LeslieZhu/books/blob/master/share/xlslibRefGuide.pdf

二、libxls库的编译及使用

　　1、从网站上下载源码，最新版本libxls-1.4.0.zip

　　　　地址：http://sourceforge.net/projects/libxls/

　　2、解压后，在Linux下的安装方法，亲测可行，生成的.a文件和.la文件：
　　　./configure
    　　make
   　　 make install

　　在Window下则需要通过mingw编译器先编译成.a文件，然后将.a文件拆开成.o文件，再将.o文件生成.def文件，最后在VS中使用.o文件和.def文件即可生成dll文件和lib文件。

　　3、下载安装cygwin软件，在windows上安装，32位机器下载地址https://cygwin.com/setup-x86.exe，64位机器下载地址https://cygwin.com/setup-x86_64.exe。下载完成后，安装cygwin.exe，安装后选择安装以下组件：
    　　make
    　　mingw64-i686-binutils
    　　mingw64-i686-gcc-core
    　　mingw64-i686-gcc-g++
    　　mingw64-i686-win-iconv
　　4、等待cygwin安装完成后，将libxls源码放到cygwin目录中，cygwin目录为安装时选择的安装路径，选择将源码放入/home/用户名/opt/下，opt文件夹需要手动新建（任意文件夹都行）。

　　　　vs2008中xlslib与libxls库的编译及使用

　　5、在libxls的根目录（../home/fbi/opt/libxls）修改configure中的DEFS定义为:
    　　　　DEFS=-DHAVE_CONFIG_H -D_GNU_SOURCE
　　（用来解决make时候的警告warning: implicit declaration of function 'asprintf' [-Wimplicit-function-declaration]），cd到源文件目录下，然后在cygwin中执行如下命令对configure进行配置：
　　　　32位：CC='i686-w64-mingw32-gcc' ./configure --host=i686-w64-mingw32 --build=i686-w64-mingw32
　　　　64位：CC='x86_64-w64-mingw32-gcc' ./configure --host=x86_64-w64-mingw32 --build=x86_64-w64-mingw32

　　6、以上步骤执行后会生成Makefile文件，直接使用make、make intall命令进行编译安装。只要make过程没出错即可在../usr/local/xlslib目录下看到生成的bin、include、lib文件夹，在bin目录中为xls2csv.exe，但是没法成功运行，提示缺少iconv.dll，在usr\i686-w64-mingw32\sys-root\mingw\bin下即可找到，将该文件复制到bin目录下，xls2csv.exe即可正常运行。include文件夹中为调用该库时需要用到的头文件，lib目录下为libxlsreader.a和libxlsreader.la文件，此时需要通过.a文件转换出windows上运行需要用到的dll文件和lib文件以及链接过程中需要用到的def文件。

　　7、接下来利用生成的libxlsreader.a来生成需要的dll、lib及def文件。
    　　32位：在cygwin命令行下执行“i686-w64-mingw32-ar x libxlsreader.a”提取a中的.o文件
    　　64位：在cygwin命令行下执行“x86_64-w64-mingw32-ar x libxlsreader.a”提取a中的.o文件

　　然后利用.o文件来生成dll文件和def文件，具体命令如下：
   　　 32位：i686-w64-mingw32-gcc -shared -o libxls.dll *.o -Wl,--export-all-symbols,--output-def,libxls.def -liconv
    　　64位：x86_64-w64-mingw32-gcc -shared -o libxls.dll *.o -Wl,--export-all-symbols,--output-def,libxls.def -liconv

　　最后利用dll和def通过visual studio的lib来得到链接需要的lib文件，打开visual studio 命令提示，然后cd /d G:\cygwin64\usr\local\libxls\lib切换目录到dll所在目录并执行：
    　　32位：lib /machine:X86 /def:libxls.def
    　　64位：lib /machine:X64 /def:libxls.def

　　执行完以上步骤后，即可在cygwin64\usr\local\libxls\lib目录下看到生成的lib文件和dll文件，同时在cygwin64\usr\local\libxls\include目录下为调用库时需要包含的头文件。

　　以下为注意事项，在编译过程中出可能出现xlstypes.h文件报错，提示__attribute__相关的错误，主要是由于linux和windows系统对数据格式定义目的差异造成，可将xlstypes.h文件修改如下：

　　　　

#ifndef XLS_TYPES_INC

#define XLS_TYPES_INC

#include <stdint.h>

typedef unsigned char        BYTE;

typedef uint16_t            WORD;

typedef uint32_t            DWORD;

#ifdef NO_ALIGN

typedef uint16_t            WORD_UA;

typedef uint32_t            DWORD_UA;

#else

#ifdef _WIN32

typedef __declspec(align()) uint16_t WORD_UA;

typedef __declspec(align()) uint32_t DWORD_UA;

#else

typedef uint16_t            WORD_UA        __attribute__ ((aligned ()));    // 2 bytes

typedef uint32_t            DWORD_UA    __attribute__ ((aligned ()));    // 4 bytes

#endif    /* _WIN32 */

#endif    /* NO_ALIGN */

#endif    /* XLS_TYPES_INC*/

　　8、libxls进行配置到工程中，先将\usr\local\libxls\include文件夹中的头文件放入到新的工程中的include文件夹中，在工程的设置中添加如下附加包含目录：

　　　　vs2008中xlslib与libxls库的编译及使用

　　然后将lib文件放入工程目录下的lib文件夹中，并配置附加库目录如下：

　　　　vs2008中xlslib与libxls库的编译及使用

　　　　vs2008中xlslib与libxls库的编译及使用

　　9、在工程中添加头文件如下：
　　　　#include "libxls/xlsstruct.h"
　　　　#include "libxls/xls.h"

　　　　using namespace xls;
　　　务必将xlsstruct.h文件包含在xls.h头文件之前，否则可能报错。

　　到这里就结束了xlslib和libxls库的编译和配置了。libxls库的使用并没有相关文档，目前博客中的说明也不是太多，等用用之后总结一下，再重新写篇介绍的博客吧。搞完这个库也参考了不少博客，就不一一列出参考了，感谢他们的无私奉献。

　　最后想到一点，在libxls库的xls.h头文件中发现其中只有读Excel的一些函数声明

extern const char* xls_getVersion(void);

extern int xls(int debug);    // Set debug. Force library to load?

extern void xls_set_formula_hander(xls_formula_handler handler);

extern void xls_parseWorkBook(xlsWorkBook* pWB);

extern void xls_parseWorkSheet(xlsWorkSheet* pWS);

extern xlsWorkBook* xls_open(const char *file,const char *charset);    // convert 16bit strings within the spread sheet to this 8-bit encoding (UTF-8 default)

#define xls_close xls_close_WB                  // historical

extern void xls_close_WB(xlsWorkBook* pWB);     // preferred name

extern xlsWorkSheet * xls_getWorkSheet(xlsWorkBook* pWB,int num);

extern void xls_close_WS(xlsWorkSheet* pWS);

extern xlsSummaryInfo *xls_summaryInfo(xlsWorkBook* pWB);

extern void xls_close_summaryInfo(xlsSummaryInfo *pSI);

// utility function

xlsRow *xls_row(xlsWorkSheet* pWS, WORD cellRow);

xlsCell    *xls_cell(xlsWorkSheet* pWS, WORD cellRow, WORD cellCol);

　　但是在libxls.def文件及xls.c文件中却发现还有写Excel的函数

EXPORTS

    brdb @ DATA

    dumpbuf @

    get_string @

    ole2_bufread @

    ole2_close @

    ole2_fclose @

    ole2_fopen @

    ole2_open @

    ole2_read @

    ole2_seek @

    ole2_sopen @

    unicode_decode @

    utf8_decode @

    verbose @

    xls @

    xlsConvertBiff @

    xlsConvertBof @

    xlsConvertBoundsheet @

    xlsConvertCol @

    xlsConvertColinfo @

    xlsConvertDouble @

    xlsConvertFont @

    xlsConvertFormat @

    xlsConvertFormula @

    xlsConvertFormulaArray @

    xlsConvertHeader @

    xlsConvertMergedcells @

    xlsConvertPss @

    xlsConvertRow @

    xlsConvertSst @

    xlsConvertWindow @

    xlsConvertXf5 @

    xlsConvertXf8 @

    xlsIntVal @

    xlsShortVal @

    xls_addCell @

    xls_addColinfo @

    xls_addFont @

    xls_addFormat @

    xls_addRow @

    xls_addSST @

    xls_addSheet @

    xls_addXF5 @

    xls_addXF8 @

    xls_appendSST @

    xls_cell @

    xls_close_WB @

    xls_close_WS @

    xls_close_summaryInfo @

    xls_debug @ DATA

    xls_dumpSummary @

    xls_formatColumn @

    xls_getCSS @

    xls_getColor @

    xls_getVersion @

    xls_getWorkSheet @

    xls_getfcell @

    xls_is_bigendian @

    xls_makeTable @

    xls_mergedCells @

    xls_open @

    xls_parseWorkBook @

    xls_parseWorkSheet @

    xls_preparseWorkSheet @

    xls_row @

    xls_set_formula_hander @

    xls_showBOF @

    xls_showBookInfo @

    xls_showCell @

    xls_showColinfo @

    xls_showFont @

    xls_showFormat @

    xls_showROW @

    xls_showXF @

    xls_summaryInfo @

vs2008中xlslib与libxls库的编译及使用

　　猜想一下libxls库的作者应该也是想把操作Excel相关的接口写上的吧，可能出于某种原因导致并没有写完或者没有写好，有时间试试这几个函数用起来怎么样。

上一篇：cocoaPods安装成功终端代码（期间报error: RPC failed; result=56, HTTP code = 200）


下一篇：开源的excel读取库libxls在windows下的编译，且支持中文，全网首发