Installation

Installation

本指南说明如何在开发机器上设置 Aspose.Cells FOSS for C++,构建库,并通过最小的电子表格创建程序验证设定.


Prerequisites

RequirementDetail
C++编译器兼容C++17的编译器 (GCC 9+, Clang 10+或MSVC 2019+)
版本3.15或更高的版本
离开任何最新版本
操作系统Linux,macOS或Windows的版本

步骤1 复制存储库

克隆 Aspose.Cells FOSS 为 C++ 来源库:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-Cpp

第二步 建立样本

使用包装的CMake配置来构建样本项目,该项目还编译了库:

cd samples
mkdir build
cd build
cmake ..
cmake --build .

构建输出将编译的二进制文件放到 build/ 编辑目录.


步骤3将图书馆纳入项目中

通过添加库头和源树到自己的CMakeLists.txt FetchContent 或一个本地路径包括:

cmake_minimum_required(VERSION 3.15)
project(MyProject CXX)

set(CMAKE_CXX_STANDARD 17)

# Option A: local path
add_subdirectory(path/to/Aspose.Cells-FOSS-for-Cpp)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE Aspose.Cells.Foss.Cpp)

步骤4 验证安装

创建一个最小的 main.cpp 创建并保存一个XLSX文件:

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/WorksheetCollection.h"
#include "aspose/cells_foss/Worksheet.h"
#include "aspose/cells_foss/Cell.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Hello");
    sheet.GetCells()["A1"].PutValue("Hello, Aspose.Cells FOSS!");
    workbook.Save("hello.xlsx");
    return 0;
}

如果我们能建立并运行. hello.xlsx 在工作目录中创建,安装成功.


提示和最佳实践

  • 总是使用 Aspose::Cells_FOSS 避免与其他库发生符号冲突.
  • 对于大多数操作的入口点是: aspose/cells_foss/Workbook.h;包含其他标题,如: Worksheet.h 及其他 Cell.h 根据需要.
  • 使用CMake 3.15或更新的版本;较早的版本可能不支持捆绑目标配置.
  • 对于生产建造,通过 -DCMAKE_BUILD_TYPE=Release 于 年 月 日 cmake 实现优化.
  • 保持克隆目录作为图书馆的根;不要复制单个头.

常见问题

IssueCause修复
fatal error: aspose/cells_foss/Workbook.h: No such file or directory包含未配置路径Ensure target_include_directories 图书馆的指向 include/ 文件
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()图书馆没有连接添加 target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) 在 CMakeLists.txt 中
编辑版本错误值< 3. 15升级CMake到3.15+或调整CMake的 cmake_minimum_required 版本
在C++14模式下构建失败标准太老了.添加 set(CMAKE_CXX_STANDARD 17)add_executable 呼叫

下一步步骤

See Also

 中文