XLSX I/O 项目安装和配置指南

1. 项目基础介绍和主要的编程语言

项目介绍

XLSX I/O 是一个跨平台的 C 语言库，旨在提供读取和写入 .xlsx 文件的功能。.xlsx 文件格式是自 Microsoft Excel 2007 版本以来使用的原生文件格式。XLSX I/O 的目标是提供一个简单、轻量级且易于使用的库，适用于需要在不同平台上处理 Excel 文件的项目。

主要编程语言

XLSX I/O 主要使用 C 语言编写，但也支持 C++ 使用。

2. 项目使用的关键技术和框架

关键技术

• C 语言: 项目核心代码使用 C 语言编写。
• Expat: 用于解析 XML 文件，仅在读取 .xlsx 文件时使用。
• Minizip 或 Libzip: 用于处理 ZIP 文件格式，支持读取和写入 .xlsx 文件。
• CMake: 用于项目的构建和配置，推荐使用 CMake 进行构建。

框架

• 跨平台支持: 支持 Windows、macOS 和 Linux 等操作系统。
• 轻量级: 设计为轻量级库，依赖项较少。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统上已经安装了以下工具和库：

• C 编译器（如 GCC 或 Clang）
• CMake（版本 2.6 或更高，推荐使用）
• Expat 库
• Minizip 或 Libzip 库

安装步骤

步骤 1：克隆项目仓库

首先，从 GitHub 克隆 XLSX I/O 项目到本地：

git clone https://github.com/brechtsanders/xlsxio.git
cd xlsxio

步骤 2：配置项目

使用 CMake 配置项目。您可以选择使用 CMake 或 Makefile 进行构建。这里我们推荐使用 CMake。

mkdir build
cd build
cmake ..

您可以根据需要添加以下选项：

• -DCMAKE_INSTALL_PREFIX:PATH=<path>：设置安装路径（默认为 /usr/local）
• -DBUILD_STATIC:BOOL=OFF：不构建静态库
• -DBUILD_SHARED:BOOL=OFF：不构建共享库
• -DBUILD_TOOLS:BOOL=OFF：不构建工具（仅构建库）
• -DBUILD_EXAMPLES:BOOL=OFF：不构建示例
• -DWITH_LIBZIP:BOOL=ON：使用 Libzip 而不是 Minizip
• -DLIBZIP_DIR:PATH=<path>：Libzip 库的路径
• -DMINIZIP_DIR:PATH=<path>：Minizip 库的路径
• -DWITH_WIDE:BOOL=ON：构建 UTF-16 库（libxlsxio_readw）

步骤 3：编译和安装

配置完成后，编译并安装项目：

make
sudo make install

如果您希望在安装时去除符号表，可以使用以下命令：

make install/strip

步骤 4：验证安装

安装完成后，您可以通过编译和运行示例程序来验证安装是否成功。示例程序位于 examples 目录下。

cd examples
gcc -o read_example read_example.c -lxlsxio_read -lexpat
./read_example

注意事项

• 如果您在 Windows 上使用 MinGW 或 MinGW-w64 进行编译，请确保已正确配置环境变量。
• 如果您使用的是 Libzip 而不是 Minizip，请确保 Libzip 库已正确安装并配置。

通过以上步骤，您应该能够成功安装和配置 XLSX I/O 项目，并开始使用它来读取和写入 .xlsx 文件。